Updated Romanian Translation
[empathy.git] / HACKING
1 Empathy is split in different processes:
2 - src/empathy: contact list, considered as the main UI
3 - src/empathy-chat: chat UI
4 - src/empathy-call: call UI
5 - src/empathy-accounts: UI to configure IM accounts
6 - src/empathy-debugger: debug tool
7
8 Each process can be run directly from source without having to be installed to
9 its prefix. You just have to define an appropriate environment using the
10 wrapper found in the tools/ directory.. For example:
11   ./tools/empathy-env ./src/empathy
12
13 The chat and call UI are automatically started by telepathy-mission-control
14 when receiving or requesting a chat/call. In order to use your custom version
15 you have to kill any existing instance of empathy-{chat,call} and then start
16 it with EMPATHY_PERSIST=1 to prevent it from auto exiting if there is no
17 channel to handle. For example:
18   EMPATHY_PERSIST=1 ./tools/empathy-env ./src/empathy-chat
19
20 Debugging can be turned on using EMPATHY_DEBUG=all and logged to a file
21 with EMPATHY_LOGFILE=/tmp/empathy.log
22
23 Sometimes you may want to load the locally compiled version of some GStreamer
24 plugin (e.g. Farstream) instead of the system installed one. To do so, just
25 set the GST_PLUGIN_PATH environment variable to tell GStreamer where your
26 plugins are located and the GST_PLUGIN_LOADING_WHITELIST to avoid conflicts
27 with system installed plugins. It's also a good idea to use GST_REGISTRY to
28 avoid clobbering your default GStreamer registry. For example you can
29 export these before launching the empathy processes as shown above:
30   export GST_PLUGIN_LOADING_WHITELIST=gstreamer:gst-plugins-base:gst-plugins-good:libnice:farstream:gst-plugins-bad:gst-plugins-ugly:gst-ffmpeg
31   export GST_PLUGIN_PATH=/path/to/your/custom/lib/gstreamer-0.10
32   export GST_REGISTRY=/tmp/gstreamer.registry
33
34 See http://live.gnome.org/Empathy/ about coding style conventions.
35 See also http://live.gnome.org/Empathy/Git to read about our git workflow.