KTp/Getting Set Up

These instructions assume that you already know how to build KDE stuff from source. Check the "building KDE applications page" for more help with that. The rest of this page will just tell you what to build and where to get it from.

Prerequisites

You will need KDE 4.10 or 4.9. We do not require latest git KDE.

You will need to install several cross-desktop Telepathy components. Packages of the following from your distribution should do fine.

• telepathy-mission-control-5
• telepathy-gabble for Jabber, GTalk and Facebook Chat support
• other Telepathy connection managers if you want to try out other protocols
  • telepathy-haze for icq, msn, yahoo, aim and all the others that Pidgin/libpurple supports
  • telepathy-rakia for sip
• telepathy-logger (for the contact list)

Recently we started using some features of kdelibs 4.7.0, so you need at least KDE SC 4.7 to compile and run KDE-Telepathy.

We're using some dbus service files and it has been proven that these needs to be in /usr/share/dbus-1/, otherwise you won't be able to connect, start a chat or do other stuff. So if you're using your own install prefix, please make sure you have copied/linked these files to /usr/share/dbus-1/* first before posting a bugreport. Thanks.

You will also need to follow the steps to setup the kde: prefix in Git, if you have not done so already.

Telepathy-Qt

Building any of the KDE telepathy software requires the Telepathy-Qt library. Your distribution may package it, in which case you need version >= 0.9.

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

If you are building your own copy of Telepathy-Qt, clone the git repository and use the usual cmake method to build and install it.

QtGstreamer

In order to build the call window application, you will need the Qt bindings for GStreamer. Your distribution will probably provide packages, or you can build from git:

git clone git://anongit.freedesktop.org/gstreamer/qt-gstreamer

Recommended installation

This method is based on a scratch of David Edmundson which is located here. You may pull it on your local machine and run install.sh.

git clone git://anongit.kde.org/scratch/davidedmundson/ktp-bootstrap.git
cd ktp-bootstrap
sh install.sh

Warning: While using some Ubuntu distributions you would like to have these packages installed (they are critical to build Ktp on your machine) from apt:

sudo apt-get install doxygen graphviz libfarstream-0.1-dev libgstreamer-plugins-base0.10-dev libgstreamer0.10-dev libqt4-dev libtelepathy-farstream-0.4-dev libtelepathy-glib-dev pkg-config cmake debhelper kdelibs5-dev libtelepathy-logger-dev libtelepathy-logger-qt4-dev libtelepathy-qt4-dev pkg-kde-tools bison cmake flex libqt4-dev libqtgstreamer-dev libtelepathy-glib-dev libtelepathy-logger-dev libxml2-dev python python-dev libxml-parser-perl librpc-xml-perl

As soon as your installation has finished you can start Ktp by choosing Instant Messaging Contact List from the menu of your system. Alternatively, you may want to discover source yourself, e.g. if you are planning to contribute. Then, you can go path ~/ktp/ktp/ktp-contact-list (git repository is already set there!)

Using kdesrc-build

To use kdesrc-build to build kde telepathy just add the following to your .kdesrc-buildrc file:

module-set ktp
    use-modules telepathy-logger-qt ktp-common-internals ktp-accounts-kcm ktp-contact-list ktp-text-ui ktp-approver ktp-kded-module ktp-auth-handler ktp-filetransfer-handler ktp-send-file ktp-desktop-applets ktp-call-ui
    repository kde-projects
end module-set

Then do kdesrc-build ktp to build all of it, or kdesrc-build ktp-send-file to build just ktp-send-file, for example (although bear in mind that you will need to build ktp-common-internals before any other ktp projects, and telepathy-logger-qt before ktp-text-ui and ktp-contact-list).

NOTE: If you have both qt4 and qt5 installed, you may need tell kdesrc-build to use qt4 by including the following in ~/.kdesrc-buildrc (global section):

cmake-options -DQT_QMAKE_EXECUTABLE=/usr/bin/qmake-qt4

Similarly, if you have both Python 3 and Python 2 installed, you may need to point to the python2 path:

cmake-options -DQT_QMAKE_EXECUTABLE=/usr/bin/qmake-qt4 -DPYTHON_EXECUTABLE=/usr/bin/python2

Experimental Components not part of KTp (just yet)

Shared desktop ontologies

git clone git://oscaf.git.sourceforge.net/gitroot/oscaf/shared-desktop-ontologies

Nepomuk Service

NOTE: git master probably won't compile.

The Nepomuk service obsoletes the daemon and integrates Telepathy with Nepomuk, which is required by the Contact List application. Code is in git here

git clone kde:telepathy-nepomuk-service