In case the title has misled you, this post is completely free from satire, and is literally a step by step guide to trying out Decibel.
1) Decibel has some dependencies. You will need telepathy-qt and tapioca-qt compiled and installed to compile it. Some of the demos we are going to use also require a KDE4 development environment to be up and running.
2) You will need telepathy-qt and tapioca-qt from the tapioca-voip project (the versions in kdesupport are not yet supported by decibel). They can be got from the SVN repository by issuing the following commands:
- svn co https://tapioca-voip.svn.sourceforge.net/svnroot/tapioca-voip/trunk/telepathy-qt
- svn co https://tapioca-voip.svn.sourceforge.net/svnroot/tapioca-voip/trunk/tapioca-qt
Instructions to compile and build them are included in the file README files with each of them.
3) Get and compile decibel. Decibel is located in kdereview at the moment. It can be got by:
- svn co svn://anonsvn.kde.org/home/kde/trunk/kdereview/decibel
Again, compiling instructions are included. Make sure you compile it as you KDE 4 user.
4) Decibel itself cannot communicate with instant messaging networks. To do this, we need telepathy compatible connection managers. For this demo, we will use gabble. Install the gabble package that comes with your distro.
5) Now we need two jabber accounts to test with. Decibel can’t create the accounts on the server yet, so if you don’t already have two jabber accounts, you will need to use kopete (or your favourite instant messaging client) to create them. If you are looking for a jabber server, there is one located at kdetalk.net.
6) Once you have your two jabber accounts, you need to make sure they’re both friends with each other. Then, log in to one with kopete (or your favourite instant messaging client).
7) Now its time to start up Decibel. Open up a konsole and type ‘decibel’. If all has gone according to plan, the daemon will start and you will be presented with a KWallet dialog asking for your KWallet password. Once you have entered that, the decibel daemon should block the konsole (this makes debugging a lot easier than if it forks).
8) Now we need to register the second jabber account with decibel. At the moment, it is done by using one of the demos. Open another konsole and cd to $YOUR_KDE_INSTALL_DIR/lib/Decibel. This is the folder where th demos are stored. If you ‘ls’ in this folder, you should see a series of executable files whose names fit the pattern ‘decibel_*_demo’.
9) We are registering an account with decibel, so the demo we want to use now is ‘decibel_registeraccount_demo’. The command line you type should be the following, replacing email@example.com and yourjabberpass with the appropriate values. The ‘s:’ before the values tells decibel to expect a string.
./decibel_registeraccount_demo account=s:firstname.lastname@example.org decibel_protocol=s:jabber password=s:yourjabberpass
10) Now that your account is registered with decibel, it is time to bring it online. To do this, we use the ‘decibel_setpresence_demo’. It should be called as follows replacing ‘handle’ with the numeric account handle returned by decibel_registeraccount_demo.
./decibel_setpresence_demo handle 2
If that worked correctly, your first jabber account running in your favourite instant messaging client should see your secondary account appear online.
12) The final step is to start a chat with your decibel jabber account from your favourite instant messaging client. If all the above steps have worked correctly, you should see a ugly little GUI pop up, allowing you to continue the conversation.
13) If no GUI appears and decibel spits out errors about .service files, try opening a third konsole and running ‘textchannelgui’ in it. This will register the gui with dbus in case the .service files are installed in the wrong locations.
14) Be warned, decibel is still using a rather old implementation of the telepathy-spec, so don’t expect your chat to work for more than a few messages. We are making rapid progress with getting decibel up to the latest spec, and I will blog again as soon as it is using that.
More information on using the decibel demos can be found on techbase.
If you are having problems, or even better, would like to help out, drop by #decibel and shout. There will often be someone there who can help you out.