waybar-sway-scratchpad(5)

✨ waybar-sway-scratchpad ✨

okay bestie, so this is the manual page for waybar-sway-scratchpad — it lives in section 5 of the File Formats Manual and it's literally all about the sway scratchpad module for waybar. yes, the one that tells you what's chilling in your scratchpad. iconic. 💅

---

🌸 NAME 🌸

waybar — the sway scratchpad module. that's it. that's the whole name. short, sweet, slaying. 🎀

---

🦋 DESCRIPTION 🦋

the scratchpad module displays the scratchpad status in Sway. it's giving "hey bestie, here's what's hiding in your scratchpad right now". no cap. ✨

---

💖 CONFIGURATION 💖

this whole module gets addressed by sway/scratchpad. so that's your key in the config, got it? 🫶

---

• format — typeof: string, default: {icon} {count}. this is the format, aka how the info should be displayed. you decide the vibe of the readout. ✨
• show-empty — typeof: bool, default: false. the option to show the module even when the scratchpad is empty. so like, do you want it visible when there's nothing in there? your call. 🙈
• format-icons — typeof: array/object. based on the current scratchpad window counts, the corresponding icon gets selected. so more windows = different icon, basically a lil vibe check per count. 🌈
• tooltip — typeof: bool, default: true. the option to disable the tooltip on hover. turn it off if the hover popup isn't your main character energy. 💀
• tooltip-format — typeof: string, default: {app}: {title}. the format, aka how the info inside the tooltip should be displayed. 🍓
• menu — typeof: string. the action that popups the menu. yes, it really says "popups". we love her. 💜
• menu-file — typeof: string. location of the menu descriptor file. there needs to be an element of type GtkMenu with id menu in there, bestie — don't forget that part or it's not gonna work. 😭
• menu-actions — typeof: array. the actions corresponding to the buttons of the menu. one per button, matching up like a little buddy system. 🧚
• expand — typeof: bool, default: false. enables this module to consume all leftover space dynamically. she's HUNGRY. she wants the whole bar. 👑

---

⭐ FORMAT REPLACEMENTS ⭐

these are the little magic words you can drop into your formats, and they get swapped out for real info:

• {icon} — the icon, as defined in format-icons.
• {count} — number of windows in the scratchpad.
• {app} — name of the application in the scratchpad.
• {title} — title of the application in the scratchpad.

periodt. 🌟

---

🔥 EXAMPLES 🔥

here's a whole config block, copy it exactly if you want, it's literally free:

"sway/scratchpad": {
     "format": "{icon} {count}",
     "show-empty": false,
     "format-icons": ["", ""],
     "tooltip": true,
     "tooltip-format": "{app}: {title}"
}

ate. no crumbs. 💅

---

💅 STYLE 💅

the CSS selectors you can style, bestie:

• #scratchpad
• #scratchpad.empty

go off with the colors, queen. 🎀

---

fr fr that's the whole page, nothing skipped, nothing invented. every flag, every default, every replacement token — all here. iykyk. 🫶

later bestie!! this was written from the File Formats Manual, waybar-sway-scratchpad(5), dated 2026-02-08 — go forth and scratchpad responsibly. ✨💖🌸