Bitlbee
From LinuxReviews
BitlBee is a IRC gateway program for MSN, ICQ, AIM, Jabber and Google Talk. It acts as a IRC server, creates a IRC "channel" with all your contacts and allows you to talk to them as if they were normal IRC users. It's also possible combine BitlBee with web browser IRC clients such as cgi-irc.
Contents |
[edit] How it works
BitlBee is "An IRC to other chat networks gateway". (manual page)
The BitlBee daemon is capable of connecting to the IM networks AIM, ICQ, Jabber, MSN and YIM.
Your irc client connects to BitlBee like any other irc server, and after telling it about your accounts and passwords it creates a normal irc channel with all your IM contacts listed as regular irc users - and you can talk to them as if they were normal irc users.
If you do not want to run your own BitlBee server you can use one of the free public servers available.
[edit] Public Bitlbee Servers
The official server list is here: Public BitlBee servers
- im.bitlbee.org:6667
- testing.bitlbee.org:6667
- im.sixxs.net (IPv4 + IPv6, Web + Port 6667)
- im.rootdir.de:6668
- im.uk.bitlbee.org:6667
- im.us.bitlbee.org:6667
- irc.net:6667
- im.starkast.net:6668
- bitlbee.hensema.net:6667
- bitlbee.extreme-players.de:6667
- irc2im.picasa.hu:6667
- im.sixxs.net:6667 (ipv6 ready)
- segfault.kernel-oops.de:7777
- im.rondom.org:7070
- bitlbee.ath.cx:8888
- im.okkernoot.net:6667
- im.everdot.org:6667 (ipv6 ready)
- bitlbee.geeknet.fr:6667
- im.bulix.org:6668
- orb.zapto.org:6667
[edit] Tor Bitlbee Servers
These are location hidden Tor-services.
- 2uqqegdqdrw2mlit.onion:6667
- zvv4lqu37sbndsao.onion:6667
[edit] It must be noted that...
BitlBee is open source. It uses plaintext for the IM-protocols. It all too easy for a BitlBee operator to log conversations. It must also be mentioned that it is quite easy to modify the source so the BitlBee program spits out the username and passwords of all it's users.
That being said: It's probably safe to use most public BitlBee servers. But using them does involve a security risk, where as running your own BitlBee server does not.
[edit] Getting started
If you choose to connect to a public server then all you have to do is connect using any IRC client. Then join the control channel #bitlbee and read the help text.
/connect im.bitlbee.org /j #bitlbee help commands help quickstart help quickstart1 help quickstart2 help quickstart3
The command help quickstart will give you instructions on how to add IM accounts and use BitlBee, help commands will give a list of available commands.
First register your irc-nick with a password.
register kafjdg873h
An account is made using your current irc nick as identification with the password kafjdg873h. The password will only work when used together with the nick you had when you registered.
The next time you visit the server you can load your settings with
identify kafjdg873h
Your current user accounts on the various IM networks are registered with the account command (try help account for details).
- Jabber: account add jabber username@jabber.org yourpassword
- MSN: account add msn username@hotmail.com yourpassword
- ICQ: account add oscar 648244897 yourpassword login.icq.com
- AIM: account add oscar 321454897 yourpassword login.oscar.aol.com
- YIM: account add yahoo username yourpassword
- GMAIL account add jabber username@gmail.com youpassword talk.google.com:5223:ssl
Use account list to view what accounts are saved and their status.
To log into all your im servers type
account on
Type account list then use the number given to the service to delete an account. Example:
account del 1
[edit] Configuration
To view what configuration options you have, type set:
set auto_connect = ``true' private = ``false' debug = ``false' to_char = ``: ' ops = ``both' html = ``nostrip' typing_notice = ``false' away_devoice = ``true' charset = ``none' handle_unknown = ``root' auto_reconnect = ``false' reconnect_delay = ``300' save_on_quit = ``true'
Change the character setting to get any local characters to appear as they should. For Norwegian øæå ØÆÅ set the charset to ISO8859-1
set charset ISO8859-1
Use the program iconv to get a list of charsets available. Run it in a terminal (not in your irc client):
iconv -l
You probably want to remove HTML from AIM and other users of "fancy" clients:
set strip_html true
Check Bitlbees help for more info.
help set charset
Other settings you probably want:
set auto_connect true set auto_reconnect true set save_on_quit true
Remember to save your settings (if save_on_quit is set to false)!
save
[edit] How to run your own server
Get BitlBee version >= 1.0.3.
On Gentoo Linux: ACCEPT_KEYWORDS="~x86" USE="jabber msn oscar yahoo -debug" emerge bitlbee
Bitlbee can be started as a separate daemon or be loaded by xinetd or inetd. Use daemon mode only if you will be the only one using it, use inetd or xinetd if the server will be used by more than one user!
To get a publicly available bitlbee server up and running (using xinetd):
- Install BitlBee (emerge bitlbee or rpm -ivh bitlbee.rpm or apt-get install bitlbee)
- Open port 6667 in your firewall
- Comment # out disable = no and only_from = localhost in the file /etc/xinetd.d/bitlbee
- Add bitlbee: ALL to /etc/hosts.allow
Set only_from in /etc/xinetd.d/bitlbee and bitlbee: in /etc/hosts.allow to your LAN or whatever to restrict access to the service - or simply block 6667 with your firewall.
You will probably want to edit:
- /etc/bitlbee/bitlbee.conf
- /etc/bitlbee/motd.txt
- /etc/xinetd.d/bitlbee
[edit] xinetd
Bitlbee can be used as a stand-alone server or be called using xinetd (manual). You should call it using xinetd, daemon mode only allows one user. Make sure you have configured xinetd correctly and make sure Bitlbee is not disabled (default on Gentoo and other systems) with a line saying
disable = yes
in the file /etc/xinetd.d/bitlbee. You must (re)start xinetd when you are finished configuring it (/etc/init.d/xinetd restart).
To check the authors bitlbee server, start your favorite irc client and:
/connect im.everdot.org
This server is compiled with support for jabber, msn, oscar and yahoo.
[edit] What version should I use?
You can find the latest stable version of Bitlbee on the download page.
The developers are also releasing development snapshots quite frequently, brave and experienced users are encouraged to use these and reports bugs. You should compile with debugging symbols (+debug) if you choose to use the snapshot releases.
Production systems and public servers should use the latest stable release.
[edit] xinetd and ipv6
If you want bitlbee to answer IPv6 connections using xinetd you need to add
flags = IPv6
to the configuration file (and to all other xinetd services you want IPv6 enabled for that matter)
/etc/xinetd.d/bitlbee
Example:
service ircd
{
flags = IPv6
socket_type = stream
protocol = tcp
wait = no
user = nobody
server = /usr/sbin/bitlbee
port = 6667
disable = no
}
[edit] How to talk to your IM friends from a web page
It is very easy to allow users to talk to IM friends from a web page if you already have Bitlbee and a (Apache) web server up and running. Install cgiirc, a Perl/CGI program that lets you use IRC servers from a web browser. Installing it is very straight forward. It can be used to make a chat-room for a website, and more importantly, allow web users to access your Bitlbee server.
Web servers you can use freely:
- im.sixxs.net IPv4 and IPv6
- everdot.org (CGI:IRC, Sweden, IPv6)
- cgi.bitlbee.org
[edit] Support and worshiping
You may thank the kind developers who made Bitlbee on the IRC channel #bitlbee on the IRC network OFTC (irc.oftc.org). You can also request features and ask well-formulated thought-through questions on this channel.
[edit] External links
- BitlBee Homepage
- Perl scripts for BitlBee and Irssi by Tijmen Ruizendaal I'm a huge fan of BitlBee and Irssi. therefore I wrote some Irssi-scripts for BitlBee to improve the ease of use, says Tijmen.
- Official server list: Public BitlBee servers
