waybar-privacy(5)

✨ waybar-privacy — the manual, but make it bestie ✨

okay so. this is a page from the File Formats Manual, section 5, and its whole name is waybar-privacy(5). buckle up, it's short but it's cute. 🎀

💖 NAME 💖

waybar — the privacy module. that's it, that's the name. iconic behavior honestly.

---

🌸 DESCRIPTION 🌸

the privacy module shows you if any application is capturing audio, sharing the screen or playing audio. that's the whole vibe check: who's out here listening, who's out here mirroring your screen, and who's out here blasting sound. 👀

---

🦋 CONFIGURATION 🦋

these are the top-level settings, the main character options if you will:

• icon-spacing — typeof: integer, default: 4. the spacing between each privacy icon. give those little guys some personal space. 💅
• icon-size — typeof: integer, default: 20. the size of each privacy icon.
• transition-duration — typeof: integer, default: 250. the manual says, and I quote directly: "Option to disable tooltip on hover." yes bestie, that is literally what it says under transition-duration. no notes, we don't write the docs, we just pass them along fr fr. 🙈
• modules — typeof: array of objects, default: [{"type": "screenshare"}, {"type": "audio-in"}]. which privacy modules to monitor. peep MODULES CONFIGURATION below for the tea. 👑
• expand — typeof: bool, default: false. lets this module consume all the left over space dynamically. greedy queen. she eats. 🍓
• ignore-monitor — typeof: bool, default: true. ignore streams with the stream.monitor property.
• ignore — typeof: array of objects, default: []. extra streams you want ignored. see IGNORE CONFIGURATION for more. ✨

---

🌈 MODULES CONFIGURATION 🌈

this is where you tell the module which flavors to watch:

• type — typeof: string, values: "screenshare", "audio-in", "audio-out". says which module to use and configure.
• tooltip — typeof: bool, default: true. "Option to disable tooltip on hover." (their words, not mine, same energy as before 💀)
• tooltip-icon-size — typeof: integer, default: 24. the size of each icon in the tooltip. yes, the tooltip has its own icons and its own size setting. she's got layers. 🧚

---

💜 IGNORE CONFIGURATION 💜

the "please don't look at this one" list:

• type — typeof: string
• name — typeof: string

---

⭐ EXAMPLES ⭐

here's a whole config block, copy-paste ready, verbatim, no cap:

"privacy": {
     "icon-spacing": 4,
     "icon-size": 18,
     "transition-duration": 250,
     "modules": [
          {
               "type": "screenshare",
               "tooltip": true,
               "tooltip-icon-size": 24
          },
          {
               "type": "audio-out",
               "tooltip": true,
               "tooltip-icon-size": 24
          },
          {
               "type": "audio-in",
               "tooltip": true,
               "tooltip-icon-size": 24
          }
     ],
     "ignore-monitor": true,
     "ignore": [
          {
               "type": "audio-in",
               "name": "cava"
          },
          {
               "type": "screenshare",
               "name": "obs"
          }
     ]
},

look at her. three modules monitored, cava and obs politely told to mind their business. slay. 🔥

---

🎀 STYLE 🎀

the CSS selectors you can dress up, periodt:

• #privacy
• #privacy-item
• #privacy-item.screenshare
• #privacy-item.audio-in
• #privacy-item.audio-out

---

lowkey reminder bestie: everything here is exactly what the page says, nothing invented, nothing skipped. i just gave it the glow-up it deserved. 💅✨

and that's a wrap on waybar-privacy(5) from the File Formats Manual — stamped with the date 2026-02-08 and the version tag waybar-privacy(5). mwah, go configure your icons, you gorgeous nerd. 🫶🌈