-b,--button <text> <action>
Create a button with the text text that executes action when pressed. 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>
Create a button with the text text that executes action when pressed. 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>
Create a button with the text text that executes 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>
Create a button with the text text that executes 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
Enable debugging.
-e,--edge top|bottom
Set the edge to use.
-y,--layer overlay|top|bottom|background
Set the layer to use.
-f,--font <font>
Set the font to use.
-h,--help
Show help message and quit.
-l,--detailed-message
Read 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>
Set the text for the button that toggles details. This has no effect if there is not a detailed
message. The default is Toggledetails.
-m,--message <msg>
Set the message text.
-o,--output <output>
Set 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>
Set 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
Show the version number and quit.