KTp/Getting Set Up: Difference between revisions
rename telepathy to ktp, update projects.kde.org links playground -> kdereview |
|||
| Line 41: | Line 41: | ||
The next thing to get set up is the Telepathy Accounts KCM. This is the UI for account management. | The next thing to get set up is the Telepathy Accounts KCM. This is the UI for account management. | ||
[https://projects.kde.org/projects/kdereview/ktp-accounts-kcm KDE Project Page] | |||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
git clone kde: | git clone kde:ktp-accounts-kcm | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 51: | Line 51: | ||
===Contact List App=== | ===Contact List App=== | ||
This application provides a traditional contact-list, similar to the one provided by Kopete. | This application provides a traditional contact-list, similar to the one provided by Kopete. | ||
[https://projects.kde.org/projects/kdereview/ktp-contact-list KDE Project Page] | |||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
git clone kde: | git clone kde:ktp-contact-list | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 64: | Line 66: | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
git clone kde: | git clone kde:ktp-text-ui | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 72: | Line 74: | ||
[https://projects.kde.org/projects/playground/network/telepathy/telepathy-approver/ KDE Project Page] | [https://projects.kde.org/projects/playground/network/telepathy/telepathy-approver/ KDE Project Page] | ||
<syntaxhighlight lang="bash"> | |||
git clone kde:ktp-approver | |||
</syntaxhighlight> | |||
===Workspace Integration Module=== | ===Workspace Integration Module=== | ||
| Line 78: | Line 84: | ||
[https://projects.kde.org/projects/playground/network/telepathy/telepathy-kded-module/ KDE Project Page] | [https://projects.kde.org/projects/playground/network/telepathy/telepathy-kded-module/ KDE Project Page] | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
git clone kde: | git clone kde:ktp-kded-module | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 88: | Line 93: | ||
Handles kwallet integration, and prompts/sends passwords to connection managers when requested. | Handles kwallet integration, and prompts/sends passwords to connection managers when requested. | ||
[https://projects.kde.org/projects/ | [https://projects.kde.org/projects/kdereview/ktp-auth-handler KDE Project Page] | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
git clone kde: | git clone kde:ktp-auth-handler | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 99: | Line 103: | ||
This shows the online-ness of your accounts and allows to bring accounts online/offline | This shows the online-ness of your accounts and allows to bring accounts online/offline | ||
[https://projects.kde.org/projects/ | [https://projects.kde.org/projects/kdereview/ktp-presence-applet KDE Project Page] | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
git clone kde: | git clone kde:ktp-presence-applet | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 114: | Line 113: | ||
Does the actual transferring of files between two contacts. Displays progress via KJob | Does the actual transferring of files between two contacts. Displays progress via KJob | ||
[https://projects.kde.org/projects/ | [https://projects.kde.org/projects/kdereview/ktp-filetransfer-handler KDE Project Page] | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
git clone kde: | git clone kde:ktp-filetransfer-handler | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 124: | Line 123: | ||
Allows you to start a file transfer via a handy shortcut in your file manager. | Allows you to start a file transfer via a handy shortcut in your file manager. | ||
[https://projects.kde.org/projects/ | [https://projects.kde.org/projects/kdereview/ktp-send-file KDE Project Page] | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
git clone kde: | git clone kde:ktp-send-file | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Revision as of 15:04, 27 December 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
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 '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.9. 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.
KTelepathy internals
Before the other components, you need to build a library carrying internal components. You can check it out with
git clone kde:telepathy-common-internals
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.
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.
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 and Dataengine
This shows the online-ness of your accounts and allows to bring accounts online/offline
git clone kde:ktp-presence-applet
The File Transfer Handler
Does the actual transferring of files between two contacts. Displays progress via KJob
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
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
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