Light-monitor : Documentation

Light-monitor

All the configuration is done on the ~/.config/light-monitor.conf
Default configuration is in /etc/light-monitor.conf
You can pass an alternate conf file as an argument.

Empty line and line begining with # are comments.

window

There must be at least one window
window are created with brackets :
[Light-monitor]

all the following widgets/fonts/calendar/color are local to the current window

placement

you can either give coordinates
pos x y
or place it on one screen border.
bottom delta
in this case, delta is used by light-monitor to know where to put the center of the application. Instead of bottom you can use top, right or left

Colors

You can declare colors for the fonts
color n r g b
where r g b are the red, green and blue composants (between 0 and 65535). n is the index of the color.

Fonts

You can declare fonts using those colors. Colors must be defined before the fonts.
font n size color name
where n is the index of the font, size is its size in points, name is for example sans, and color is the index of its color.

Widgets

You can finally declare the widgets.
widget x y font name arg
where x and y are the coordinates inside the pannel, font is the font index, name is the widget name, and arg is the argument, only if necessary.

Widget list :

Light-calendar

Currently light-calendar does not have config file. You can choose where to put it by giving it two arguments on the comand line, namely x and y. Or you can choose where to put it and what colors are to be used for the text. Colors are between 0 and 65535. the first color is for the text, the second one is the color of the current day. It makes 8 arguments in this case (x y c1_r c1_g c1_b c2_r c2_g c2_b). You can add one more argument (it makes 9 in this case) which is the day shift : with no value it means the week begins on Sunday, with 6 the week begins on Monday.

gosd

gosd is a simple library used to offer OSD (on screen display) functionality for desklet-like usage.

Look at the others source codes to guess how to use it. Real documentation will eventually be here.

Bugs

Visit sourceforge for reporting bugs or mail me