-
Notifications
You must be signed in to change notification settings - Fork 5
Modules: Disk usage
github-actions[bot] edited this page Nov 12, 2025
·
2 revisions
Name: disk_usage
Shows the disk usage, also has a popup which can show more stats.
This module obtains the stats via the statvfs syscall, see man7.org
You can override the default settings defined in Module Styling by setting them in this section: module:disk_usage.
| Option | Description | Data type | Default |
|---|---|---|---|
| icon | the icon to use | String | |
| path | Some directory, which determines the filesystem of interest | String | / |
| format | The content of the module text | String | {{used_perc}}% |
You can override the default settings defined in Popup Styling by setting them in this section: module_popup:disk_usage.
| Option | Description | Data type | Default |
|---|---|---|---|
| format | The format of the popup text | String | Total: {{total_gb}} GB\nUsed: {{used_gb}} GB ({{used_perc}}%)\nFree: {{free_gb}} GB ({{free_perc}}%) |
format provides the following variables:
-
total: The total filesystem space in mb -
total_gb: The total filesystem space in gb -
used: The used space in mb -
used_gb: The used space in gb -
free: The free space in mb -
free_gb: The free space in gb -
used_perc: the percentage of used space in the filesystem -
free_perc: the percentage of free space in the filesystem