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.
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.
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.