waybar-image(5)

💖 waybar-image — the manual page, bestie edition 💖

okay so this is the waybar-image(5) page, from the File Formats Manual, and it's literally about making waybar show a lil picture. iconic. 🖼️✨

---

🌸 NAME 🌸

waybar image module — bestie, it displays an image. from a path. that's it, that's the job. 🎀

---

🦋 DESCRIPTION 🦋

The image module displays an image from a path. no cap, that's the whole concept. it's giving "picture in your bar." 💅

---

💜 CONFIGURATION 💜

every single knob, in order, no skipping (i would never):

• path — typeof: string. The path to the image. that's the file it's gonna show, obviously. 🍓
• exec — typeof: string. The path to the script, which should return image path file. It will only execute if the path is not set. so like, either/or queen. 🙈
• size — typeof: integer. The width/height to render the image. square energy, fr fr. 📐
• interval — typeof: integer or float. The interval (in seconds) to re-render the image. Minimum value is 0.001 (1ms). Values smaller than 1ms will be set to 1ms. This is useful if the contents of path changes. If no interval is defined, the image will only be rendered once. one and done, no notes. ✨
• 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. very specific, very demure. 🔥
• 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. so it whispers at you when you hover. 💬
• expand — typeof: bool, default: false. Enables this module to consume all left over space dynamically. main character taking up the whole room, honestly. 👑

---

✨ SCRIPT OUTPUT ✨

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

$path\n$tooltip

so: image path first, tooltip after, newline between them. keep it exact bestie, don't freestyle. 🫶

---

🌈 EXAMPLES 🌈

here's the vibe, copy-paste ready:

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

album art that also toggles your music when you tap it?? we love a multitasking king. 🎵💖

---

🎀 STYLE 🎀

• #image
• #image.empty

those are the two selectors, go wild styling them. 💅

---

heads up bestie: exec only runs when path isn't set, and interval values under 1ms get bumped up to 1ms whether you like it or not. 🫠

---

and that's the whole page, fr fr. this was waybar-image(5) from the File Formats Manual, and the bottom of the original says 2026-02-08 — so like, dated 2026-02-08, which is very ✨futuristic✨ of it. periodt. 💖🌸🦋