A Mastodon bot that expands shortened URLs.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

README.md 2.8KB

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 schlomp.space or to @tastytea@soc.ialis.me.

Install

Dependencies

Get sourcecode

Latest release

https://schlomp.space/tastytea/expandurl-mastodon/releases

Development version

git clone https://schlomp.space/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.

Start expandurl-mastodon without parameters.

If no config file is found, you will be asked to provide your account address and an access token is generated. The config file can be found in ${HOME}/.config/expandurl-mastodon.json and looks like this:

{
    "account": "expandurl@example.social",
    "access_token": "abc123",
    "proxy":
    {
        "url": "socks5h://[::1]:1080/",
        "user": "user23",
        "password": "supersecure"
    },
    "replace" :
    {
            "//amp\\." : "//",
            "[\\?&]__twitter_impression=[^&]+" : "",
            "[\\?&]utm_[^&]+" : "",
            "[\\?&]wt_zmc=[^&]+" : "",
            "[\\?&]wtmc=[^&]+" : ""
    }
}

If you want to use a proxy or define your own replacements, you have to edit the configuration file manually. After the configuration file is generated, you can start expandurl-mastodon as daemon.

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.