polybar(1)¶
SYNOPSIS¶
polybar [OPTIONS]... [BAR]
DESCRIPTION¶
Polybar aims to help users build beautiful and highly customizable status bars for their desktop environment, without the need of having a black belt in shell scripting. If the BAR argument is not provided and the configuration file only contains one bar definition, polybar will display this bar.
OPTIONS¶
-
-h
,
--help
¶
Display help text and exit
-
-v
,
--version
¶
Display build details and exit
-
-l
,
--log
=LEVEL
¶ - Set the logging verbosity (default: notice)LEVEL is one of: error, warning, notice, info, trace
-
-q
,
--quiet
¶
Be quiet (will override -l)
-
-c
,
--config
=FILE
¶ Specify the path to the configuration file. By default, the configuration file is loaded from:
$XDG_CONFIG_HOME/polybar/config
$XDG_CONFIG_HOME/polybar/config.ini
$HOME/.config/polybar/config
$HOME/.config/polybar/config.ini
$XDG_CONFIG_DIRS/polybar/config.ini
/etc/xdg/polybar/config.ini
(only ifXDG_CONFIG_DIRS
is not set)/etc/polybar/config.ini
-
-r
,
--reload
¶
Reload the application when the config file has been modified
-
-d
,
--dump
=PARAM
¶ Print the value of the specified parameter PARAM in bar section and exit
-
-m
,
--list-monitors
¶
- Print list of available monitors and exit.If some monitors are cloned, this will exclude all but one of them.If polybar was compiled with RandR monitor support, only monitors are listed and not physical outputs.
-
-M
,
--list-all-monitors
¶
- Print list of all available monitors and exit.This includes cloned monitors as well as both physical outputs and RandR monitors (if supported).Only the names listed here can be used as monitor names in polybar.
-
-w
,
--print-wmname
¶
Print the generated WM_NAME and exit
-
-s
,
--stdout
¶
Output the data to stdout instead of drawing it to the X window
-
-p
,
--png
=FILE
¶ Save png snapshot to FILE after running for 3 seconds
AUTHORS¶
REPORTING BUGS¶
Report issues on GitHub <https://github.com/polybar/polybar>