1swaynag(1)                  General Commands Manual                 swaynag(1)
2
3
4

NAME

6       swaynag - Show a warning or error message with buttons
7

SYNOPSIS

9       swaynag [options...]
10

OPTIONS

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
19       -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.
22           Multiple buttons can be defined by providing the flag multiple
23           times.
24
25       -z, --button-dismiss <text> <action>
26           Create a button with the text text that executes action when
27           pressed, and dismisses swaynag. If the environment variable TERMI‐
28           NAL is set, action will be run inside the terminal. Otherwise, it
29           will fallback to running directly. Multiple buttons can be defined
30           by providing the flag multiple times.
31
32       -Z, --button-dismiss-no-terminal <text> <action>
33           Create a button with the text text that executes action when
34           pressed, and dismisses swaynag. action will be run directly instead
35           of in a terminal. Multiple buttons can be defined by providing the
36           flag multiple times.
37
38       -c, --config <path>
39           The config file to use. By default, the following paths are
40           checked: $HOME/.swaynag/config, $XDG_CONFIG_HOME/swaynag/config,
41           and SYSCONFDIR/swaynag/config. All flags aside from this one and
42           debug are valid options in the configuration file using the format
43           long-option=value. All leading dashes should be omitted and the
44           equals sign is required. See swaynag(5) for more information.
45
46       -d, --debug
47           Enable debugging.
48
49       -e, --edge top|bottom
50           Set the edge to use.
51
52       -f, --font <font>
53           Set the font to use.
54
55       -h, --help
56           Show help message and quit.
57
58       -l, --detailed-message
59           Read a detailed message from stdin. A button to toggle details will
60           be added. Details are shown in a scrollable multi-line text area.
61
62       -L, --detailed-button <text>
63           Set the text for the button that toggles details. This has no
64           effect if there is not a detailed message. The default is Toggle
65           details.
66
67       -m, --message <msg>
68           Set the message text.
69
70       -o, --output <output>
71           Set the output to use. This should be the name of a xdg_output.
72
73       -s, --dismiss-button <text>
74           Sets the text for the dismiss nagbar button. The default is X.
75
76       -t, --type <type>
77           Set the message type. Two types are created by default error and
78           warning. Custom types can be defined in the config file. See --con‐
79           fig and swaynag(5) for details. Both of the default types can be
80           overridden in the config file as well.
81
82       -v, --version
83           Show the version number and quit.
84

APPEARANCE OPTIONS

86       --background <RRGGBB[AA]>
87           Set the color of the background.
88
89       --border <RRGGBB[AA]>
90           Set the color of the border.
91
92       --border-bottom <RRGGBB[AA]>
93           Set the color of the bottom border.
94
95       --button-background <RRGGBB[AA]>
96           Set the color for the background for buttons.
97
98       --text <RRGGBB[AA]>
99           Set the text color.
100
101       --border-bottom-size <size>
102           Set the thickness of the bottom border.
103
104       --message-padding <padding>
105           Set the padding for the message.
106
107       --details-border-size <size>
108           Set the thickness for the details border.
109
110       --button-border-size <size>
111           Set the thickness for the button border.
112
113       --button-gap <gap>
114           Set the size of the gap between buttons.
115
116       --button-dismiss-gap <gap>
117           Set the size of the gap between the dismiss button and another but‐
118           ton.
119
120       --button-margin-right <margin>
121           Set the margin from the right of the dismiss button to edge.
122
123       --button-padding <padding>
124           Set the padding for the button text.
125

SEE

127       swaynag(5)
128
129
130
131                                  2020-10-22                        swaynag(1)
Impressum