282b0f4e73
* Create default config and install to /etc/polybar Closes #2405 * Search for config in /etc We search in XDG_CONFIG_DIRS, /etc/xdg, and /etc but only for config.ini Closes #2016 * Remove config installation from build.sh * Remove userconfig cmake file * Cleanup * Cleanup default config * Update CHANGELOG.md Co-authored-by: dvermd <315743+dvermd@users.noreply.github.com> * Update src/main.cpp Co-authored-by: dvermd <315743+dvermd@users.noreply.github.com> * Add tests for string functions * Support loading bars from fallbacks in /etc * Combine duplicate string_util::contains test Co-authored-by: dvermd <315743+dvermd@users.noreply.github.com>
88 lines
2.4 KiB
ReStructuredText
88 lines
2.4 KiB
ReStructuredText
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.
|
|
|
|
OPTIONS
|
|
-------
|
|
|
|
.. program:: polybar
|
|
|
|
.. option:: -h, --help
|
|
|
|
Display help text and exit
|
|
|
|
.. option:: -v, --version
|
|
|
|
Display build details and exit
|
|
.. option:: -l, --log=LEVEL
|
|
|
|
| Set the logging verbosity (default: **notice**)
|
|
| *LEVEL* is one of: error, warning, notice, info, trace
|
|
.. option:: -q, --quiet
|
|
|
|
Be quiet (will override -l)
|
|
.. option:: -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 if ``XDG_CONFIG_DIRS`` is not set)
|
|
* ``/etc/polybar/config.ini``
|
|
.. option:: -r, --reload
|
|
|
|
Reload the application when the config file has been modified
|
|
.. option:: -d, --dump=PARAM
|
|
|
|
Print the value of the specified parameter *PARAM* in bar section and exit
|
|
.. option:: -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.
|
|
.. option:: -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.
|
|
.. option:: -w, --print-wmname
|
|
|
|
Print the generated *WM_NAME* and exit
|
|
.. option:: -s, --stdout
|
|
|
|
Output the data to stdout instead of drawing it to the X window
|
|
.. option:: -p, --png=FILE
|
|
|
|
Save png snapshot to *FILE* after running for 3 seconds
|
|
|
|
AUTHOR
|
|
------
|
|
| Michael Carlberg <c@rlberg.se>
|
|
| Contributors can be listed on GitHub.
|
|
|
|
REPORTING BUGS
|
|
--------------
|
|
Report issues on GitHub <https://github.com/polybar/polybar>
|
|
|
|
SEE ALSO
|
|
--------
|
|
| Full documentation at: <https://github.com/polybar/polybar>
|
|
| Project wiki: <https://github.com/polybar/polybar/wiki>
|
|
|
|
.. only:: man
|
|
|
|
:manpage:`polybar(5)`
|
|
|
|
.. only:: not man
|
|
|
|
:doc:`polybar.5`
|