Kontact Touch/Maemo5

Installation and Update

Maemo 5 (e.g. Nokia N900)

Installation

The repository installation file will add the extras-devel and Kontact-Touch-testing repositories . Simply click that link on your N900 browser to add the necessary repositories.

Warning

To use the Kontact-Touch repository you will have to enable the http://wiki.maemo.org/Extras-devel repository. (The above link will do that.) Like all other beta software that has dependencies on extras-devel, we would like to remind you to not blindly update from -devel and recommend disabling extras-devel again after installing or updating Kontact Touch

To verify the downloaded packages in this apt repository you should import the Intevation File Distribution Key into apt:

gpg --keyserver hkp://keys.gnupg.net --recv-keys EC70B1B8
gpg --export EC70B1B8 | apt-key add -

The recommended way to install Kontact Touch on N900 is to open a terminal and run

root
apt-get update
apt-get install kdepim-mobile

after adding the testing repository (be sure you have good and affordable internet access when doing so).

To get root access on your device see [1]

You can find some additional instructions on how to install different Kontact Touch repositories on the N900 in this README

For testing purposes you should always use the TESTING section. Do not use the other sections. We try to update the testing section about once a week.

Update

Use the command line to update. (At the moment the update does not work via the N900 program manager, we believe it has some subtle problems.)

Make sure to have the package rootsh installed, to be able to get administrator rights. Use the application X Terminal or a remote shell connection and enter the following to do the update

root
apt-get update
apt-get install kdepim-mobile
apt-get upgrade

(Technical background: 'apt-get upgrade' would not install new packages that kdepim-mobile might need. Only doing 'install kdepim-mobile' used to fail with some package sets because the dependencies were not tight enough. So it is better to do both 'install kdepim-mobile' and 'upgrade'.)

Note that you have to reboot the N900 or manually restart several services like akonadiserver in order to profit from changes in these underlying services. If you are testing, rebooting the phone before your next tests is strongly recommended.

Stop all Kontact Touch related processes

We have included a small script that stops and shuts down all processes that might cost you resources even after you quit any KDE mobile application. Just open a console and, to be sure there are no resource eaters running, run

kdepim-shutdown

Alternatively you can restart your phone.

Deinstallation

If installation happened only using the hildon application manager, you should be able to uninstall the same way.

When apt-get was used manually, you might have selected some additional packages for which you need apt-get to remove them again. Typically this will need

apt-get remove kdepim-mobile

You could find the following helpful to remove all the KDE related stuff.

apt-get remove libkdecore5 kdelibs5-data kdebase-runtime-data
apt-get autoremove

Check what is installed by using

dpkg -l | grep kde

. Everything that has an "ii" in the beginning of the line still is installed. Another attempt to see what is already installed from a KDE SC 4.x is

dpkg -l | grep -e "^.i.*4:4"

.

(Pay attention that other installations might use the KDE components, like libkok is used by freoffice.)

Clear the configuration

If you want to start over or remove the configuration of the KDE components completely, you need to deal with three places. First make sure that no kdepim related application is running anymore! Here are a number of commands to move the old files into a new backup directory 'dot.kde-20100728'.

cd
d=dot.kde-20100728
mkdir $d $d/dot.config 
mv .config/akonadi $d/dot.config
mkdir -p $d/dot.local/share
mv .local/share/akonadi $d/dot.local/share
mv .kde $d

Also, some resources (like unsent mails) can be found at ~/.local/share/local-mail, ~/.local/share/contacts, ~/.local/share/notes and ~/.local/share/.local-mail.directory .

There is one step that you might have to do after moving away (or deleting) the .kde directory. Some packages create a preset kdewallet.kwl file for the 'user', which you need to recreate. The script doing so usually can be rightfully called so by the user:

/var/lib/dpkg/info/kdebase-runtime.postinst

It basically does:

mkdir -p /home/user/.kde/share/apps/kwallet
cp /usr/share/kde4/apps/kwallet/kdewallet.kwl /home/user/.kde/share/apps/kwallet

Language

If you want to test a localized version, issue

root
apt-get update
apt-get install kde-l10n-de
apt-get upgrade

The above snippet will install the German (-de) translation. Remove the "-de" for English, and substitute a language code for any other language.

Get encryption working

There is a touch version of kleopatra, if the package is not installed by the dependencies, install it. You can use it to import your certificates or you just use Gnupg like you would on other GNU systems on the command line.

You might need to check the permissions and the owner on the .gnupg folder, it seems that there are some conditions where this folder belongs to root. For crypto to work as a user, the user will need to be able to write the files in the folder.

Alternatively: Assuming you have all your keys together on your computer, you can find them most likely in ~/.gnupg. Please copy this folder to your N900, by simply connecting it via USB with your computer and copying the folder (Note: you might need to change some settings to be able to see hidden files. In Dolphin this would be Alt + . ). Now disconnect your N900.

If you already have a .gnupg folder on your phone, consider making a backup or deleting it before you do next steps.

Close all Kontact mobile applications. Open X Terminal on the N900. If you copied the .gnupg to the root folder of your MemoryCard on your N900 (Default Name: 'MyDocs') the following commands in X Terminal will do the job for you:

mv MyDocs/.gnupg ~/.gnupg
chmod 700 ~/.gnupg

Now you should be able to read and write signed and encrypted messages.

General Hints

• If an application hangs you can press ctl(sym) + backspace (upper left and upper right button) simultaneously to get back to the application overview.
• To enter special symbols like < > or | you can push the arrow symbol in the upper left corner and then the ctl(sym) to get a symbol table.
• To make a screenshot, press Ctrl + Shift + P. The screenshot(s) will be saved in /home/user/MyDocs/.images .
• If you like to start the applications from the command line, you need to use the wrapper scripts, as long as qt-experimental is used, to set the right LD_LIBRARY_PATH, e.g. kmail-mobile.sh, korganiser-mobile.sh, kaddressbook-mobile.sh.