lemonbar/README.md

72 lines
2.1 KiB
Markdown
Raw Normal View History

2012-07-16 09:41:34 +00:00
b(ar) a(in't) r(ecursive)
=========================
2012-2013 (C) The Lemon Man
2012-07-16 09:41:34 +00:00
A lightweight bar based on XCB (yay). Provides foreground/background color
switching along with text alignment (screw you dzen!), full utf8 support
and reduced memory footprint. It also supports transparency when using a
compositor such as compton. Nothing less and nothing more.
2012-07-16 09:41:34 +00:00
2013-10-02 08:21:43 +00:00
Xinerama support
----------------
Thanks to @Stebalien now bar is Xinerama compliant, just compile it with
XINERAMA=1 and you're good to go!
Options
-------
2012-07-18 15:33:03 +00:00
bar accepts a couple of command line switches.
```
2012-07-24 10:08:02 +00:00
-h Show the help and bail out.
-p Make the bar permanent.
-f Force docking (use this if your WM isn't EWMH compliant)
2012-07-24 10:08:02 +00:00
-b Show the bar at the bottom of the screen.
```
2012-07-16 09:41:34 +00:00
Configuration
-------------
Change the config.h file and you're good to go!
The text background and foreground are respectively the first and the second
entries in the palette (COLOR0 and COLOR1).
2012-07-18 15:25:19 +00:00
Colors
------
Attached there's palette.pl, an handy tool that extracts a palette from your
X colors and returns it ready to be pasted in the configuration file.
```
palette.pl <.Xresources / .Xdefaults path>
```
If you keep your colors in a separate file just feed that file and you're good
to go.
2012-07-16 09:41:34 +00:00
Text formatting
---------------
All the format commands are preceded by a backslash (\\).
To draw a backslash just backslash escape it (\\\\).
```
f<0-9> Selects the text foreground color from the palette.
b<0-9> Selects the text background color from the palette.
2012-07-20 14:28:12 +00:00
u<0-9> Selects the underline color from the palette.
2012-07-27 00:07:36 +00:00
To reset the bg/fg/underline color just pass 'r' as the color index.
2012-07-16 09:41:34 +00:00
l Aligns the text to the left.
c Aligns the text to the center.
r Aligns the text to the right.
```
2013-10-02 08:21:43 +00:00
The options below are valid only if compiled with Xinerama support.
```
s<0-9> Switches to screen 0-9
sn Switches to next screen
sp Switches to previous screen
sr Switches to the rightmost screen (the latest)
sl Switches to the leftmost screen (the first)
```
2014-01-13 16:46:03 +00:00
Clickable areas can be defined with \\ab text \\ac command \\ae.