PDA Configuration

Here’s all the stuff that isn’t essential to BUG’s role as a communications device, but is essential to BUG’s role as a PDA and desktop extention. This is a matter of taste. You might leave some or all of these off, or perhaps install them on an Applications Card.

Desktop Synchronization

UPDATE: We updated our desktop system to Debian Sarge (KDE 3.3.2), but couldn’t get Kitchensync to work. Instead, we’ve switched to Pi-Sync. See the next section, instead. You don’t need both Kitchensync and Pi-Sync.

Set up Kitchensync

We use Kitchensync to sync the Z’s PIM stuff with our Linux apps (KOrganizer and the phone book). It works great for us. If you’re using something else, though, then we can’t help you. Kitchensync had a couple of oddities involved in getting it working right, and the first sync will cause you to lose any ToDo items you have in KOrganizer. Sorry about that.

  1. Even though it shows as the default, you have to go to the security app and select Opie 1.0 anyhow.
  2. Be sure the you’ve set your proper location in KOrganizer (Settings… Configure KOrganizer… Time & Date), or all of your events will get mysteriously timeshifted.
  3. Run Kitchensync. The first time you connect to the Z with Kitchensyc, a confirmation dialog will appear on the Z. Tap “Allow”.
  4. Sync
  5. Create a dummy todo item on the Z
  6. Sync
  7. Delete the dummy todo item using Korganizer
  8. Sync


Pi-Sync unfortunately requires a couple of sizable packages on the Zaurus as well as on the desktop. The primary benefit you get, though, is that there’s a Pi-Sync for Windows as well, so you can sync freely between Windows, Linux, and/or the Zaurus!

  1. Execute: ipkg install -d root kopi
  2. Execute: ipkg install -d root kopi-applet
  3. Execute: ipkg install -d root kapi
  4. On the desktop, install Pi-Sync. If you’re using Debian Sarge, here’s a package for you.

Be sure that the profile name is the same on the Z and the desktop(s).


We use GnuPG both on BUG and on the dekstop. BUG is a central component of our gpg existence. The .gnupg subdirectory (where our private keyring is) is kept on BUG’s SD card, where it can be used in the field. When we want to use our keys on the desktop, we put the Z into its dock and start the NFS mount. A symbolic link from ~/.gnupg points to the .gnupg directory on the Z (through the mountpoint).

This means that the user(s) who run(s) GnuPG must exist both on the Z and on the desktop, so they have proper permissions to access the keyrings. Use “adduser” to create users on the Z.

  1. Execute: ipkg install -d root /mnt/cf/pkgs/gnupg_1.2.1_arm.ipk
  2. Move the ~username/.gnupg directory from the desktop to the Z
  3. Execute: chown -R username.users /home/username/.gnupg
  4. Execute: chmod -R 600 /home/username/.gnupg
  5. On the dekstop, create a symbolic link to replace the now-missing .gnupg directory. If the Z is mounted at /mnt/bug, then you’d do something like: ln -s /mnt/bug/home/username/.gnupg /home/username/.gnupg

CUPS Client

Yes, we like to print stuff from BUG, and use CUPS as our printserver.

It’s not documented, but the TMPDIR environment variable must be set for certain functions to work. If you used our profile, then this is already done.

  1. Execute: ipkg install -d root /mnt/cf/pkgs/cupsclient_1.1.20_arm.ipk
  2. change ServerName in /etc/cups/client.conf to
  3. add “cupsenable” to end of /etc/init.d/finish
  4. Remember to adjust your CUPS server on the desktop. You’ll probably have
    to allow access from at a couple of point in /etc/cups/cupsd.conf

ESD Streamer

So we can stream audio from the desktop to the Z. Handy to use the Z as a wireless audio player with XMMS.

  1. Activate the opie-feed-351 feed, either by uncommenting the src line in /etc/ipkg.conf
    or by using the package manager in the GUI.
  2. Execute: ipkg update
  3. Execute: ipkg install -d root esd
  4. Execute: ipkg install -d root esd-utils
  5. Execute: ipkg install -d root esddsp
  6. Deactivate the opie-feed-351 feed
  7. Execute: rm /usr/lib/ipkg/lists/opie-feed-351
  8. Execute: ipkg update
  9. Execute: cp /mnt/cf/pkgs/esdstreamer/esdstreamer.sh /opt/QtPalmtop/bin/
  10. Execute: cp /mnt/cf/pkgs/esdstreamer/esdstreamer.desktop /opt/QtPalmtop/apps/Opie-SH/

To stream audio to Z with XMMS on desktop: Set the desktop’s XMMS output driver to use eSound. Configure it to “use remote host” and enter the Z’s IP address (probably if Z is docked. use “ifconfig” to find out what it is).

On Z, run “esd -public -tcp -terminate&”. Start playing through desktop XMMS. The Z’s esd will terminate automatically when XMMS stops broadcasting. For convenience, we’ve installed an Opie-SH script to start the listener. Just tap on it and go.

In practice, it can sometimes be tricky to get XMMS to actually route over the lan. If it didn’t work, set XMMS output driver options again (even if you are setting them to the same thing), run the Z’s listener, hit “stop” then “start” on XMMS. If you fiddle with it, it’ll start.

Miscellaneous Apps

  1. Execute: ipkg install -d root opie-zsafe
    A note about zsafe: if you don’t want it to bug you to create a new data file each time you run it, name the data file “passwords.zsf”
  2. Execute: ipkg install -d root opie-checkbook
  3. Execute: ipkg install -d root opie-calculator

See Also:

Zaurus ESD
Running ESound