Qualendar

Japanese

Qualendar is a Datebook/ToDo application for Linux Zaurus. At present, it is known to work on SL-B500, SL-C700/750/760/860, and it is expected to work on SL-5500(new ROM)/5600/6000. It is based on "datebook" from Qtopia-free 1.5.0.

• Caution
• Features
• Installation
• Manual
• Technical information
• ChangeLog etc.
• Source, authors

Caution !

Caution !!! There is a risk of losing your PIM data, since it replaces the preinstalled Calendar and ToDo. I recommend that you back-up your data , and follow the instructions below.

C3000 is not supported(yet), because it has issues(Japanese) with "exceptional events" introduced in the preinstalled Calendar of C3000. If you haven't used teh preinstalled Calendar and are not going to sync with IntelliSync, it should be OK.

Other remarks:

• Syncronization. As the author doesn't sync with PC, syncing is not sufficiently tested. Tell me if you experience any problem at the BBS. (Entries of the forms are: subject, poster, e-mail address, URL, URL for image and the main text.)
• Categories are shared by Calendar/ToDo/Address book.
• If you fail to install, have Qualendar crashed, lose your data, of find any problems about this page, tell me at the BBS. If Qualendar gave an error report, please copy and paste it. Otherwise, copy and pase what it says in "special->info".

Features

• You can see your schedules and tasks on one calendar.
• It has user-defined holidays.
• It can:
  • color and filter schedules according to their categories,
  • show icons and background images according to the descriptions of schedules,
  • have links to files (tapping a link in "View" dialog launches an appropriate application),
• You can register templates for schedules,
• Many configuration options (although you might find it confusing),
• You may use, modify and redistribute it under the terms of GPL. No warranty.

Installation

Currently, we have only BOX (or DTM) version. (You can't use it on A300. There is some issues(Japanese) on C3000.) Since it replaces the preinstalled Calendar and ToDo, there is some risk. Below is an instruction of what I believe is a relatively safe way to install it. I recommend you to follow the instructions.

Download

Download both files:

• qualendar 0.8.10
• qualendarutil 0.8.9

An older version, in case the newest has serious bugs.

• qualendar 0.8.9

Preparation

1. Uninstall older version:
   • Uninstall all packages related to Qualendar(BOX) and datebook2(BOX).
2. Configure launcher icons into their original state:
   • If you have icons, besides the original ones, that launche applications related to Calendar/ToDo, remove them. Here, "applications related to Calendar/ToDo" means the preinstalled Calendar/ToDo, Qualendar(BOX) and the associated ToDo, datebook2(BOX) and the associated ToDo.
3. Take a full back up with "Backup and restore" application.

Installation

1. Install qualendarutil using "Add/Remove Software" application.
   • QualendarUtil appears on the "Settings" tab.
   • You can take a back-up using qualendarutil, but it is intended for use while testing (a new version of) Qualendar. After big changes, such as editing categories, you might have troubles restoring that backup.
   • If you have installed Qualendar < 0.8.0 (including datebook2), it might have "run as root" checked. Please un-check it.
2. Install qualendarbox with "Add/Remove Software" application.
3. Now, the icon for Calendar launches Qualendar.
   • You can't run the preinstalled Calendar/ToDo.
   • If you want, enable fastloading etc.
4. Configure.
   • You will find the fonts to be too small on CXX0, for example. See "Settings" below.

Uninstallation

Uninstall qualendarbox, and you will have the preinstalled Calendar/ToDo.

Manual

Key and stylus

Touching an item(schedule or todo) brings up a dialog with detailed information. You can disable it in Month view(with qualendarutil).

Adding/editing schedules/tasks

You can add/edit a schedule/task as follows.

• To add a schedule/task:
  • touch "white paper" icon, or press "Fn-N". You will have a dialog for a new task in ToDo list-view, for a new schedule elsewhere.
  • select some range of days/time, for a schedule.
  • touch "clone" icon in "View" dialog.
  • select from templates.
• To edit a schedule/task: Press Fn-M, or touch "Edit" icon in "Event view" or "Task view".
• Exceptional schedules: When editing a repeated schedule, you can choose from modifying only that occurrence/modifying all. See "Exceptions" below.

Exceptions

When editing a repeated schedule, you can choose from modifying the occurrence/modifying all. An exceptional schedule is made by splitting it into (typically) 3 -- that occurrence, before and after. Thus, changes to one of them do NOT affect others.

User-defined holidays

You can register/remove a user-defined holiday with ":". The data is not synchronized with PC.

Links

You can make a link to a file by selecting "Edit->attach a file" in "Edit" dialog.

• It's just some text like "[[file:///...]]" inserted into "notes" field.
• You can also use "<file://Zaurus/home/...>"

Settings

"Special->Settings" launches QualendarUtil. (When you launch QualendarUtil directly, you have to "Reload settings" in Qualendar.)

• Filter: if, for example, "Day" in "Business" is 012, a schedule with category "Business" is hidden when the filter number is 0, 1 or 2 in Day view.
• Icon, background: if "key" matches leading letters of description, images are painted(longest match). Put your images in /home/QtPalmtop/pics/qualendar/ (you'll have to be root).

Technical information

Files

• Configuration files: below $(HOME)/Settings/
  • qpe.conf, ampm, onMonday(read only) from [Time].
  • DateBook.conf(shared with the preinstalled Calendar), alarmpreset, presetTime, startviewtime from [Main].
  • Qualendar.conf, QualendarBackground.txt, QualendarColor.txt, QualendarFilter.txt, QualendarIcon.txt, QualendarTemplate.conf, QualendarTmp.conf, QualendarViewer.txt
• Data files: below $(HOME)/Applications/
  • SLDATE.BOX, SLDATE*.IDX, SLTODO.BOX, SLTODO.IDX (shared with the preinstalled Calendar/ToDo) in dtm/ directory. Data for schedules/tasks.
  • It seems that files like zpinSLD* are created in dtm/.
  • datebook/specialdays????.txt: user-defined holidays. Possible extention: something like "Cff80ff 2004 5 9 holiday" for specifying a color.
• Holidays: /home/QtPalmtop/etc/holidays.txt

ChangeLog, TODO

ChangeLog

See ChangeLog for details(Japanese).

(2005.1.10) Version 0.8.10. The next version will be 1.0.0, hopefully.
(2004.5.17) Version 0.8.4b. Fixed a bug in todo view.
(2004.5.12) Version 0.8.4a. Fixed a bug in saving user-defined holidays.
(2004.5.11) Version 0.8.4. Fixed a bug related to timezone(especially DST).
(2004.1.31) Version 0.8.0.

TODO

After 1.0.0, I am going to work on A300(and XML version).

Source, authors

You can use, modify and redistribute the source under the terms of GPL.

Source for 0.8.10.

• Trolltech is the (main) author and copyright holder of Qtopia. Qualendar is based on "datebook" application from Qtopia 1.5.0.
• ichitokumei(the author of this page, mail address: ichitokumei@yahoo.co.jp) modified "datebook" and is distributing it as Qualendar.