README.md

What about qtmoko-ics2qtcal ?
-----------------------------

This program transfers the content of ical files (.ics) into the [QtMoko's calendar](http://qtmoko.sourceforge.net).

It has been reported to work on a Google Calendar private URL, an Office Online calendar and with Davical calendar.

It currently does not have any user-interface (but will have soon see Trim/getcal repo), and is written with a mix of Perl and shell script.

We aren't expert in those languages : the code can probably be improved (suggestions and help are welcome!) and the ical RFC isn't completed (but feature demands and bug reports are welcome).

Installation
------------

You can either :
* clone the master branch from [github](https://github.com/Trim/qtmoko-ics2qtcal.git) or from git://adorsaz.ch/qtmoko-ics.git
* download zip created for each tags/revisions
* download and install [.deb packages](https://redmine.adorsaz.ch/projects/ics2qtcal_/files)
* create and install .deb package by cloning master and debian branch and runing "gbp buildpackage"

How can I use it ?
------------------

It can run on a standard computer, or on the phone itself.
In current version, it downloads one ore several .ics files through HTTP(S), and stores their content into the SQLite database (/home/root/Applications/Qtopia/qtopia_db.sqlite , __replacing__ and removing existing appointments).
It also creates the Note files for each appointment description, in the directory where they are expected by QtMoko : /home/root/Applications/Annotator/

### Usage on QtMoko (tested on v52):
- Copy all the files in a directory of your phone (you can use git clone if you've install git, download zip file from github or [.deb package](https://redmine.adorsaz.ch/projects/ics2qtcal_/files))
- Install the necessary Perl packages by running install_dependencies.sh on the phone, if you've taken source files
- Run the script sync4ics2openmoko.sh [-u user] [-p password] [-s serverurl] fileurl1 fileurl2 ...

The optional user/password is given to the HTTP server if it needs authentication

#### Examples
- sync4ics2openmoko.sh (will parse all local files with extension .ics)
- sync4ics2openmoko.sh -u 'myuser' -p 'mypassword' -s https://myserver/mypath/ myfile1 myfile2 myfile3 
- sync4ics2openmoko.sh -u 'myuser' -p 'mypassword' -s https://myserver/ mypath1/myfile1 mypath1/myfile2 anotherpath/myfile3 

### Usage on Desktop
Usage on a standard computer (tested on Ubuntu 10.04 and 12.04) : same steps, except that you need to use remotesync4ics2openmoko.sh instead and connect your phone with IP 192.168.0.202.

How does it work ?
------------------

* ics2qtcal.pl is where the hard job is done. This script has several options and you can use it alone
* sync4ics2openmoko.sh and remotesync4ics2openmoko.sh automate the operations described above. They are targeted on my own usage, but you can modify them if you wish.

Sources
-------

* Idea taken from [openmoko wiki](http://wiki.openmoko.org/wiki/PIM_Storage#Import.2FExport_of_Calendar_Data_for_PIM-Storage) by Niebert
* [Original application](http://mossroy.free.fr/ics2qtcal/) from Mossroy
* Some code inspired or copied from [cpan](http://cpansearch.perl.org/src/BSDZ/Tie-iCal-0.14/samples/outlooksync.pl)
* The [iCal RFC](http://www.faqs.org/rfcs/rfc2445.html) implementation is quite incomplete in this script, but it covers the most common options

Developer notes
---------------

The qtmoko-ics work is done through the master branch and the debian stuff is located on the debian branch.

Suggestions/bugs
----------------

Please send any suggestion/bug report to adrien AT adorsaz DOT ch, mossroy AT free DOT fr, or use github tools

License
-------

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.