palm2ical - Palm Databook/Calendar conversion to iCalendar
==========================================================

The palm2ical program reads a PalmOS Datebook or Calendar database
file (DatebookDB.PDB or CalendarDB-PDat.PDB) and writes complete
information from all entries as an iCalendar (RFC 2445) file, suitable
for import to Microsoft Outlook, Google Calendar, Mozilla Sunbird, and
many other calendar applications.

Entries can also be selected by date, category, or number. This
allows, for example, the export of different categories into separate
Google Calendars.

See the palm2ical web page for documentation, including instructions
for extracting the Palm Database files from your Palm or a simulator
(this is necessary because palm2ical does not read the Palm Desktop files).

      http://hepunx.rl.ac.uk/~adye/software/palm/palm2ical/

Installation
============

palm2ical is written in Perl and requires CPAN packages p5-Palm,
Data-ICal, DateTime-Format-ICal, Data-ICal-TimeZone, and their
dependencies. These should work on most operating systems
(Windows, Linux, MacOS, etc). In order to support the newer
Calendar-format file (CalendarDB-PDat.PDB), you need the latest
"developer release" of the p5-Palm package (p5-Palm-1.009_02, dated
21 Aug 2009 or later - note that releases numbered 1.2.4 and 1.3.0
are older).

For Windows users, who might not have Perl or the CPAN packages
installed, I have made a stand-alone executable that can be used
instead. This can be downloaded from the palm2ical web page.

This zip file contains the following Perl scripts:

  palm2ical     Palm Databook/Calendar conversion to iCalendar
  fixpdb        displays or changes Palm Database file headers

Documentation
=============

Run the command with the -h option for help, or see palm2ical web page for
full details: http://hepunx.rl.ac.uk/~adye/software/palm/palm2ical/

License
=======

Copyright (C) 2009-2010, Tim Adye.
This program is free software; you may redistribute it under the terms of the
Artistic License, as specified at http://dev.perl.org/licenses/artistic.html

- Tim Adye <T.J.Adye@rl.ac.uk>
