Difference between revisions of "Bitlbee"
(→How to connect to Jabber using your Gmail account)
m (Moved to category "internet applications", also fixed internationalization link)
|Line 1:||Line 1:|
= About =
= About =
Revision as of 11:11, 10 April 2011
Bitlbee is a "console-based IRC to IM chatting gateway, including ICQ/MSN/Jabber". Basically, it allows the user to interact with popular chat networks (ICQ, MSN, Jabber, AIM, YIM) within their IRC client.
The users' buddies appear as normal IRC users in a channel and conversations use the private message facility of IRC.
First, download and install the package using pacman:
# pacman -S bitlbee
Bitlbee can now run as a daemon of its own! Open up Template:Filename to browse through the settings. Uncomment the Runmode line and change it to the following.
RunMode = ForkDaemon
There is no need to run the bitlbee daemon as root so we should uncomment the following line so it can run as the "bitlbee" user created when the package was installed.
User = bitlbee
to start the Bitlbee server. Of course, add bitlbee to your DAEMONS array in Template:Filename to start the server on boot. Note that just starting the server does not log you in to any of your messenger accounts! You must join a channel and issue commands.
You may also start bitlbee every time Arch Linux boots. To do so, just add the bitlbee entry in the file rc.conf as follows:
DAEMONS=(... alsa cups bitlbee ...)
(The three dots mean other daemons that run during bootup)
You are now able to connect to this in an IRC client. To connect, just connect to localhost using your favorite IRC client.
Hopefully this will connect and you should immediately join a channel called '&bitlbee'. When you join this channel it will tell to type 'Help' if you're new... type 'Help' ;)
Read through the help offered by Bitlbee to get started. There are some great guides online too:
How to connect to Jabber using your Gmail account
In your control channel, do the following:
account add jabber email@example.com mypasswd
After root responds with "Account successfully added", you can check your accounts with "account list".
<@user> account list <@root> 0. JABBER, firstname.lastname@example.org (connected) <@root> End of account list
Set the server value of your gmail account:
account 0 set server talk.google.com
After you have added the account, type "account 0 on" and it should log in:
<@user> account 0 on <@root> JABBER(email@example.com) - Logging in: Connecting <@root> JABBER(firstname.lastname@example.org) - Logging in: Connected <@root> JABBER(email@example.com) - Logging in: Requesting Authentication Method <@root> JABBER(firstname.lastname@example.org) - Logging in: Authenticating <@root> JABBER(email@example.com) - Logged in
If you get errors like the following:
<@user> account 0 on <@root> JABBER(firstname.lastname@example.org) - Logging in: Connecting <@root> JABBER(email@example.com) - Logging in: Connected <@root> JABBER(firstname.lastname@example.org) - Logging in: Requesting Authentication Method <@root> JABBER(email@example.com) - Logging in: Authenticating <@root> JABBER(firstname.lastname@example.org) - Login error: Error 403: Unknown error <@root> JABBER(email@example.com) - Signing off...
Switching the domain from "gmail.com" to "googlemail.com" may help. This seems to be the case for some European countries, especially Germany where Google doesn't own the trademark for the name Gmail .
The easiest way to change your account settings is to simply delete the account you created and add it again.
account 0 del account add jabber firstname.lastname@example.org mypasswd
or just use the `set` switch for the `account` command
account list # find the id for your gtalk account, in this case I'll use '0' account 0 set # list all the possible settings for this account account 0 set username email@example.com # change your username account 0 set password somethingverysecret # change your passphrase
Gmail uses ssl/tls (ie the url is https://mail.google.com/mail/) so you can enable it for some extra security. You'll need to change the connection port too. To do that, you'll need to be disconnected from that account.
<@user> account 0 off <@root> jabber - Signing off.. <@user> account 0 set ssl true <@root> ssl = `true' <@user> account 0 set port 5223 <@root> port = `5223'
Even if you dont do that the stream should change automatically
<@user> account 0 on <@root> jabber - Logging in: Connecting <@root> jabber - Logging in: Connected to server, logging in <@root> jabber - Logging in: Converting stream to TLS ...