开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

Mastodon plugin for Bitlbee

This plugin allows Bitlbee 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 Bitlbee 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.

Please report issues using the Software Wiki. For questions, ping kensanata on irc.oftc.net/#bitlbee.

Table of Contents

• License
• Usage
• Build dependencies
• Building and Installing
• Bugs
• Debugging

License

Most of the source code is distributed under the GNU Lesser Public License 2.1.

The build system is distributed under the GNU Public License 2.0 or any later version.

Anything without an obvious license in the file header also uses the GPL 2.0 or any later version.

Contributors

• velartrill lexi@hale.su

Usage

First, make sure the installation worked by checking the installed protocols using the plugins command in your &bitlbee control channel.

If this worked, create your account using the account command in your &bitlbee control channel.

In this example, we'll sign in as @kensanata@mastodon.weaponvsac.space. This assumes an existing account on an instance! Replace username and Mastodon server when trying it.

In your &bitlbee channel, add a new account, change it's base_url to point at your instance, and switch it on:

<kensanata> account add mastodon @kensanata
<root> Account successfully added with tag mastodon
<kensanata> account mastodon set base_url https://mastodon.weaponvsac.space
<root> base_url = `https://mastodon.weaponvsac.space
<kensanata> account mastodon on
<root> mastodon - Logging in: Login
<root> mastodon - Logging in: Parsing application registration response
<root> mastodon - Logging in: Starting OAuth authentication

At this point, you'll get contacted by the user mastodon_oauth with a big URL that you need to visit using a browser. Visit the URL and authenticate the client. You'll get back another very long string. Copy and paste this string:

<mastodon_oauth> Open this URL in your browser to authenticate: https://.......
<mastodon_oauth> Respond to this message with the returned authorization token.
<kensanata> ****************************************************************

Once you do that, your login should complete in the &bitlbee channel:

<root> mastodon2 - Logging in: Requesting OAuth access token
<root> mastodon2 - Logging in: Connecting
<root> mastodon2 - Logging in: Verifying credentials
<root> mastodon2 - Logging in: Getting home timeline
<root> mastodon2 - Logging in: Logged in

You should now have a channel called #mastodon.weaponsvsac.space@localhost where all the status updates and notifications get shown. We'll call this your account channel. See help set name to change it's name.

Mastodon gives BitlBee a permanent authentication token, which is saved in your configuration.

You should probably save this configuration.

<kensanata> save
<root> Configuration saved

Adding the account and switching it on loads the Bitlbee Mastodon help file into the system, allowing you to use help mastodon in your &bitlbee control channel.

Alternatively, a snapshot of the entries added to the help system by this plugin are available on the help page.

Build dependencies

• bitlbee and headers >= 3.5

  If you haven't built Bitlbee yourself you will need to install the dev package, usually bitlbee-dev or bitlbee-devel. If Bitlbee was built from source don't forget to do make install-dev.

  To NetBSD users: your Bitlbee doesn't include the devel files. One way to fix this is to build Bitlbee via pkgsrc. You'll need to add to the chat/bitlbee pkgsrc Makefile, in the post-build hook, this line:

  cd ${WRKSRC} && ${GMAKE} DESTDIR=${DESTDIR} install-dev
  

  Don't forget to regenerate your PLIST (plugindir is /usr/pkg/lib/bitlbee) with:

  make print-PLIST > PLIST
  

• glib2 and headers => 2.32

  The library itself is usually installed as a dependency of Bitlbee but 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. If you don't have this package, try looking for autoconf and libtool.

  *BSD users should install autoconf, automake and libtool, preferably the latest version available. FreeBSD will also need pkgconfig on top of that. GNU sed (gsed), GNU make (gmake), and the bash shell are also required -- BSD make cannot successfully build bitlbee-mastodon, and the build process uses GNU extensions to both the Bourne shell and sed.

Building and Installing

Check your distribution:

• FreeBSD: irc/bitlbee-mastodon

Alternatively, build it from source. You need to generate the autotools configuration script and related files by executing the following command:

./autogen.sh

After that, you can build as usual:

./configure
make
sudo make install