1swaynag(1) General Commands Manual swaynag(1)
2
6 swaynag - Show a warning or error message with buttons
7
9 swaynag [options...]
10
12 -b, --button <text> <action>
13 Create a button with the text text that executes action when
14 pressed. If the environment variable TERMINAL is set, action will
15 be run inside the terminal. Otherwise, it will fallback to running
16 directly. Multiple buttons can be defined by providing the flag
17 multiple times.
18 -B, --button-no-terminal <text> <action>
20 Create a button with the text text that executes action when
21 pressed. action will be run directly instead of in a terminal. Mul‐
22 tiple buttons can be defined by providing the flag multiple times.
23 -z, --button-dismiss <text> <action>
25 Create a button with the text text that executes action when
26 pressed, and dismisses swaynag. If the environment variable TERMI‐
27 NAL is set, action will be run inside the terminal. Otherwise, it
28 will fallback to running directly. Multiple buttons can be defined
29 by providing the flag multiple times.
30 -Z, --button-dismiss-no-terminal <text> <action>
32 Create a button with the text text that executes action when
33 pressed, and dismisses swaynag. action will be run directly instead
34 of in a terminal. Multiple buttons can be defined by providing the
35 flag multiple times.
36 -c, --config <path>
38 The config file to use. By default, the following paths are
39 checked: $HOME/.swaynag/config, $XDG_CONFIG_HOME/swaynag/config,
40 and SYSCONFDIR/swaynag/config. All flags aside from this one and
41 debug are valid options in the configuration file using the format
42 long-option=value. All leading dashes should be omitted and the
43 equals sign is required. See swaynag(5) for more information.
44 -d, --debug
46 Enable debugging.
47 -e, --edge top|bottom
49 Set the edge to use.
50 -f, --font <font>
52 Set the font to use.
53 -h, --help
55 Show help message and quit.
56 -l, --detailed-message
58 Read a detailed message from stdin. A button to toggle details will
59 be added. Details are shown in a scrollable multi-line text area.
60 -L, --detailed-button <text>
62 Set the text for the button that toggles details. This has no ef‐
63 fect if there is not a detailed message. The default is Toggle de‐
64 tails.
65 -m, --message <msg>
67 Set the message text.
68 -o, --output <output>
70 Set the output to use. This should be the name of a xdg_output.
71 -s, --dismiss-button <text>
73 Sets the text for the dismiss nagbar button. The default is X.
74 -t, --type <type>
76 Set the message type. Two types are created by default error and
77 warning. Custom types can be defined in the config file. See --con‐
78 fig and swaynag(5) for details. Both of the default types can be
79 overridden in the config file as well.
80 -v, --version
82 Show the version number and quit.
83
85 --background <RRGGBB[AA]>
86 Set the color of the background.
87 --border <RRGGBB[AA]>
89 Set the color of the border.
90 --border-bottom <RRGGBB[AA]>
92 Set the color of the bottom border.
93 --button-background <RRGGBB[AA]>
95 Set the color for the background for buttons.
96 --text <RRGGBB[AA]>
98 Set the text color.
99 --button-text <RRGGBB[AA]>
101 Set the button text color.
102 --border-bottom-size <size>
104 Set the thickness of the bottom border.
105 --message-padding <padding>
107 Set the padding for the message.
108 --details-background <RRGGBB[AA]>
110 Set the color for the background for details.
111 --details-border-size <size>
113 Set the thickness for the details border.
114 --button-border-size <size>
116 Set the thickness for the button border.
117 --button-gap <gap>
119 Set the size of the gap between buttons.
120 --button-dismiss-gap <gap>
122 Set the size of the gap between the dismiss button and another but‐
123 ton.
124 --button-margin-right <margin>
126 Set the margin from the right of the dismiss button to edge.
127 --button-padding <padding>
129 Set the padding for the button text.
130
132 swaynag(5)
133 2021-07-23 swaynag(1)