Kontact Touch/Maemo5

    From KDE UserBase Wiki
    Other languages:

    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.