Facebook protocol plugin for BitlBee
Clone or download
dequis Load is_work through FbData, fixes api key issues after the first login.
I have no idea what request after login requires api keys, though.
This plugin signs all post-login requests pointlessly.
Latest commit 553593d Oct 17, 2017


The Facebook protocol plugin for bitlbee. This plugin uses the Facebook Messenger MQTT-based protocol.

This project is not affiliated with Facebook, Inc.


General usage instructions are available in the bitlbee wiki:


Installing from APT repo

An APT repo for several recent debian/ubuntu versions is available here:


Building from source

The folowing packages are required: autoconf, automake, libtool, glib2, json-glib, bitlbee (names may vary across distros)

Example for debian-based systems:

apt install build-essential autoconf automake libtool libglib2.0-dev libjson-glib-dev bitlbee-dev

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, like bitlbee-dev in the example above.

If bitlbee was built by hand (or alike via a script), ensure the make target install-dev is invoked. This target is not called by default, and will install the headers that are needed.

$ git clone https://github.com/bitlbee/bitlbee-facebook.git
$ cd bitlbee-facebook

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

$ ./autogen.sh
$ make
$ make install

Otherwise, before running those commands, set PKG_CONFIG_PATH to the path to the bitlbee.pc file. For example:

$ export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig/


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