============================
ChandlerSyncServices Project
============================


:Author: Grant Baillie <grant@osafoundation.org>
:Date: April 17, 2006


This is a very rudimentary prototype for synchronizing Chandler events &
calendars with Apple Sync Services in Mac OS X 10.4 (Tiger).

Installing
----------

1) Download PyObjC. I got the 1.3.7 source distribution from:

<http://prdownloads.sourceforge.net/pyobjc/pyobjc-1.3.7-py2.3-macosx10.4-1.zip?download>

2) Install the above into your Chandler build. I did::

    bash$ cd pyobjc-1.3.7
    bash$ export CHANDLERHOME=$HOME/src/chandler
    bash$ $CHANDLERHOME/release/RunPython setup.py install
    
    
    (You will need to have installed XCode for this to work).
    
3) Install ChandlerSyncServices into your Chandler::

    bash$ $CHANDLERHOME/release/RunPython setup.py develop

4) Launch Chandler as usual, e.g.::

    bash$ $CHANDLERHOME/release/RunChandler

If everything went OK, you should get a "Sync With ISync" menu item in your
"Test" menu. You can use this to pick up changes from elsewhere (mainly, at
this point Apple iCal).

What Works
----------

  - I was able to suck in a big chunk o Calendar events from iCal.
  - I was also able to create a new event in Chandler, sync, and have
    it appear magically in iCal.
    
What Doesn't Work
-----------------

  - No recurring events or tasks.
  - Device syncing (I haven't set up whatever magic is required to
    update Chandler to sync when you plug in your phone, for example).
  - Any semblance of robustness or reliability :).


Notes
-----

(Mainly, random ones to myself):

- To reset Chandler, I run tools/headless.py, and then do::

    ofKind("ChandlerISyncService").next().unregister()
  
  & afterwards run Chandler with ``--create``.
  
- To blow absolutely everything away, including my existing iCal calendars,
  I do::
  
    killall SyncServer; rm -rf ~/Library/Application\ Support/{iCal,Sync\ Services}
  
  & re-run Chandler.