waybar-disk(5)                File Formats Manual               waybar-disk(5)

<?><?><?> (NAME)
       waybar-disk - <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> waybar

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> disk <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?> <?><?><?> disk <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       path:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: "/"
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> (mountpoint) <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?>.

       interval:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?><?>: 30
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?> <?><?><?> <?><?><?><?><?>).

       format:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: "{percentage_used}%"
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       rotate:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> (<?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?>).

       states:
       <?><?><?>: <?><?><?> (object)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> (percentage_used) <?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?><?><?> waybar-states(5).

       max-length:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?>.

       min-length:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       align:
       <?><?><?>: <?><?><?><?> <?><?><?><?><?> (float)
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?> 0 <?><?><?><?><?><?> <?> 1
       <?><?><?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       justify:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> 'left' (<?><?>)<?> 'right'
       (<?><?><?><?>) <?><?> 'center' (<?><?><?>) <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       on-click:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       on-click-middle:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       (<?><?> <?><?><?> <?><?><?><?>) <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       on-click-right:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       on-update:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       on-scroll-up:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> (<?><?><?><?><?><?>) <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.

       on-scroll-down:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       smooth-scrolling-threshold:
       <?><?><?>: <?><?><?><?><?><?> (double)
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>.

       tooltip:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: true
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> (tooltip)
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?>.

       tooltip-format:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: "{used} out of {total} used
       ({percentage_used}%)"
       <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?>.

       unit:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?> <?><?> specific_free <?>specific_used <?>
       specific_total <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>. <?><?><?><?><?><?><?>
       kB <?>kiB <?>MB <?>Mib <?>GB <?>GiB <?>TB <?> TiB <?><?>
       <?><?><?><?><?><?><?><?>.

       menu:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>.

       menu-file:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           GtkMenu <?><?> <?><?><?><?><?> menu <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?>.

       menu-actions:
       <?><?><?>: <?><?><?><?><?> (array)
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?>.

       expand:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: false
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (FORMAT
       REPLACEMENTS)
       {percentage_used}: <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?>.

       {percentage_free}: <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>.

       {total}: <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>. <?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       {used}: <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?>. <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?>.

       {free}: <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       {path}: <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?>.

       {specific_total}: <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?>.

       {specific_used}: <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?>.

       {specific_free}: <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
           "disk": {
                "interval": 30,
                "format": "{percentage_free}% free on {path}",
           }

           "disk": {
                "interval": 30,
                "format": "{specific_free:0.2f} GB out of {specific_total:0.2f} GB available. Alternatively {free} out of {total} available",
                "unit": "GB"
                // 1434.25 GB out of 2000.00 GB available. Alternatively 1.4TiB out of 1.9TiB available.
           }

<?><?><?><?><?><?> (STYLE)
       o   #disk

                                  2026-08-31                    waybar-disk(5)