Need help with bitlbee-steam?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

126 Stars 11 Forks GNU General Public License v2.0 367 Commits 16 Opened issues


Steam protocol plugin for BitlBee

Services available


Need anything else?

Contributors list

The Steam protocol plugin for bitlbee. This plugin uses the Steam Mobile API allowing it to run alongside the main Steam client. It is worth noting that the Steam Mobile API is HTTP based, which does lead to mild latency.

Package Repositories

There are package repositories available for various distributions.


Building and Installing

Make sure bitlbee and its headers have been installed. If bitlbee came from the distribution's repository, it will most likely need the development package, usually bitlbee-dev.

If bitlbee was built by hand (or alike via a script), ensure the make target

is invoked. This target is not called by default, and will install the headers that are needed.

Do not use the source tree headers unless you know what you are doing. This can lead to mismatched header versions, which often times will lead to bad things.

$ git clone
$ cd bitlbee-steam

With a "global" (or system) bitlbee installation:

$ ./
$ make
$ make install

Or with a "local" bitlbee installation (location: $HOME/bitlbee):

$ export BITLBEE_CFLAGS="-I$HOME/bitlbee/include/bitlbee"
$ export BITLBEE_LIBS=""
$ ./ --libdir=$HOME/bitlbee/lib
$ make
$ make install


Before continuing, please note, any account which is a "Limited User Account" will not work with this plugin. These limited accounts have many features negated from them, which are required for this plugin to function correctly as a chat client. Please, do not file issues in the tracker if your account is a limited account.


Getting started:

> account add steam  
> account steam on

Authenticating with SteamGuard:

> account steam set authcode 

Captcha interaction may be required:

> account steam set captcha 

Output game play statues to the account channel(s):

> account steam set game_status true

Common Issues

Below is a list of common issues and their respective fixes.

Expired token or session

When the token or session identifier has expired, the user may see errors thrown by the plugin. Sometimes these errors are one time, but if they repeatedly and reliably happen, then a new token and session identifier need to be obtained.

Login error: HTTP: 401 Unauthorized

Fixing this issue is done by forcing the plugin to re-authenticate:

account steam off
account steam set -del token
account steam on

The account can also be deleted and re-added, but this will cause all other local metadata to be lost, such as local buddy aliases.


One of the two supported environment variables can be defined to enable debugging output. This can be used in unison with debuggers such as GDB, which should enable easier tracing of bugs.

When posting to the issue tracker, please ensure any sensitive information has been stripped.

For bitlbee and the plugin:

$ export BITLBEE_DEBUG=1
$ BITLBEE_DEBUG=1 gdb ...

For just the plugin:


Obtaining a GDB backtrace:

$ gdb \
    -ex 'handle SIGPIPE nostop noprint pass' \
    -ex 'break g_log' -ex run -ex bt \
    --args /usr/sbin/bitlbee -Dnvc /etc/bitlbee/bitlbee.conf

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.