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
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

APPEARANCE OPTIONS

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

SEE

114       swaynag(5)
115
116
117
118                                  2019-07-27                        swaynag(1)
Impressum