bar - bar ain't recursive
bar [-h | -g widthxheight+x+y | -b | -d | -f font | -p | -u pixel | -B color | -F color]
bar is a lightweight bar entirely based on XCB. Provides full UTF-8 support, basic formatting, RandR and Xinerama support and EWMH compliance without wasting your precious memory.
- -h
-
Display the help and exit.
- -g widthxheight+x+y
-
Set the window geometry. If a parameter is omitted it's filled with the default value. If the y parameter is specified along with the -b switch then the position is relative to the bottom of the screen.
- -b
-
Dock the bar at the bottom of the screen.
- -d
-
Force docking without asking the window manager. This is needed if the window manager isn't EWMH compliant.
- -f font
-
Comma separated list of fonts, bar supports a maximum of two fonts.
- -p
-
Make bar permanent, don't exit after the standard input is closed.
- -u pixel
-
Sets the underline width in pixels. The default is 1.
- -B color
-
Set the background color of the bar. color might be either in hex format (#aarrggbb) or in the symbolic name format (eg. white, brightred, darkgray). If no compositor such as compton or xcompmgr is running the alpha channel is silently ignored.
- -F color
-
Set the foreground color of the bar. Accepts the same color formats as -B.
bar provides a screenrc-inspired formatting syntax to allow full customization at runtime. Every formatting block is opened with %{ and closed by } and accepts the following commands, the parser tries it's best to handle malformed input.
- R
-
Swap the current background and foreground colors.
- l
-
Aligns the following text to the left side of the screen.
- c
-
Aligns the following text to the center of the screen.
- r
-
Aligns the following text to the right side of the screen.
- Bcolor
-
Set the text background color. The parameter color can be - or a color in one of the formats mentioned before. The special value - resets the color to the default one.
- Fcolor
-
Set the text foreground color. The parameter color can be - or a color in one of the formats mentioned before. The special value - resets the color to the default one.
- Ucolor
-
Set the text underline color. The parameter color can be - or a color in one of the formats mentioned before. The special value - resets the color to the default one.
-
Create a clickable area starting from the current position, when the area is clicked command is executed. The area is closed when a A token, not followed by : is encountered.
Eg. %{A:reboot:} Click here to reboot %{A}
The button field is optional, it defaults to the left button, and it's a number ranging from 1 to 5 which maps to the left, middle, right, scroll down and scroll up movements. Your mileage may vary.
- Sdir
-
Change the monitor bar is rendering to. dir can be either
- +/-
-
Next/previous monitor.
- f/l
-
First/last monitor.
- 0-9
-
Nth monitor.
Attribute modifiers
- +attribute
-
Set the attribute attribute for the following text.
- -attribute
-
Unset the attribute attribute for the following text.
- !attribute
-
Toggle the attribute attribute for the following text.
Where attribute is one of the following
- o
-
Draw a line over the text.
- u
-
Draw a line under the text.
Clicking on an area makes bar output the command to stdout, followed by a newline, allowing the user to pipe it into a script, execute it or simply ignore it. Simple and powerful, that's it.
2012-2014 (C) The Lemon Man
Xinerama support was kindly contributed by Stebalien
RandR support was kindly contributed by jvvv
Clickable areas support was heavily based off u-ra contribution