Mastodon plugin for Bitlbee
This plugin allows Bitblee to communicate with Mastodon instances. Mastodon is a free, open-source, decentralized microblogging network. Bitlbee is an IRC server connecting to various other text messaging services. You run Bitlbee and connect to it using an IRC client, then configure Bitblee to connect to other services, such as a Mastodon instance where you already have an account. The benefit is that you can now use any IRC client you want to connect to Mastodon.
This plugin is distributed under the GPLv2 license.
Usage
Please refer to the Bitlbee help system:
> help mastodon
Build dependencies
-
bitlbee
and headers >= 3.5If using distribution version of Bitlbee you will need to install the dev package, usually
bitlbee-dev
orbitlbee-devel
. If Bitlbee was built from source don't forget to domake install-dev
. -
glib2
and headers => 2.32The library itself is usually installed as a dependency of Bitlbee, headers need to be installed separately. In Debian, the package containing them is libglib2.0-dev.
-
autotools
(if building from git)A bit of an overkill, but it works.
Building and Installing
If building from git you will first need to generate autotools configuration script and related files by executing the following command:
$ ./autogen.sh
After that (or when building from a tarball) you can build as usual:
$ ./configure
$ make
$ sudo make install
If your Bitlbee's plugindir is in non-standard location you can specify it by
calling ./configure with --with-plugindir=/path/to/plugindir
option.
Debugging
You can enable extra debug output for bitlbee-mastodon
, by setting the
BITLBEE_DEBUG
environment variable. This will print all traffic it exchanges
with Mastodon servers to STDOUT and there is a lot of it. To get it on your
screen run bitlbee
by hand in foreground mode:
$ BITLBEE_DEBUG=1 bitlbee -nvD
Then connect with an IRC client as you usually do.
WARNING: there is sensitive information in this debug output, such as auth tokens, your plaintext password and, obviously, your incoming and outgoing messages. Be sure to remove any information you are not willing to share before posting it anywhere.
If you are experiencing crashes please refer to debugging crashes for information on how to get a meaningful backtrace.
Bugs
Please report issues using the GitHub tracker. For questions, ping kensanata on irc.oftc.net/#bitlbee.