Packages
Many Linux distributions have Telepathy packages available. We recommend that you use those where possible. Telepathy packages can be found in the main repositories of Debian (lenny or later), Fedora, Ubuntu (feisty or later), and Gentoo.
- Telepathy packages can be found in the main repositories of Debian unstable, Ubuntu Feisty and Gentoo.
If you have Ubuntu 6.06, you can fetch packages by adding deb http://telepathy.freedesktop.org/debian dapper main to your apt sources.
If you have ArchLinux all you need to do is enable the Community repo.
If anyone wants to package up for their favourite distro, or has packaging that's not noted here, please bring this up on the mailing list or #telepathy.
Source code for most Telepathy components is here.
Jhbuild
Check Jhbuild
Common build procedure
Unless specified otherwise, build a Telepathy component as follows:
$ sh autogen.sh
$ make
$ sudo make install
If autogen.sh doesn't exist, run autoreconf -i instead.
Common dependencies
As all components use recent additions to DBus, you need DBus 0.61 or later.
For Debian-based systems:
$ sudo aptitude install build-essential autoconf automake1.9 libtool libglib2.0-dev libdbus-glib-1-dev devscripts gtk-doc-tools libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev gstreamer0.10-plugins-bad gstreamer0.10-ffmpeg gstreamer0.10-plugins-good gstreamer0.10-plugins-base gstreamer0.10-plugins-base gstreamer0.10-plugins-ugly gstreamer0.10-x gstreamer0.10-tools darcs libloudmouth1-dev python-gobject-dev python-dbus dbus libssl-dev xsltproc
Building libtelepathy
Releases: http://telepathy.freedesktop.org/releases/libtelepathy/
Git: git clone git://git.collabora.co.uk/git/libtelepathy.git
NOTE: Now considered old. Use telepathy-glib instead.
Building telepathy-glib
Releases: http://telepathy.freedesktop.org/releases/telepathy-glib/
Git: git clone git://git.collabora.co.uk/git/telepathy-glib.git
Building Gabble
Gabble is a Jabber connection manager. You need D-Bus 0.61 or greater.
Releases: http://telepathy.freedesktop.org/releases/telepathy-gabble/
Git: git clone git://git.collabora.co.uk/git/telepathy-gabble.git
Dependencies: libloudmouth1-dev
Running Gabble
Although Gabble is activated on demand by dbus, you can run it manually in a terminal to see log information.
$ GABBLE_PERSIST=1 ./src/telepathy-gabble
For debugging Gabble, setting the LM_DEBUG=net environment variable can also be useful.
Obtaining Jingle
Tarballs, courtesy of Tapioca:
http://sourceforge.net/project/showfiles.php?group_id=146406&package_id=192727
The Tapioca wiki also has instructions on installing libjingle.
Building Farsight plugins for gstreamer (gst-plugins-farsight)
Git: git clone git://git.collabora.co.uk/git/gst-plugins-farsight.git
Note that if you install this package outside of the standard /usr prefix that GStreamer is generally installed in by your distro, the GST_PLUGIN_PATH environment variable needs to be set for all GStreamer clients, including the Stream Engine. Note that this can get tricky if you rely on D-Bus service activation to execute the Stream Engine for you; one approach is to point the D-Bus service file at a script that sets the environment variable and then executes the real Stream Engine.
For example:
$ export GST_PLUGIN_PATH="/usr/local/lib/gstreamer-0.10/"
Building Farsight
This depends on gstreamer with both plugins-base and plugins-good, jingle (installed above), and the Farsight plugins for Gstreamer (also installed above).
Releases: http://telepathy.freedesktop.org/releases/farsight/
Git: git clone git://git.collabora.co.uk/git/farsight2.git
For now, it's normal that only the RTP plugin is configured for building by autogen.sh/configure.
If you get errors about SGML while building the documentation, just rerun make.
Building Stream Engine
Stream Engine depends on libtelepathy, Farsight and gst-plugins-farsight.
Releases: http://telepathy.freedesktop.org/releases/stream-engine/
Git: git clone git://git.collabora.co.uk/git/telepathy-stream-engine.git
Running Stream Engine
Although Stream Engine is activated on demand by dbus, you can run it manually in a terminal to see log information.
$ STREAM_ENGINE_PERSIST=1 ./src/telepathy-stream-engine
Telepathy clients
Empathy
SVN: svn co svn://svn.gnome.org/svn/empathy/trunk empathy
Git: git clone git://git.collabora.co.uk/git/empathy.git
Dependencies: libmissioncontrol
See http://live.gnome.org/Empathy for more.
Debugging
See Debugging.