NAME¶

waybar - image module

DESCRIPTION¶

The image module displays an image from a path.

CONFIGURATION¶

path:
typeof: string
The path to the image.

exec:
typeof: string
The path to the script, which should return image path file.
It will only execute if the path is not set

size:
typeof: integer
The width/height to render the image.

interval:
typeof: integer
The interval (in seconds) to re-render the image.
This is useful if the contents of path changes.
If no interval is defined, the image will only be rendered once.

signal:
typeof: integer
The signal number used to update the module.
This can be used instead of interval if the file changes irregularly.
The number is valid between 1 and N, where SIGRTMIN+N = SIGRTMAX.

on-click:
typeof: string
Command to execute when clicked on the module.

on-click-middle:
typeof: string
Command to execute when middle-clicked on the module using mousewheel.

on-update:
typeof: string
Command to execute when the module is updated.

on-scroll-up:
typeof: string
Command to execute when scrolling up on the module.

on-scroll-down:
typeof: string
Command to execute when scrolling down on the module.

smooth-scrolling-threshold:
typeof: double
Threshold to be used when scrolling.

tooltip:
typeof: bool
default: true
Option to enable tooltip on hover.

SCRIPT OUTPUT¶

Similar to the custom module, output values of the script are newline separated. The following is the output format:

$path\n$tooltip

EXAMPLES¶

"image#album-art": {
	"path": "/tmp/mpd_art",
	"size": 32,
	"interval": 5,
	"on-click": "mpc toggle"
}

STYLE¶

• #image
• #image.empty