0.4 README
Welcome to Chandler!
This is Chandler's 0.4 release, and while it is still far from complete, we have made enormous progress since 0.3.
Introduction and Overview
Purpose of release
The high-level goal of the 0.4 release is to be "experimentally usable" for a few key end-user tasks. In 0.4, you can:
- Create, edit, and view PIM Items: Email, Calendar Events, Task, and Notes
- Add Task, Email, or Event properties to any PIM item, in a process we call "Stamping"
- Share item collections (including calendars) via a WebDAV server with other Chandler users.
- Perform very basic email and calendar operations (e.g. send and receive email or create and modify calendar events)
In addition, the 0.4 Release provides:
- Sending and receiving of mail over a TLS/SSL connection (a fully secure TLS transport is not implemented yet)
- A basic UI landscape: Sidebar, Tabs, Summary & Detail views
Running Chandler
For OS X and Windows XP, running Chandler is very simple. You can double-click on the Chandler executable, named Chandler (Mac OS X), or Chandler.exe (Windows XP). If you are running Mac OS X, you need to copy Chandler from your .dmg disk image to somewhere else on your file system first.
There is a problem with the Linux distribution such that you cannot simply double-click on the the binary. (See Bug #1672.) You will need to change to the
chandler subdirectory, then type
release/RunChandler. Note that you must be in the
chandler directory; you cannot change to the release directory and type
./RunChandler.
Additional platform-specific information is in README.linux.txt, README.win.txt, and README.osx.txt.
If you compile Chandler yourself, the instructions are slightly more complicated: see
RunningChandlerFromSourceReleases.
Setting Preferences
To use the sharing features of Chandler revision 0.4, you will need accounts on IMAP, SMTP, and WebDAV servers. The WebDAV server acts as an intermediary for Items, while email is used to send and receive invitations to share data.
To set the preferences, select
File->Preferences->Accounts. You will then have a choice of setting the IMAP, SMTP, and WebDAV servers.
Email Account
For IMAP and SMTP preferences, you should be able to look at the preferences in your normal email program to figure out what the settings should be in Chandler. For "Full Name" in the IMAP preferences, use your own full name, e.g. "Mabel Garcia".
WebDAV Account
You will also need a WebDAV account.
If you do not already have a WebDAV account, you can get a free account from
Sharemation. If you want to set up your own WebDAV server, see http://www.webdav.org/mod_dav.
For a Sharemation account, for
Server, type in
- http://www.sharemation.com
For
Path, type in
IMPORTANT: Do not put a slash (/) at the beginning of the path field! That will confuse Chandler.
Requirements
Chandler uses a number of components (e.g. Python), but all the software you should need to
run Chandler is shipped with Chandler. In general, OSAF develops on Microsoft Windows XP, Red Hat Fedora Core 2, and Apple Mac OS 10.3 ("Panther").
We keep
a list of platforms that Chandler is known to build and run on. We have no reason to believe that it wouldn't work on other reasonably current versions of operating systems, but in general, haven't tested them.
One occasional difficulty is libraries on Unix machines.
If you are running with something other than a standard Red Hat Fedora Core 2 system, you
might need to either install a few modules or rebuild the binaries.
How to get involved
There are several ways that you can get involved.
The first is to
download Chandler and try it out. If you find a bug, please check the
list of known bugs in 0.4, and if it isn't listed,
report it?.
If you have an idea for a feature request, the best thing to do is to post it to our mailing lists.
We also have a
list of small, self-contained projects -- not necessarily technical -- that
we could use some help with.
Further information
For more information, please see documentation on our wiki at:
Known Major Bugs
For information about major bugs in the 0.4 release, see
- http://wiki.osafoundation.org/bin/view/Chandler/ZeroPointFourKnownMajorBugs
License
Chandler 0.4 Copyright (c) 2002-2004 Open Source Applications Foundation
The 0.4 version of Chandler is available under the GNU General Public License,
version 2, as described in
You can also see the authoritative version of the GNU GPL.
We expect that subsequent versions of Chandler will also be
available under one or more additional licenses. For more detail on our
licensing plans, see the Chandler Licensing Plan.
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; either version 2 of the License, or (at your option) any
later version.
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.
0.5 Planning
For more on our future plans, see
- http://wiki.osafoundation.org/bin/view/Chandler/ZeroPointFivePlanning