yambar-modules-dwl(5)

💜 dwl — yambar-modules-dwl(5)

okay bestie, welcome to the dwl module page (yeah, that's the manual name too, yambar-modules-dwl(5), we love a consistent queen 👑). This one's all about feeding your bar info about your dwl tags. Let's get into it ✨

🌸 DESCRIPTION 🌸

So this module gives you a map of every tag that's chillin' in dwl 💅

Each tag comes with its id, its name, its status (selected, empty, urgent), plus all the global data like title, appid, fullscreen, floating, selmon, and layout. The tags start at 1. And for those moments where you only want the global data and not the tags (very valid!), there's a tag with the id 0 that contains only the global data. iykyk 🫶

This module tracks only the monitor where yambar was launched. Multi-monitor setup? Then please launch yambar on each of your monitors, bestie, that's just how it is 💀

⚠️ Heads up: only one instance of this module is supported. Running multiple instances at the same time may result in undefined behavior. Not cute, not iconic, just chaos 🙈

---

✨ TAGS ✨

Here's the whole lineup, no notes, they all ate 💖

• id (int) — dwl tag id.
• name (string) — the name of the tag (defaults to id if not set).
• selected (bool) — true if the tag is currently selected.
• empty (bool) — true if there are no windows in the tag.
• urgent (bool) — true if the tag has the urgent flag set.
• title (string) — the currently focused window's title.
• appid (string) — the currently focused window's application id.
• fullscreen (bool) — true if there is a fullscreen window in the current tag.
• floating (bool) — true if there is a floating window in the current tag.
• selmon (bool) — true if the monitor is actually focused.
• layout (string) — the actual layout name of the tag.

---

🎀 CONFIGURATION 🎀

Three settings, that's the whole vibe check 🌈

• number-of-tags (int, required: yes) — the number of defined tags in the dwl config.def.h.
• name-of-tags (list, required: false) — the name of the tags (must have the same length that number-of-tags).
• dwl-info-filename (string, required: yes) — the filepath to the log emitted by dwl when running.

---

🦋 EXAMPLES 🦋

okay here's a whole look for you, copy-paste away bestie 💅

bar:
  left:
    - dwl:
        number-of-tags: 9
        dwl-info-filename: "/home/ogromny/dwl_info"
        name-of-tags: [ , , , , , , , ,  ]
        content:
          list:
            items:
              - map:
                  conditions:
                    # default tag
                    id == 0: {string: {text: "{layout} {title}"}}

                    selected: {string: {text: "-> {name}"}}
                    ~empty: {string: {text: "{name}"}}
                    urgent: {string: {text: "=> {name} <="}}

The map is giving main character energy: id == 0 catches the default tag and shows you {layout} {title}, selected gets the -> {name} glow-up, ~empty (that's not empty, mwah 😘) shows plain {name}, and urgent gets the dramatic => {name} <= treatment 🔥

---

👑 SEE ALSO 👑

Go read these too, bestie: yambar-modules(5), yambar-particles(5), yambar-tags(5), yambar-decorations(5)

---

periodt, that's the page 💖 this was yambar-modules-dwl(5), dated 2024-04-22, straight from the File Formats Manual. slay responsibly, love u 🫶🎀