.\" Man page generated from reStructuredText.
.
.TH "POLYBAR" "1" "May 13, 2022" "3.6.3" "Polybar User Manual"
.SH NAME
polybar \- A fast and easy-to-use tool status bar
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBpolybar\fP [\fIOPTIONS\fP]... [\fIBAR\fP]
.SH DESCRIPTION
.sp
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 \fIBAR\fP argument is not provided and the configuration file only contains one bar definition, polybar will display this bar.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-h, \-\-help
Display help text and exit
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-version
Display build details and exit
.UNINDENT
.INDENT 0.0
.TP
.B \-l, \-\-log=LEVEL
.nf
Set the logging verbosity (default: \fBnotice\fP)
\fILEVEL\fP is one of: error, warning, notice, info, trace
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \-q, \-\-quiet
Be quiet (will override \-l)
.UNINDENT
.INDENT 0.0
.TP
.B \-c, \-\-config=FILE
Specify the path to the configuration file. By default, the configuration file is loaded from:
.INDENT 7.0
.IP \(bu 2
\fB$XDG_CONFIG_HOME/polybar/config\fP
.IP \(bu 2
\fB$XDG_CONFIG_HOME/polybar/config.ini\fP
.IP \(bu 2
\fB$HOME/.config/polybar/config\fP
.IP \(bu 2
\fB$HOME/.config/polybar/config.ini\fP
.IP \(bu 2
\fB$XDG_CONFIG_DIRS/polybar/config.ini\fP
.IP \(bu 2
\fB/etc/xdg/polybar/config.ini\fP (only if \fBXDG_CONFIG_DIRS\fP is not set)
.IP \(bu 2
\fB/etc/polybar/config.ini\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-r, \-\-reload
Reload the application when the config file has been modified
.UNINDENT
.INDENT 0.0
.TP
.B \-d, \-\-dump=PARAM
Print the value of the specified parameter \fIPARAM\fP in bar section and exit
.UNINDENT
.INDENT 0.0
.TP
.B \-m, \-\-list\-monitors
.nf
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.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \-M, \-\-list\-all\-monitors
.nf
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.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \-w, \-\-print\-wmname
Print the generated \fIWM_NAME\fP and exit
.UNINDENT
.INDENT 0.0
.TP
.B \-s, \-\-stdout
Output the data to stdout instead of drawing it to the X window
.UNINDENT
.INDENT 0.0
.TP
.B \-p, \-\-png=FILE
Save png snapshot to \fIFILE\fP after running for 3 seconds
.UNINDENT
.SH AUTHORS
.nf
Polybar was created by Michael Carlberg and is currently maintained by Patrick Ziegler.
Contributors can be listed on GitHub.
.fi
.sp
.SH REPORTING BUGS
.sp
Report issues on GitHub <\fI\%https://github.com/polybar/polybar\fP>
.SH SEE ALSO
.sp
\fBpolybar\-msg\fP(1),
\fBpolybar\fP(5)
.nf
Full documentation at: <\fI\%https://github.com/polybar/polybar\fP>
Project wiki: <\fI\%https://github.com/polybar/polybar/wiki\fP>
.fi
.sp
.SH COPYRIGHT
2016-2022, Michael Carlberg & contributors
.\" Generated by docutils manpage writer.
.