View source for KTp/Installing stable release

This how-to will help you set up stable release of KDE-Telepathy on your computer. Most of it takes action in console, but don't worry, it's easy.

Packagers please follow [http://community.kde.org/Real-Time_Communication_and_Collaboration/Packaging_Guide the Packaging guide].

==Prerequisites==

You will need to install several cross-desktop Telepathy components. Packages of the following from your distribution should do fine.
* telepathy-mission-control-5 (a must have)
* telepathy-gabble (for GTalk/Facebook Chat/Jabber support)
* telepathy-butterfly (for basic MSN support)
* telepathy-haze (for all other protocols)

==TelepathyQt4==

The prerequisite for all the Telepathy stuff to build is the TelepathyQt4 library. Your distribution may package it, in which case you need version 0.7.1 or higher. Be careful not to confuse it with the telepathy-qt library which used to be in kdesupport SVN. This is *completely* different and in no way compatible. 

If your distro doesn't provide TelepathyQt4 package, don't worry, you can compile it yourself, it's easy.

If you are compiling Tp-Qt4 and get a warning about needing a newer glib, simply ignore it. Glib is only needed for some internal Tp-Qt4 tests.

===Compiling TelepathyQt4===

First of all you need to download the latest version of TelepathyQt4 from [http://telepathy.freedesktop.org/releases/telepathy-qt4/ here]. Currently it's [http://telepathy.freedesktop.org/releases/telepathy-qt4/telepathy-qt4-0.7.1.tar.gz 0.7.1]. Extract it to to some directory and then switch to terminal.

First we need to create a special build directory and then switch to it.
<pre>
$ mkdir -p build && cd build
</pre>

Once there, we'll run the configuration scripts:

<pre>
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=release ..
</pre>

If everything went ok and the last line says "Build files have been written", move to the compiling itself. Use -jN for how many cores you have +1, eg. -j3 for two cores CPU.

<pre>
$ make -j3
</pre>

Once successfully compiled, you just need to install it and you're done with TelepathyQt4. For this, you need to know the superuser password.

<pre>
$ sudo make install
</pre>

==Installing KDE-Telepathy components==
KDE-Telepathy has several components:
 * Accounts KCM + Plugins
 * Approver
 * Contact List
 * File Transfer Handler
 * Presence Plasma widget + Plasma DataEngine
 * Send File plugin for Dolphin
 * Text UI (the chat window)

Each component will have the exact same steps needed, so we'll put it here just once. Download all 9 packages and extract each one into it's own directory. Then just follow the steps for compiling TelepathyQt4:

<code>first cd into the component's dir, eg. 'cd telepathy-accounts-kcm'
$ mkdir -p build && cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=release ..
$ make -j3
$ sudo make install
</code>

After you finish with all components, you can open System Settings and you'll find new 'Instant Messaging Accounts' icon there and you can set up your accounts there. If something's not working right after the install, you may need to log out and log back in. If you still have problems, feel free to contact us at #kde-telepathy on freenode or file a bug at [http://bugs.kde.org].

Welcome online!