yambar-modu...ign-toplevel(5)

💅 NAME

okay bestie, welcome to yambar-modu...ign-toplevel(5) from the File Formats Manual 🫶 this is the page for foreign-toplevel — the module that gives you the tea ☕ on toplevel windows in Wayland. no cap. ✨

---

✨ DESCRIPTION

this module uses the wlr foreign toplevel management Wayland protocol to spill the details on currently open windows — stuff like their application ID, window title, and their current state (maximized/minimized/fullscreen/activated). 👑 iconic behavior, honestly.

the configuration for the foreign-toplevel module specifies a template particle. that particle gets instantiated once for each window. 🪟💖

Note: Wayland only. 🌈 like, do not try this on X11, bestie.

---

🏷️ TAGS

• app-id — string — the application ID (typically the application name) 🍓
• title — string — the window title 🎀
• maximized — bool — true if the window is currently maximized 🦋
• minimized — bool — true if the window is currently minimized 🙈
• fullscreen — bool — true if the window is currently fullscreened 💅
• activated — bool — true if the window is currently activated (i.e. has focus) 🔥

---

⚙️ CONFIGURATION

• content — particle — required: yes — template particle that will be instantiated once for each window ✨
• all-monitors — bool — required: no — when set to true, only windows on the same monitor the bar will be used. the default is false. 🫶

---

🌈 EXAMPLES

           bar:
             left:
               - foreign-toplevel:
                   content:
                     map:
                       conditions:
                         ~activated: {empty: {}}
                         activated:
                           - string: {text: "{app-id}: {title}"}

---

👀 SEE ALSO

yambar-modules(5), yambar-particles(5), yambar-tags(5), yambar-decorations(5) 💖

---

that's the whole vibe, bestie 🫶 this lil masterpiece is from yambar-modu...ign-toplevel(5), dated 2024-04-22. now go make your bar cute 💅✨