Ccal

download - instructions/manual - screenshots - feedback - future plans

Manual

New features in 0.5

Postsript printing
press x and a file will be saved in your home directory (assuming you have latex and dvips installed.

Editor based entry
when adding an entry enter "e" as the entry and an editor will be started. the first line of the text you enter will be the text that appears in ccal. You can access the further information you enter in the rest of the file by pressing "e" over the entry in todo or entry mode. You can also edit existing entries by pressing "e" over them. To change the editor or the tmp path (defaults vim and /tmp) put something like this in your config file:

[editing]
temppath=/tmp
editor=vim


Colour coded entries
Simply press 0,1,2 or 3 over an entry to change it's colour. 0 is normal.



There are three modes in ccal - Todo, Date and Entry. You start up in Date mode.


Date Mode

In this mode you can press left and right to move back and forth through the days and up and down to move back forth through the months.
The calendar display in the corner highlights the currently viewed date and any dates which have entries
a will add an entry and / will let you jump to a particular date
pressing enter will move you into entry mode and pressing t will move you into todo mode
finally n will take you back to today's entries and q will quit the program

Entry Mode

In entry mode you can move through the diary entries for a particulate date and delete them. up and down move you through the entries and d will delete the currently selected one. a allows you to add a new entry
enter will take you back to date mode

Todo Mode

Todo mode functions exactly the same way as entry mode but you are adding to-do list entries not diary entries.

New - Internet database

Ccal -0.3 allows you to store your diary/journal and todo information on a web server so that if you use ccal in several places, your information will stay synchronised. This is achieved by placing a cgi script (provided) on a web server somewhere. The host of the cgi script must have python installed and the script must be able to write to somewhere. The path that the script should write to can be changed by changing the " path" variable in the cgi script. You can then configure ccal to use this cgi script by creating a file in your home directory called .ccalrc
This file should contain the following lines (with your server path in place of the one below):

[database]
cgiURL=http://www.someserver.com/cgi-bin/diary.py

If the config file is present and contains a cgiURL then ccal will use internet storage by default, if it is not present it will use local storage as in the original version. You can also switch between the two types of storage in case of failure or to create backups. Simple press i to switch between internet and local storage. You will then need to press l to load, or s to save the database to the currently selected storage.

So if you want to copy your locally-stored information (from ccal 0.2 for example) to your new internet-based storage you could press i to switch to local storage, press l to load the database from the local store, then press i to switch back to internet storage and s to store the loaded database to the internet storage.

If you have internet-based storage setup then ccal will load from this database on startup and save back to it on exit. This may take a few seconds depending on your connection.

You can view the day's appointments and the to-do list online by simply entering the path of the CGI script in your web browser. I was thinking about providing a more rich web-based interface and possibly wap-access but I don't have much need for these myself. Let me know if you'd like it.