=head1 NAME
lemonbar - Featherweight lemon-scented bar
=for HTML
=head1 SYNOPSIS
I
=head1 DESCRIPTION
B
=head1 INPUT
The data to be parsed is read from the standard input, parsing and printing the input data are delayed until a newline is found.
=head1 OPTIONS
=over
=item B<-h>
Display the help and exit.
=item B<-g> I
Set the window geometry. If a parameter is omitted it's filled with the default value. If the I
=item B<-o> I
Set next output to I
=item B<-b>
Dock the bar at the bottom of the screen.
=item B<-d>
Force docking without asking the window manager. This is needed if the window manager isn't EWMH compliant.
=item B<-f> I
Specifies a font to use. Can be used multiple times to load more than a single font.
=item B<-p>
Make the bar permanent, don't exit after the standard input is closed.
=item B<-n> I
Set the WM_NAME atom value for the bar.
=item B<-u> I
Sets the underline width in pixels. The default is 1.
=item B<-B> I
Set the background color of the bar. I
=item B<-F> I
Set the foreground color of the bar. Accepts the same color formats as B<-B>.
=item B<-U> I
Set the underline color of the bar. Accepts the same color formats as B<-B>.
=back
=head1 FORMATTING
lemonbar provides a screenrc-inspired formatting syntax to allow full customization at runtime. Every formatting block is opened with C<%{> and closed by C<}> and accepts the following commands, the parser tries its best to handle malformed input. Use C<%%> to get a literal percent sign (C<%>).
=over
=item B
Swap the current background and foreground colors.
=item B
Aligns the following text to the left side of the screen.
=item B
Aligns the following text to the center of the screen.
=item B
Aligns the following text to the right side of the screen.
=item B
Offset the current position by I
=item BI
Set the text background color. The parameter I
=item B
Set the text foreground color. The parameter I
=item B
Set the font used to draw the following text. The parameter I
=item BI
Set the text underline color. The parameter I
=item BI
Create a clickable area starting from the current position, when the area is clicked I
Eg. I<%{A:reboot:} Click here to reboot %{A}>
The I
Nested clickable areas can trigger different commands.
Eg. I<%{A:reboot:}%{A3:halt:} Left click to reboot, right click to shutdown %{A}%{A}>
=item BI
Change the monitor the bar is rendered to. I
=over
=item B<+>/B<->
Next/previous monitor.
=item B
First/last monitor.
=item I<0-9>
Nth monitor.
=item I
Named monitor. Eg. I<%{SnHDMI-0} This text will show up on the HDMI-0 output>
=back
=back
B
=over
=item B<+>I
Set the attribute I
=item B<->I
Unset the attribute I
=item B<!>I
Toggle the attribute I
=back
Where I
=over
=item B
Draw a line over the text.
=item B
Draw a line under the text.
=back
=head1 OUTPUT
Clicking on an area makes lemonbar 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.
=head1 WWW
L<git repository|https://github.com/LemonBoy/bar>
=head1 AUTHOR
2012-2020 (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