Difference between revisions of "Bitlbee"

From ArchWiki
Jump to: navigation, search
(Setup: -)
(How to connect to Jabber using your Gmail account: External links, improve clarity, simplify text)
Line 47: Line 47:
  
 
= How to connect to Jabber using your Gmail account =
 
= How to connect to Jabber using your Gmail account =
In your control channel, do the following:
+
In the control channel, <tt>&bitlbee</tt>, issue the following command after replacing <tt><username></tt> and <tt><password></tt> with your information:
  account add jabber username@gmail.com mypasswd
+
  <@user> account add jabber <username>@gmail.com <password> talk.google.com:5223:ssl
 +
Appending the command with <tt>talk.google.com:5223:ssl</tt> is not strictly necessary, but it is recommended to enable extra security.
  
After root responds with "Account successfully added", you can check your accounts with "account list".
+
If you have enabled [http://code.google.com/p/google-authenticator/ Google Authenticator] make sure to create an application specific password (see: [http://www.google.com/support/accounts/bin/static.py?page=guide.cs&guide=1056283&topic=1056286 Google Accounts Help]).
  
 +
To verify that the account was added check the account list:
 
  <@user> account list  
 
  <@user> account list  
 
  <@root> 0. JABBER, username@gmail.com (connected)  
 
  <@root> 0. JABBER, username@gmail.com (connected)  
 
  <@root> End of account list
 
  <@root> End of account list
  
Set the server value of your gmail account:
+
You can change the server value of your gmail account with the following command:
 
  account 0 set server talk.google.com
 
  account 0 set server talk.google.com
  
After you have added the account, type "account 0 on" and it should log in:
+
To log into your Google account issue the following:
 
+
 
  <@user> account 0 on
 
  <@user> account 0 on
 
  <@root> JABBER(username@gmail.com) - Logging in: Connecting  
 
  <@root> JABBER(username@gmail.com) - Logging in: Connecting  
Line 68: Line 69:
 
  <@root> JABBER(username@gmail.com) - Logged in
 
  <@root> JABBER(username@gmail.com) - Logged in
  
If you get errors like the following:
+
=== Troubleshooting ===
  
 +
If you get errors like the following:
 
  <@user> account 0 on  
 
  <@user> account 0 on  
 
  <@root> JABBER(username@gmail.com) - Logging in: Connecting
 
  <@root> JABBER(username@gmail.com) - Logging in: Connecting
Line 78: Line 80:
 
  <@root> JABBER(username@gmail.com) - Signing off...
 
  <@root> JABBER(username@gmail.com) - Signing off...
  
Switching the domain from "gmail.com" to "googlemail.com" may help.
+
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'' [http://www.theregister.co.uk/2007/01/31/google_looses_trademark_battle/].
This seems to be the case for some European countries, especially Germany where Google doesn't own the trademark for the name ''Gmail'' [http://www.theregister.co.uk/2007/01/31/google_looses_trademark_battle/].
+
  
 
The easiest way to change your account settings is to simply delete the account you created  and add it again.
 
The easiest way to change your account settings is to simply delete the account you created  and add it again.
Line 90: Line 91:
 
  account 0 set password somethingverysecret  # change your passphrase
 
  account 0 set password somethingverysecret  # change your passphrase
  
----
+
=== External Links ===
 
+
*[http://thinkhole.org/wp/2006/09/20/howto-connect-to-google-talk-with-bitlbee/ HOWTO: Connect to Google Talk with Bitlbee] at Thinkhole Labs
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.
+
*[http://wiki.bitlbee.org/GtalkEvilness Using Google Talk with a non-GMail address] on the Bitlbee Wiki
<@user> account 0 off
+
*[http://wiki.bitlbee.org/GoogleApps Using Google Talk with a Google Apps for Domains Address] on the Bitlbee Wiki
<@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
+
...
+
  
 
= See Also =
 
= See Also =
 
[[Screen Irssi Bitlbee]]
 
[[Screen Irssi Bitlbee]]

Revision as of 21:21, 5 August 2011

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

About

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.


Setup

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

Now run

/etc/rc.d/bitlbee start

to start the Bitlbee server. 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=(... bitlbee ...)

(The three dots mean other daemons that run during bootup)

Configuration

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:

http://quark.humbug.org.au/publications/internet/bitlbee.pdf

http://princessleia.com/bitlbee.php

How to connect to Jabber using your Gmail account

In the control channel, &bitlbee, issue the following command after replacing <username> and <password> with your information:

<@user> account add jabber <username>@gmail.com <password> talk.google.com:5223:ssl

Appending the command with talk.google.com:5223:ssl is not strictly necessary, but it is recommended to enable extra security.

If you have enabled Google Authenticator make sure to create an application specific password (see: Google Accounts Help).

To verify that the account was added check the account list:

<@user> account list 
<@root> 0. JABBER, username@gmail.com (connected) 
<@root> End of account list

You can change the server value of your gmail account with the following command:

account 0 set server talk.google.com

To log into your Google account issue the following:

<@user> account 0 on
<@root> JABBER(username@gmail.com) - Logging in: Connecting 
<@root> JABBER(username@gmail.com) - Logging in: Connected 
<@root> JABBER(username@gmail.com) - Logging in: Requesting Authentication Method
<@root> JABBER(username@gmail.com) - Logging in: Authenticating 
<@root> JABBER(username@gmail.com) - Logged in

Troubleshooting

If you get errors like the following:

<@user> account 0 on 
<@root> JABBER(username@gmail.com) - Logging in: Connecting
<@root> JABBER(username@gmail.com) - Logging in: Connected
<@root> JABBER(username@gmail.com) - Logging in: Requesting Authentication Method
<@root> JABBER(username@gmail.com) - Logging in: Authenticating
<@root> JABBER(username@gmail.com) - Login error: Error 403: Unknown error
<@root> JABBER(username@gmail.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 [1].

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 username@googlemail.com 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 foo@gmail.com        # change your username
account 0 set password somethingverysecret  # change your passphrase

External Links

See Also

Screen Irssi Bitlbee