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

<?><?><?> (NAME)
       waybar - <?><?><?><?><?> <?><?><?><?><?> (image module)

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> image <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       path:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       exec:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>.
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       path <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       size:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?>/<?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       interval:
       <?><?><?>: <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> (integer or
       float)
       <?><?><?><?> <?><?><?><?><?> (<?><?> <?><?><?><?><?>) <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.
       <?><?><?><?><?> <?><?><?><?><?> 0.001 (<?>
       <?><?><?><?><?><?><?><?><?><?>) <?><?><?>. <?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?> <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?>.
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> path <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?>.
       <?><?><?> <?><?><?> interval <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?>.

       signal:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       interval <?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?> <?><?><?> <?> <?> N <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> SIGRTMIN+N = SIGRTMAX <?><?><?><?>.

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

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

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

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

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

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

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

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

<?><?><?><?><?> <?><?><?><?><?><?><?> (SCRIPT OUTPUT)
       <?><?><?><?><?> <?><?><?><?><?> custom<?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       (newline) <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?>:

           $path0tooltip

<?><?><?><?><?><?><?> (EXAMPLES)
           "image#album-art": {
                "path": "/tmp/mpd_art",
                "size": 32,
                "interval": 5,
                "on-click": "mpc toggle"
           }

<?><?><?><?><?><?> (STYLE)
       o   #image
       o   #image.empty

                                  2026-08-31                   waybar-image(5)