View source for KTp/Getting Set Up

These instructions assume that you already know how to build KDE stuff from source. It just provides a list of what you need to checkout and build, and how to run it.

==Prerequisites==

You will also 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 support)
* other Telepathy connection managers if you want to try out other protocols

You will also need to follow the steps 'Let Git rewrite URL prefixes' listed here, if you have not done so already.:
http://community.kde.org/Sysadmin/GitKdeOrgManual#Let_Git_rewrite_URL_prefixes

==TelepathyQt4==

The prerequisite for all the Telepathy stuff to build is the TelepathyQt4 library. The source code for this is available [http://cgit.freedesktop.org/telepathy/telepathy-qt4/ here]. Your distribution may package it, in which case you need version >= 0.5.3. 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 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.

If you are building your own copy of TelepathyQt4, clone the git repository linked above and use the usual cmake method to build and install it.

==The parts ready for testing==

Please fetch these, and file bugs on any required missing features or problems. Keep things realistic on the feature requests.

===Telepathy Accounts KCM===

The next thing to get set up is the Telepathy Accounts KCM. This is the UI for account management.

Source code is [https://projects.kde.org/projects/playground/network/telepathy/telepathy-accounts-kcm/ here].

<code>git clone kde:telepathy-accounts-kcm</code>

This can be compiled and installed by the usual KDE build procedure.

You will also want the plugins for this app, found at [https://projects.kde.org/projects/playground/network/telepathy/telepathy-accounts-kcm/telepathy-accounts-kcm-plugins here].

<code>git clone kde:telepathy-accounts-kcm-plugins</code>

===Chat window App===

This application provides a text chat window. Code is in git [https://projects.kde.org/projects/playground/network/telepathy/telepathy-chat-handler here]

<code>git clone kde:telepathy-chat-handler</code>

===The approver===

This notifies you when an incoming message arrives and hangs in the system tray until you're ready to start a chat.
[https://projects.kde.org/projects/playground/network/telepathy/telepathy-approver/ here]
<code>git clone kde:telepathy-approver</code>

==The bits that might work for you, but might not==

These parts might work for you - it's worth installing but don't start filing bugs yet.

===QtGstreamer===

Not part of KDE Telepathy but needed to compile the call window app

<code>git clone git://gitorious.org/qtgstreamer/qtgstreamer.git</code>

(packages also available for ubuntu at https://launchpad.net/~gstreamer-developers/+archive/ppa)

===Call window App===

This application provides a voice/video chat window (optional). Code is in git [https://projects.kde.org/projects/playground/network/telepathy/telepathy-call-ui here].

<code>git clone kde:telepathy-call-ui</code>

===Presence Plasmoid and Dataengine===

In order to bring accounts on/offline you will need the Presence Plasmoid and its data engine. These are in svn [https://projects.kde.org/projects/playground/network/telepathy/telepathy-presence-applet/repository here] and [https://projects.kde.org/projects/playground/network/telepathy/telepathy-presence-dataengine/repository here].

<code>git clone kde:telepathy-presence-applet
git clone kde:telepathy-presence-dataengine</code>


===Contact List App===

This application provides a traditional contact-list, similar to the one provided by Kopete. Code is in git [https://projects.kde.org/projects/playground/network/telepathy/telepathy-contact-list here]

<code>git clone kde:telepathy-contact-list</code>

The newest code is available here:

<code>git clone kde:clones/telepathy-contact-list/mklapetek/telepathy-contact-list-new
</code>

==The other bits==

===Shared desktop ontologies===

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

===KDE Telepathy library : libktelepathy===

NOTE: git master probably won't compile.

Source code is [https://projects.kde.org/projects/playground/network/telepathy/telepathy-kde/repository/ here].

<code>git clone kde:telepathy-kde</code>

This can be compiled and installed by the usual KDE build procedure.

===Integration Daemon / 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 [https://projects.kde.org/projects/playground/network/telepathy/telepathy-nepomuk-service here]

<code>git clone kde:telepathy-nepomuk-service</code>