swaynag(1)

🌸 NAME 🌸

okay so, bestie, welcome to swaynag(1) — the manual page for literally showing a warning or error message with buttons. That's the whole vibe. slay. 💅

---

✨ SYNOPSIS ✨

swaynag [options...]

no cap, that's the whole invocation. 🦋

---

💅 OPTIONS 💅

• -b, --button <text> <action> — makes a button with the text text that runs action when you press it. If the environment variable TERMINAL is set, action will be run inside the terminal. Otherwise, it will fallback to running directly. Multiple buttons can be defined by providing the flag multiple times. 🎀
• -B, --button-no-terminal <text> <action> — same button energy with text text that runs action when pressed, but action will be run directly instead of in a terminal. Multiple buttons can be defined by providing the flag multiple times. ✨
• -z, --button-dismiss <text> <action> — makes a button with text text that runs action when pressed, and dismisses swaynag. If the environment variable TERMINAL is set, action will be run inside the terminal. Otherwise, it will fallback to running directly. Multiple buttons can be defined by providing the flag multiple times. 💖
• -Z, --button-dismiss-no-terminal <text> <action> — makes a button with text text that runs action when pressed, and dismisses swaynag. action will be run directly instead of in a terminal. Multiple buttons can be defined by providing the flag multiple times. 🫶
• -c, --config <path> — the config file to use. By default, the following paths are checked: $HOME/.swaynag/config, $XDG_CONFIG_HOME/swaynag/config, and SYSCONFDIR/swaynag/config. All flags aside from this one and debug are valid options in the configuration file using the format long-option=value. All leading dashes should be omitted and the equals sign is required. See swaynag(5) for more information. 📝
• -d, --debug — enables debugging. diagnostic queen behavior. 🐛
• -e, --edge top|bottom — sets the edge to use. 🌈
• -y, --layer overlay|top|bottom|background — sets the layer to use. 🧚
• -f, --font <font> — sets the font to use. ✨
• -h, --help — shows the help message and quits. 💖
• -l, --detailed-message — reads a detailed message from stdin. A button to toggle details will be added. Details are shown in a scrollable multi-line text area. 📜
• -L, --detailed-button <text> — sets the text for the button that toggles details. This has no effect if there is not a detailed message. The default is Toggle details. 🎀
• -m, --message <msg> — sets the message text. 💬
• -o, --output <output> — sets the output to use. This should be the name of a xdg_output. 🖥️
• -s, --dismiss-button <text> — sets the text for the dismiss nagbar button. The default is X. ❌
• -t, --type <type> — sets the message type. Two types are created by default: error and warning. Custom types can be defined in the config file. See --config and swaynag(5) for details. Both of the default types can be overridden in the config file as well. ⚠️
• -v, --version — shows the version number and quits. 👑

---

🎀 APPEARANCE OPTIONS 🎀

get your visual vibe check on, bestie: 💅

• --background <RRGGBB[AA]> — sets the color of the background. 🌸
• --border <RRGGBB[AA]> — sets the color of the border. 🎀
• --border-bottom <RRGGBB[AA]> — sets the color of the bottom border. 🌈
• --button-background <RRGGBB[AA]> — sets the color for the background for buttons. 💖
• --text <RRGGBB[AA]> — sets the text color. ✨
• --button-text <RRGGBB[AA]> — sets the button text color. 🦋
• --border-bottom-size <size> — sets the thickness of the bottom border. 📏
• --message-padding <padding> — sets the padding for the message. 🫶
• --details-background <RRGGBB[AA]> — sets the color for the background for details. 🌟
• --details-border-size <size> — sets the thickness for the details border. 🎀
• --button-border-size <size> — sets the thickness for the button border. 💅
• --button-gap <gap> — sets the size of the gap between buttons. 🌸
• --button-dismiss-gap <gap> — sets the size of the gap between the dismiss button and another button. 🦋
• --button-margin-right <margin> — sets the margin from the right of the dismiss button to edge. 📐
• --button-padding <padding> — sets the padding for the button text. 💖

---

🦋 SEE 🦋

swaynag(5)

go read the config bestie, iykyk. 🫶

---

and that's the tea 💖 — swaynag(1) from the General Commands Manual, dated 2026-04-26, signing off with maximum sparkle. periodt. 🎀✨