1POLYBAR(1)                    Polybar User Manual                   POLYBAR(1)
2
3
4

NAME

6       polybar - A fast and easy-to-use tool status bar
7

SYNOPSIS

9       polybar [OPTIONS]... [BAR]
10

DESCRIPTION

12       Polybar aims to help users build beautiful and highly customizable sta‐
13       tus bars for their desktop environment, without the need  of  having  a
14       black belt in shell scripting.  If the BAR argument is not provided and
15       the configuration file only contains one bar definition,  polybar  will
16       display this bar.
17

OPTIONS

19       -h, --help
20              Display help text and exit
21
22       -v, --version
23              Display build details and exit
24
25       -l, --log=LEVEL
26              Set the logging verbosity (default: notice)
27              LEVEL is one of: error, warning, notice, info, trace
28
29
30       -q, --quiet
31              Be quiet (will override -l)
32
33       -c, --config=FILE
34              Specify the path to the configuration file. By default, the con‐
35              figuration file is loaded from:
36
37              • $XDG_CONFIG_HOME/polybar/config
38
39              • $XDG_CONFIG_HOME/polybar/config.ini
40
41              • $HOME/.config/polybar/config
42
43              • $HOME/.config/polybar/config.ini
44
45              • $XDG_CONFIG_DIRS/polybar/config.ini
46
47              • /etc/xdg/polybar/config.ini (only if  XDG_CONFIG_DIRS  is  not
48                set)
49
50              • /etc/polybar/config.ini
51
52       -r, --reload
53              Reload the application when the config file has been modified
54
55       -d, --dump=PARAM
56              Print  the value of the specified parameter PARAM in bar section
57              and exit
58
59       -m, --list-monitors
60              Print list of available monitors and exit.
61              If some monitors are cloned, this will exclude all but one of them.
62              If polybar was compiled with RandR monitor support, only monitors are listed and not physical outputs.
63
64
65       -M, --list-all-monitors
66              Print list of all available monitors and exit.
67              This includes cloned monitors as well as both physical outputs and RandR monitors (if supported).
68              Only the names listed here can be used as monitor names in polybar.
69
70
71       -w, --print-wmname
72              Print the generated WM_NAME and exit
73
74       -s, --stdout
75              Output the data to stdout instead of drawing it to the X window
76
77       -p, --png=FILE
78              Save png snapshot to FILE after running for 3 seconds
79

AUTHORS

81       Polybar was created by Michael Carlberg and is currently maintained by Patrick Ziegler.
82       Contributors can be listed on GitHub.
83
84

REPORTING BUGS

86       Report issues on GitHub <https://github.com/polybar/polybar>
87

SEE ALSO

89       polybar-msg(1), polybar(5)
90       Full documentation at: <https://github.com/polybar/polybar>
91       Project wiki: <https://github.com/polybar/polybar/wiki>
92
93

95       2016-2023, Michael Carlberg & contributors
96
97
98
99
1003.7.1                            Nov 30, 2023                       POLYBAR(1)
Impressum