Public | Automated Build

Last pushed: 9 months ago
Short Description
My bitlbee setup (with facebook and hangouts)
Full Description


Logging in

To run bitlbee:

  • docker run -d -p 6667:6667 -v $HOME/.bitlbee/:/var/lib/bitlbee/ jwinder/docker-bitlbee

Then connect to localhost:6667 with an irc client and switch to the &bitlbee channel. This is the control channel where you will interact with bitlbee.

Make up some random password. To login for the first time (without the brackets):

  • register <some-password>

All following times:

  • identify <some-password>

Common commands

  • help and help commands display useful commands listings
  • account list displays all registered accounts (can be shortened, e.g. acc li)
  • blist or /names displays all contacts (can be shortened e.g. bli)
  • plugins for a list of supported protocols
  • help purple for a list of libpurple supported protocols
  • save to save the current configuration (sometimes after adding/changing accounts, it doesn't save right away)
  • account <name> set tag <new-name> renames an account
  • account <name> set auto_connect off to turn off autoconnect for a specific account on login
  • chan &bitlbee set show_users online+,away+,offline to show more than online contacts for /names


You can private message a nick /msg <nick> <msg> from the control channel. Within reason, you can invite others to these rooms as well, creating a group chat: /invite <nick>.

You can also talk to a nick directly in the control channel. Type a contact's name and direct a message to them just like any irc channel with multiple people: <nick>: <msg>. Their response will be in the control channel.


  • account add twitter <username>
  • account twitter on

Bitlbee will open a private chat with you, sending a twitter link to follow for authorizing bitlbee. Accept the terms, then twitter will display a code. Reply with this code in the private chat. Bitlbee will now be authorized to use twitter. Don't forget to save.

Bitlbee will automatically open a private irc channel to the twitter contact containing recent tweets in your feed.

Sending a message to the twitter contact in the control channel as well as inside of the private twitter irc channel will both post tweets, so be careful.

Sending a private message to a twitter user via /msg <nick> <msg> will send that user a twitter DM, not a tweet.


Create an app password for bitlbee here.

  • account add facebook <email> <app-password>
  • account facebook on
  • save

Google Hangouts

  • account add hangouts <email>
  • account hangouts set nick_format %full_name
  • account hangouts on

Bitlbee will open a private chat with you, sending instructions for retrieving an oauth token from google. The gist is: if you are already logged into google, go here. Inspect the cookies for an oauth_token cookie. Reply with the value of this cookie in the private chat. Bitlbee will now be configured to use hangouts.

Don't forget to save.

Docker Pull Command
Source Repository

Comments (0)