Difference between revisions of "Bitlbee"

From ArchWiki
Jump to: navigation, search
(Bitlbee comes with a nice build-in setup instructions tutorial.)
m (Remove specific code showing how to enable a systemd service (Help:Style#systemd_units_operations))
Line 30: Line 30:
{{bc|# chown -R bitlbee:bitlbee /var/lib/bitlbee}}
{{bc|# chown -R bitlbee:bitlbee /var/lib/bitlbee}}
Then start the {{ic|bitlbee}} daemon.
Then [[start]] the {{ic|bitlbee}} daemon. You can also [[enable]] the {{ic|bitlbee}} daemon to run on startup.
# systemctl start bitlbee
You can also enable the {{ic|bitlbee}} daemon to run on startup like so:
# systemctl enable bitlbee
(Note: just starting the server does not log you into any of your chat accounts)
(Note: just starting the server does not log you into any of your chat accounts)

Revision as of 01:38, 16 June 2015

Bitlbee is a "console-based IRC to IM chatting gateway, including ICQ/MSN/Jabber". It allows the user to interact with popular chat networks XMPP/Jabber, MSN Messenger, Yahoo! Messenger, AIM and ICQ, the Twitter microblogging network (plus all other Twitter API compatible services like identi.ca and status.net), and social networking chat networks like Facebook and StudiVZ within their IRC client.

The users' buddies appear as normal IRC users in a channel and conversations use the private message facility of IRC.


Install bitlbee, available in the Official repositories. Alternatively, install the development version, bitlbee-bzrAUR, available in the Arch User Repository.


Various settings can be set using the /etc/bitlbee/bitlbee.conf configuration file.


To run Bitlbee as a daemon uncomment the Runmode line and change it to the following.

RunMode = ForkDaemon

It is recommended to run the Bitlbee daemon without root permission. Uncomment the following line so Bitlbee can run as the "bitlbee" user, which was created when the package was installed.

User = bitlbee

For daemon mode uncomment the following lines.

DaemonInterface =
DaemonPort = 6667

For protocol restrictions set the allowed ones in line

Protocols = jabber yahoo

Ensure that the configuration directory is writeable with the user you configured:

# chown -R bitlbee:bitlbee /var/lib/bitlbee

Then start the bitlbee daemon. You can also enable the bitlbee daemon to run on startup.

(Note: just starting the server does not log you into any of your chat accounts)

Basic Usage (Jabber/XMPP)

Once Bitlbee is running connect to localhost using an IRC client. The control channel, &bitlbee, should already show you some basic information (if not, join it now). You can always type help to get help.

While in the control channel, enter

help quickstart

and follow the instructions

Your friend might be requesting authorization to add you back, so just reply according to the control channel prompts.

To initiate a chat, simply open a new IRC private window:

/msg friend hello!


For OTR support you must have libotr installed. Upon account registration, bitlbee will generate your OTR keys, and it will use them transparently whenever you are negotiating with an OTR-capable contact.

External Services


In the control channel, &bitlbee, type the following commands:

11:45:03 <@user> account add twitter <handle>
11:45:03 <@root> Account successfully added
11:45:06 <@user> account on
11:45:06 <@root> Trying to get all accounts connected...
11:45:06 <@root> twitter - Logging in: Requesting OAuth request token

In a private channel, twitter_handle, you'll receive:

11:45:07 <twitter_handle> To finish OAuth authentication, please visit http://api.twitter.com/oauth/authorize?oauth_token=xxxxxxxxx and respond with the resulting PIN code.

Click the link and authorize the BitlBee app on Twitter. You should now see:

11:59:54 <@root> twitter - Logging in: Connecting to Twitter
11:59:55 <@root> twitter - Logging in: Logged in

See Also