waybar-dwl-tags(5)

📦
version 0.15.0 · 11 versions
, in ubuntu resolute, ubuntu stonking

✨ waybar-dwl-tags — the dwl tags module, bestie edition ✨

okay so this is a page from the File Formats Manual, and it's all about the waybar module called dwl-tags. if you're running dwl as your compositor and you want waybar to show you what's going on with your tags, this is literally the page for you 🫶

🌸 NAME 🌸

waybar - dwl tags module

no cap, that's the whole name.

💖 DESCRIPTION 💖

The tags module displays the current state of tags in dwl. that's it, that's the vibe — it's your little window into which tags exist, which ones are focused, which ones have stuff on them, all of it 💅

🎀 CONFIGURATION 🎀

bestie, you address this module as dwl/tags. here's everything you can set:

  • num-tags
    • typeof: uint
    • default: 9
    • The number of tags that should be displayed. Max 32.
  • tag-labels
    • typeof: array
    • The label to display for each tag.
  • disable-click
    • typeof: bool
    • default: false
    • If set to false, you can left-click to set focused tag. Right-click to toggle tag focus. If set to true this behaviour is disabled.
  • expand
    • typeof: bool
    • default: false
    • Enables this module to consume all left over space dynamically.

ngl the click thing is lowkey the best part, like yes queen interact with your bar 🦋

🌈 EXAMPLE 🌈

here's a lil config moment so you can see it IRL:

"dwl/tags": {
     "num-tags": 5
}

look at her. five tags. iconic. small but mighty ✨

💜 STYLE 💜

these are the CSS selectors you can flex on:

  • #tags button
  • #tags button.occupied
  • #tags button.empty
  • #tags button.focused
  • #tags button.urgent
⚠️ heads up bestie: note that occupied/focused/urgent status may overlap. That is, a tag may be both occupied and focused at the same time. so don't be out here writing CSS like those states are mutually exclusive, because they are NOT 💀

🫶 SEE ALSO 🫶

like, go read these too, they're the friends of this page:

and that's the whole page, periodt 💅 this was waybar-dwl-tags(5) from 2026-02-08 — mwah, go slay your tag bar 👑💖

📦 where this page comes from