1I3-NAGBAR(1)                       i3 Manual                      I3-NAGBAR(1)
2
3
4

NAME

6       i3-nagbar - displays an error bar on top of your screen
7

SYNOPSIS

9       i3-nagbar [-m <message>] [-b <button> <action>] [-B <button> <action>]
10       [-t warning|error] [-f <font>] [-v] [-p]
11

OPTIONS

13       -v, --version
14           Display version number and exit.
15
16       -h, --help
17           Display a short help-message and exit.
18
19       -t, --type type
20           Display either a warning or error message. This only changes the
21           color scheme for the i3-nagbar. Default: error.
22
23       -m, --message message
24           Display message as text on the left of the i3-nagbar.
25
26       -f, --font font
27           Select font that is being used.
28
29       -b, --button button action
30           Create a button with text button. The action are the shell commands
31           that will be executed by this button. Multiple buttons can be
32           defined. Will launch the shell commands inside a terminal emulator,
33           using i3-sensible-terminal.
34
35       -B, --button-no-terminal button action
36           Same as above, but will execute the shell commands directly,
37           without launching a terminal emulator.
38
39       -p, --primary
40           Always opens the i3-nagbar on the primary monitor. By default it
41           opens on the focused monitor.
42

DESCRIPTION

44       i3-nagbar is used by i3 to tell you about errors in your configuration
45       file (for example). While these errors are logged to the logfile (if
46       any), the past has proven that users are either not aware of their
47       logfile or do not check it after modifying the configuration file.
48

EXAMPLE

50           i3-nagbar -m 'You have an error in your i3 config file!' \
51           -b 'edit config' 'i3-sensible-editor ~/.config/i3/config'
52

SEE ALSO

54       i3(1)
55

AUTHOR

57       Michael Stapelberg and contributors
58
59
60
61i3 4.21.1                         10/28/2022                      I3-NAGBAR(1)