1swaynag(1) General Commands Manual swaynag(1)
2
3
4
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
15 will be run inside the terminal. Otherwise, it will fallback to
16 running directly. Multiple buttons can be defined by providing the
17 flag 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 -c, --config <path>
26 The config file to use. By default, the following paths are
27 checked: $HOME/.swaynag/config, $XDG_CONFIG_HOME/swaynag/config,
28 and SYSCONFDIR/swaynag/config. All flags aside from this one and
29 debug are valid options in the configuration file using the format
30 long-option=value. All leading dashes should be omitted and the
31 equals sign is required. See swaynag(5) for more information.
32
33 -d, --debug
34 Enable debugging.
35
36 -e, --edge top|bottom
37 Set the edge to use.
38
39 -f, --font <font>
40 Set the font to use.
41
42 -h, --help
43 Show help message and quit.
44
45 -l, --detailed-message
46 Read a detailed message from stdin. A button to toggle details will
47 be added. Details are shown in a scrollable multi-line text area.
48
49 -L, --detailed-button <text>
50 Set the text for the button that toggles details. This has no
51 effect if there is not a detailed message. The default is Toggle
52 details.
53
54 -m, --message <msg>
55 Set the message text.
56
57 -o, --output <output>
58 Set the output to use. This should be the name of a xdg_output.
59
60 -s, --dismiss-button <text>
61 Sets the text for the dismiss nagbar button. The default is X.
62
63 -t, --type <type>
64 Set the message type. Two types are created by default error and
65 warning. Custom types can be defined in the config file. See --con‐
66 fig and swaynag(5) for details. Both of the default types can be
67 overridden in the config file as well.
68
69 -v, --version
70 Show the version number and quit.
71
73 --background <RRGGBB[AA]>
74 Set the color of the background.
75
76 --border <RRGGBB[AA]>
77 Set the color of the border.
78
79 --border-bottom <RRGGBB[AA]>
80 Set the color of the bottom border.
81
82 --button-background <RRGGBB[AA]>
83 Set the color for the background for buttons.
84
85 --text <RRGGBB[AA]>
86 Set the text color.
87
88 --border-bottom-size <size>
89 Set the thickness of the bottom border.
90
91 --message-padding <padding>
92 Set the padding for the message.
93
94 --details-border-size <size>
95 Set the thickness for the details border.
96
97 --button-border-size <size>
98 Set the thickness for the button border.
99
100 --button-gap <gap>
101 Set the size of the gap between buttons.
102
103 --button-dismiss-gap <gap>
104 Set the size of the gap between the dismiss button and another but‐
105 ton.
106
107 --button-margin-right <margin>
108 Set the margin from the right of the dismiss button to edge.
109
110 --button-padding <padding>
111 Set the padding for the button text.
112
114 swaynag(5)
115
116
117
118 2019-07-27 swaynag(1)