Kontact Mobile
Kontact Mobile is the name for the project of porting the KDEPIM suite to work on mobile platforms. This includes the Kolab Client functionality.
There are two platform we aim at first:
* Maemo5 (on the N900) * Win CE 6.5 (on the HTC Touch Pro 2)
The project is under heavy development at the moment - but we encourage people to test and feedback upon it.
Installation and Update
At the moment there is only an installable version for the N900 available
On the N900
Installation
We offer a one click installation file for N900 users. Simply click that link on your N900 browser and afterwards directly install Kontact mobile on your device (be sure you have good and affordable internet access when doing so).
You can find detailed, up-to-date instruction on how to install the current state on the N900 in this README:
http://files.kolab.org/local/maemo/README.html
For testing purposes you should always use the UNSTABLE section. Do not use the other sections. We try to update the unstable 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
(If you are curious you can do 'apt-get upgrade', which would not install new packages and kdepim-mobile might need, which is why explicitely installing the 'kdepim-mobile' package is better.)
Deinstallation
If installation happened only using the hildon application manager, you should be able to deinstall 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
> apt-get remove kdepim-mobile
You could find
> apt-get remove libkdecore5 > apt-get autoremove
helpful to remove all the KDE related stuff.
Check what is installed by useing '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 is 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
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
Other devices
Are at the moment not supported. Please wait for more information. HTC Touch Pro 2 is the next device we want to get Kontact Mobile to work on.
Getting started
After installation you will find 5 new applications on your phone: KDE Mail, KDE Calendar, KDE Addressbook, KDE Notes, KDE Tasks.
You can of course start the application from command line. Please use kmail-mobile.sh (accordingly for the other apps), as this command sets the LD_LIBRARY_PATH correctly.
First thing you would want to do is to set-up a new email account. To do this you start KDE Mail, pull the flap "Actions" on the Homepage out, press "Add Account" and then follow the instructions.
Note: you cannot do this from all applications at the moment - but for email this works fine. If you should have a Kolab Server, all other applications will access the data from your server too.
Get encryption working
One of the core features of Kontact Mobile is your ability to communicate savely using S/MIME or OpenPGP. We do not provide the generation of keys on the mobile phone - you will need to set-up your keys on a computer, e.g. by using Kleopatra.
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 setting 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 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.
Using it: Ideas and Concepts
Navigate through your folders by our flatten tree view. You can also choose to see multiple folders at once, when you click on "Select" on the homepage.
Actions can be accessed through what we call flaps. You have to pull them out, in order to not mix interaction up with clicking through your accounts and folders.
We hope the other ideas are straight forward and discoverable, so we do not want to give you more hints... Give us feedback if you think we are wrong with this assumption.
Contributing / Questions and Answers / Feedback / ...
There are many ways to contribute or feedback to this project:
You discovered a defect
Please report any problems to bugs.kde.org. You might find some hot workarounds in the issues attached to bugs.kde.org/246519 - Issues that need improvements in order to make n900 kdepim-mobile usable (aka "beta")
Note that we have created own categories for the mobile products, so please make use of that. For every problem you report, we need to know two things:
* What section from the apt repository did you use? (unstable, experimental or snapshots) * What day did you last update your applications? (for version info)
To get the exact version run dpkg -s kmail-mobile | grep Version or dpkg -l | grep kmail-mobile in the terminal
Consider doing an update before reporting a problem. The project is under heavy development and the chances are good, the defect has already been fixed.
The overall stability of the packages is good. We do not expect any data loss or severe problems, as we share much of the codebase from the desktop client. But still: This product is under development, so expect to experience any kind of bugs.
We are accompanying the development by steady usability work. You are very welcome to participate in this process. For this, but also for less structured feedback, consider joining our mailing list.
You want to contribute to the development
For the people with a more technical view we also communicate via a mailing list.
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 run
> kdepim-shutdown
to be sure there are no resource eaters running.