This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Achim Tuffentsammer <at666@t-online.de>

Project's homepage:          http://pim.vdr-developer.org/

Latest version available at: http://pim.vdr-developer.org/

See the file COPYING for license information.

Description:
------------

This is a plugin for VDR to display a month-based calendar.
You can browse the months bei pressing +/- buttons.
Use the up/down/left/right buttons to move the cursor around.
If you hit the first/last day of a month and continue to
move the cursor, the calendar will jump to the previous/next
month.

A day will be displayed in green color if there's any event for
this day. Press OK to see a list of all events for this day.

Press BLUE to see a list of all events.

In either of these lists you can edit / insert / delete events
like in VDR's timer menu.

Events will be stored in a textfile which is located in your
vdr-runtime-directory and is called plugins/pimEvents.conf.
If no file exists it will be created if necessary. Please ignore
any error messages after the first start.

Of course you can edit the textfile manually. Make sure to use
the right format (see below) for the entrys or the plugin i.e.
your VDR may crash.

Format of the conf-file:

F:dd.mm.yyyy:description         for an event on a fixed day
W:3:description                  for a repeating event on day 3 (Mo = 1 ...)
Y:dd.mm.:description             for a yearly event (like birthdays).


IMPORTANT
---------
We use the commandline utility 'cal' to obtain the calendar.
There are different versions of cal out there. Some (e.g. mine)
come with a setup option '-m' which makes Monday the first day
of week. 
If you have any problems with the displayed calendar - e.g. 
empty display or days and header do not match - please adjust
either the commandline call or the flag if Monday is first or
both (all this can be done via OSD-setup)

And now have fun!


