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 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.
Warning
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
Scripted setup
You can find a script to clone and build the initial environment over here
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-presence-applet ktp-filetransfer-handler ktp-send-file
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).
Compiling manually
KDE Telepathy internals
Before the other components, you need to build a library carrying internal components.
ktp-common-internals project page
git clone kde:ktp-common-internals
Telepathy Logger Qt Bindings
Needed to compile the contact list app. If it complains about missing QtGLib, install qt-gstreamer-devel package (libqtgstreamer-dev on k/ubuntu).
telepathy-logger-qt project page
git clone kde:telepathy-logger-qt
Telepathy Accounts KCM
The next thing to get set up is the Telepathy Accounts KCM. This is the UI for account management. Note that this requires telepathy-logger-qt.
git clone kde:ktp-accounts-kcm
This can be compiled and installed by the usual KDE build procedure.
Contact List App
This application provides a traditional contact-list, similar to the one provided by Kopete. Note that this requires telepathy-logger-qt.
git clone kde:ktp-contact-list
Chat window App
This application provides a text chat window.
git clone kde:ktp-text-ui
The approver
This notifies you when an incoming message arrives and hangs in the system tray until you're ready to start a chat.
git clone kde:ktp-approver
Workspace Integration Module
Sits in KDED and sets your presence automatically to 'Away' after certain amount of time, can set your presence to your current song from an mpris-enabled media player (Amarok and Clementine work great) and also contains an error handler which is very important if you want to be notified of errors
git clone kde:ktp-kded-module
Auth handler
Handles kwallet integration, and prompts/sends passwords to connection managers when requested.
git clone kde:ktp-auth-handler
Presence Plasmoid
This shows the online-ness of your accounts and allows to bring accounts online/offline
ktp-presence-applet project page
git clone kde:ktp-presence-applet
The File Transfer Handler
Does the actual transferring of files between two contacts. Displays progress via KJob
ktp-filetransfer-handler project page
git clone kde:ktp-filetransfer-handler
Dolphin Integration
Allows you to start a file transfer via a handy shortcut in your file manager.
git clone kde:ktp-send-file
Call window App
This application provides a voice/video chat window (optional). Note that this requires QtGstreamer.
git clone kde:ktp-call-ui
Experimental Components not part of KTp (just yet)
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