KTp/Getting Set Up: Difference between revisions

From KDE Community Wiki
< KTp
(Replace code tags with sytaxhighlight)
Line 32: Line 32:
Source code is [https://projects.kde.org/projects/playground/network/telepathy/telepathy-accounts-kcm/ here].
Source code is [https://projects.kde.org/projects/playground/network/telepathy/telepathy-accounts-kcm/ here].


<code>git clone kde:telepathy-accounts-kcm</code>
<syntaxhighlight lang="bash">
git clone kde:telepathy-accounts-kcm
</syntaxhighlight>


This can be compiled and installed by the usual KDE build procedure.
This can be compiled and installed by the usual KDE build procedure.
Line 40: Line 42:
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]
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>
<syntaxhighlight lang="bash">
git clone kde:telepathy-contact-list
</syntaxhighlight>


===Chat window App===
===Chat window App===
Line 48: Line 52:
[https://projects.kde.org/projects/playground/network/telepathy/telepathy-chat-handler KDE Project Page]
[https://projects.kde.org/projects/playground/network/telepathy/telepathy-chat-handler KDE Project Page]


<code>git clone kde:telepathy-text-ui</code>
<syntaxhighlight lang="bash">
git clone kde:telepathy-text-ui
</syntaxhighlight>


===The approver===
===The approver===
Line 63: Line 69:




<code>git clone kde:telepathy-kded-module</code>
<syntaxhighlight lang="bash">
git clone kde:telepathy-kded-module
</syntaxhighlight>


===Auth handler===
===Auth handler===
Line 72: Line 80:




<code>git clone kde:telepathy-auth-handler</code>
<syntaxhighlight lang="bash">
git clone kde:telepathy-auth-handler
</syntaxhighlight>


===Presence Plasmoid and Dataengine===
===Presence Plasmoid and Dataengine===
Line 81: Line 91:
[https://projects.kde.org/projects/playground/network/telepathy/telepathy-presence-dataengine/ KDE Project Page]
[https://projects.kde.org/projects/playground/network/telepathy/telepathy-presence-dataengine/ KDE Project Page]


<code>
<syntaxhighlight lang="bash">
git clone kde:telepathy-presence-applet
git clone kde:telepathy-presence-applet
</code>
</syntaxhighlight>


<code>
<syntaxhighlight lang="bash">
git clone kde:telepathy-presence-dataengine
git clone kde:telepathy-presence-dataengine
</code>
</syntaxhighlight>


===The File Transfer Handler===
===The File Transfer Handler===
Line 95: Line 105:
[https://projects.kde.org/projects/playground/network/telepathy/telepathy-filetransfer-handler/ KDE Project Page]
[https://projects.kde.org/projects/playground/network/telepathy/telepathy-filetransfer-handler/ KDE Project Page]


<code>git clone kde:telepathy-filetransfer-handler</code>
<syntaxhighlight lang="bash">
git clone kde:telepathy-filetransfer-handler
</syntaxhighlight>


=== Dolphin Integration ===
=== Dolphin Integration ===
Line 103: Line 115:
[https://projects.kde.org/projects/playground/network/telepathy/telepathy-send-file/ KDE Project Page]
[https://projects.kde.org/projects/playground/network/telepathy/telepathy-send-file/ KDE Project Page]


<code>git clone kde:telepathy-send-file</code>
<syntaxhighlight lang="bash">
git clone kde:telepathy-send-file
</syntaxhighlight>


==The bits that might work for you, but might not==
==The bits that might work for you, but might not==
Line 113: Line 127:
Not part of KDE Telepathy but needed to compile the call window app
Not part of KDE Telepathy but needed to compile the call window app


<code>git clone git://anongit.freedesktop.org/gstreamer/qt-gstreamer</code>
<syntaxhighlight lang="bash">
git clone git://anongit.freedesktop.org/gstreamer/qt-gstreamer
</syntaxhighlight>


===Call window App===
===Call window App===
Line 119: Line 135:
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].
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>
<syntaxhighlight lang="bash">
 
git clone kde:telepathy-call-ui
 
</syntaxhighlight>




Line 129: Line 145:
===Shared desktop ontologies===
===Shared desktop ontologies===


<code>git clone git://oscaf.git.sourceforge.net/gitroot/oscaf/shared-desktop-ontologies</code>
<syntaxhighlight lang="bash">
git clone git://oscaf.git.sourceforge.net/gitroot/oscaf/shared-desktop-ontologies
</syntaxhighlight>


===KDE Telepathy library : libktelepathy===
===KDE Telepathy library : libktelepathy===
Line 137: Line 155:
Source code is [https://projects.kde.org/projects/playground/network/telepathy/telepathy-kde/repository/ here].
Source code is [https://projects.kde.org/projects/playground/network/telepathy/telepathy-kde/repository/ here].


<code>git clone kde:telepathy-kde</code>
<syntaxhighlight lang="bash">
git clone kde:telepathy-kde
</syntaxhighlight>


This can be compiled and installed by the usual KDE build procedure.
This can be compiled and installed by the usual KDE build procedure.
Line 147: Line 167:
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]
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>
<syntaxhighlight lang="bash">
git clone kde:telepathy-nepomuk-service
</syntaxhighlight>

Revision as of 19:22, 6 November 2011

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 here. Your distribution may package it, in which case you need version >= 0.7.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.

Scripted setup

You can find a script to clone and build the initial environment over here

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 here.

git clone kde:telepathy-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. Code is in git here

git clone kde:telepathy-contact-list

Chat window App

This application provides a text chat window.

KDE Project Page

git clone kde:telepathy-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.

KDE Project Page

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

KDE Project Page


git clone kde:telepathy-kded-module

Auth handler

Handles kwallet integration, and prompts/sends passwords to connection managers when requested.

KDE Project Page


git clone kde:telepathy-auth-handler

Presence Plasmoid and Dataengine

This shows the online-ness of your accounts and allows to bring accounts online/offline

KDE Project Page KDE Project Page

git clone kde:telepathy-presence-applet
git clone kde:telepathy-presence-dataengine

The File Transfer Handler

Does the actual transferring of files between two contacts. Displays progress via KJob

KDE Project Page

git clone kde:telepathy-filetransfer-handler

Dolphin Integration

Allows you to start a file transfer via a handy shortcut in your file manager.

KDE Project Page

git clone kde:telepathy-send-file

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

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

Call window App

This application provides a voice/video chat window (optional). Code is in git here.

git clone kde:telepathy-call-ui


The other bits

Shared desktop ontologies

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

KDE Telepathy library : libktelepathy

NOTE: git master probably won't compile.

Source code is here.

git clone kde:telepathy-kde

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

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