swaync-client(1)

💖 swaync-client(1) — the bestie edition

okay so real talk, this is the manual page for swaync-client, living in the General Commands Manual section of your man pages, bestie. it's the client executable. that's it. that's the whole vibe. it talks to your notification daemon so you don't have to click stuff like a peasant. ✨

---

🌸 NAME

swaync-client — the client executable 🫶

like, it's the little friend that pokes SwayNC and makes things happen. opening panels, toggling Do Not Disturb, yeeting notifications into the void. iconic behavior honestly.

---

🎀 USAGE

swaync-client [option]

one option. that's the whole synopsis. she's simple, she's effective, she ate. 💅

---

✨ OPTIONS ✨

okay here's the full menu, no skips, no cuts, all forty-ish of them, because we do NOT gatekeep here:

• -h, --help — shows the help options. your girl is confused? just ask her directly. 🥺
• -v, --version — prints the version. so you know exactly which era of swaync you're in.
• -R, --reload-config — reloads the config file. changed your mind? valid. she'll re-read it. 💖
• -rs, --reload-css — reloads the css file. BUT — and this is the important part — if you changed the location of the css file, you need a full restart. reload alone won't find it. no cap. 🚨
• -t, --toggle-panel — toggles the notification panel. open if closed, closed if open. main character flip-flop energy. 👑
• -op, --open-panel — opens the notification panel. come on in, the vibes are immaculate. 🌈
• -cp, --close-panel — closes the notification panel. bye bestie, panel's over. 💀
• -d, --toggle-dnd — toggles dnd and prints the current dnd state. two for one, we love efficiency. 🔥
• -D, --get-dnd — prints the current dnd state. just a lil peek, no changes. 🙈
• -dn, --dnd-on — turns dnd on and prints the new dnd state. silence era activated. 🤫
• -df, --dnd-off — turns dnd off and prints the new dnd state. notifications are BACK and they're loud. 📢
• -I, --get-inhibited — prints if you're currently inhibited or not. yes/no, that's the tea. 🍓
• -In, --get-num-inhibitors — prints the number of inhibitors. a whole headcount. 💀
• -Ia, --inhibitor-add [APP_ID] — adds an inhibitor. takes an APP_ID argument, so she knows who's doing the inhibiting. 🧚
• -Ir, --inhibitor-remove [APP_ID] — removes an inhibitor. also takes an APP_ID. we're un-inhibiting, respectfully. ✨
• -Ic, --inhibitors-clear — clears ALL inhibitors. mass eviction. everyone out. 🧹
• -c, --count — prints the current notification count. a little census of your chaos. 🔢
• --hide-latest — hides the latest notification. note that it's still shown in Control Center though, so it's not gone gone. sneaky. 🙈
• --hide-all — hides all notifications. again, still shown in Control Center. she's hiding, not deleting. 💅
• --close-latest — closes the latest notification. gone for real this time. 💀
• -C, --close-all — closes all notifications. nuke it. 🔥
• -a, --action [ACTION_INDEX] — invokes the action ACTION_INDEX (or 0) of the latest notification. so you can press the button without pressing the button. iconique. 🎀
• -sw, --skip-wait — doesn't wait when swaync hasn't been started. no waiting around for someone who isn't coming. 💅
• -s, --subscribe — subscribes to notification add and close events. she's listening. she's always listening. 👀
• -swb, --subscribe-waybar — subscribes to notification add and close events with waybar support. read the README for an example, bestie, there's a whole recipe in there. 🫶
• --change-cc-monitor — changes the preferred control center monitor. heads up: this resets on config reload, so don't get too attached. 😭
• --change-noti-monitor — changes the preferred notification monitor. also resets on config reload. same energy, different monitor. 😭

---

psst — those two monitor options are lowkey commitment-phobic. config reload = memory wipe. just so you're not surprised later. 💜

---

🌟 cute sign-off

this lil love letter is from swaync-client(1) and it's dated 2026-05-19 — mark your calendars, that's when this version of the page got its glow-up. slay, read your README, and go toggle something. periodt. 👑💖✨