expandurl-mastodon/README.md

2.1 KiB

expandurl-mastodon is a Mastodon bot that expands shortened URLs.

If you want the bot to expand an URL, reply to the post with the URL in it and mention the bot account (@expandurl@botsin.space for example).

Example screenshot

This bot uses the same visibility as you, but posts unlisted instead of public. It retains the sensitive flag and spoiler warnings.

Some tracking parameters, like those beginning with utm_ are stripped. It also tries to rewrite AMP URLs to point at the real webpages.

Please report any bugs via the issue tracker on GitHub or to @tastytea@soc.ialis.me.

Install

Dependencies

  • Tested OS: Linux
  • C++ compiler (tested: gcc 6.4)
  • cmake (tested: 3.9.6)
  • curlpp (tested: 0.8.1)
  • mastodon-cpp (at least: 0.13.1)
  • jsoncpp (tested: 1.8.4)

Get sourcecode

Development version

git clone https://github.com/tastytea/expandurl-mastodon.git

Compile

mkdir build
cd build/
cmake ..
make

Install with make install.

Usage

The config file has changed from cfg to JSON in 0.4.0.

You will need to generate an access token yourself at the moment. Create a config file with your account and access token in ${HOME}/.config/expandurl-mastodon.json:

{
    "account": "expandurl@example.social",
    "access_tocken": "abc123"
}

Now start expandurl-mastodon without parameters.

Copyright

Copyright © 2018 tastytea <tastytea@tastytea.de>.
License GPLv3: GNU GPL version 3 <https://www.gnu.org/licenses/gpl-3.0.html>.
This program comes with ABSOLUTELY NO WARRANTY. This is free software,
and you are welcome to redistribute it under certain conditions.