2018-05-12 02:30:57 +02:00
|
|
|
**expandurl-mastodon** is a Mastodon bot that expands shortened URLs.
|
2018-05-11 02:21:44 +02:00
|
|
|
|
2018-05-11 06:57:41 +02:00
|
|
|
If you want the bot to expand an URL, reply to the post with the URL in it and
|
2018-05-11 07:33:23 +02:00
|
|
|
mention the bot account (`@expandurl@botsin.space` for example).
|
|
|
|
|
2018-06-08 00:12:21 +02:00
|
|
|
![Example screenshot](https://doc.schlomp.space/expandurl-mastodon/expandurl_screenshot.jpg)
|
2018-05-13 06:11:47 +02:00
|
|
|
|
2018-05-11 07:33:23 +02:00
|
|
|
This bot uses the same visibility as you, but posts unlisted instead of public.
|
|
|
|
It retains the sensitive flag and spoiler warnings.
|
|
|
|
|
2018-05-20 18:31:27 +02:00
|
|
|
Some tracking parameters, like those beginning with
|
|
|
|
[utm_](https://en.wikipedia.org/wiki/UTM_parameters) are stripped. It also tries
|
|
|
|
to rewrite [AMP](https://en.wikipedia.org/wiki/Accelerated_Mobile_Pages) URLs to
|
|
|
|
point at the real webpages.
|
|
|
|
|
2018-05-11 07:33:23 +02:00
|
|
|
Please report any bugs via the
|
2018-06-04 21:04:38 +02:00
|
|
|
[issue tracker on schlomp.space](https://schlomp.space/tastytea/expandurl-mastodon/issues)
|
2018-05-11 07:33:23 +02:00
|
|
|
or to [@tastytea@soc.ialis.me](https://soc.ialis.me/@tastytea).
|
2018-05-11 02:21:44 +02:00
|
|
|
|
|
|
|
# Install
|
|
|
|
|
|
|
|
## Dependencies
|
|
|
|
|
|
|
|
* Tested OS: Linux
|
2018-06-21 14:10:43 +02:00
|
|
|
* C++ compiler (tested: gcc 6.3 / 7.3)
|
|
|
|
* [cmake](https://cmake.org/) (tested: 3.9 / 3.11)
|
2018-06-13 05:28:42 +02:00
|
|
|
* [curlpp](http://www.curlpp.org/) (tested: 0.8 / 0.7)
|
2018-08-14 15:46:31 +02:00
|
|
|
* [mastodon-cpp](https://schlomp.space/tastytea/mastodon-cpp) (at least: 0.18)
|
2018-06-13 05:28:42 +02:00
|
|
|
* [jsoncpp](https://github.com/open-source-parsers/jsoncpp) (tested: 1.8 / 1.7)
|
|
|
|
* [libxdg-basedir](http://repo.or.cz/w/libxdg-basedir.git) (tested: 1.2)
|
2018-05-11 02:21:44 +02:00
|
|
|
|
|
|
|
## Get sourcecode
|
|
|
|
|
2018-05-21 13:05:59 +02:00
|
|
|
### Latest release
|
|
|
|
|
2018-06-04 21:04:38 +02:00
|
|
|
https://schlomp.space/tastytea/expandurl-mastodon/releases
|
2018-05-21 13:05:59 +02:00
|
|
|
|
2018-05-11 02:21:44 +02:00
|
|
|
### Development version
|
|
|
|
|
2018-06-08 00:12:21 +02:00
|
|
|
```SH
|
|
|
|
git clone https://schlomp.space/tastytea/expandurl-mastodon.git
|
|
|
|
```
|
2018-05-11 02:21:44 +02:00
|
|
|
|
|
|
|
## Compile
|
|
|
|
|
2018-06-08 00:12:21 +02:00
|
|
|
```SH
|
|
|
|
mkdir build
|
|
|
|
cd build/
|
|
|
|
cmake ..
|
|
|
|
make
|
|
|
|
```
|
2018-05-11 02:21:44 +02:00
|
|
|
|
|
|
|
Install with `make install`.
|
|
|
|
|
|
|
|
# Usage
|
|
|
|
|
2018-05-20 14:25:20 +02:00
|
|
|
**The config file has changed from cfg to JSON in 0.4.0.**
|
|
|
|
|
2018-05-20 21:34:01 +02:00
|
|
|
Start expandurl-mastodon without parameters.
|
|
|
|
|
|
|
|
If no config file is found, you will be asked to provide your account address
|
2018-05-25 00:18:39 +02:00
|
|
|
and an access token is generated. The config file can be found in
|
2018-05-20 21:34:01 +02:00
|
|
|
`${HOME}/.config/expandurl-mastodon.json` and looks like this:
|
2018-05-11 02:21:44 +02:00
|
|
|
|
2018-06-04 00:59:28 +02:00
|
|
|
```JSON
|
|
|
|
{
|
|
|
|
"account": "expandurl@example.social",
|
|
|
|
"access_token": "abc123",
|
|
|
|
"proxy":
|
2018-05-20 14:25:20 +02:00
|
|
|
{
|
2018-06-04 00:59:28 +02:00
|
|
|
"url": "socks5h://[::1]:1080/",
|
|
|
|
"user": "user23",
|
|
|
|
"password": "supersecure"
|
|
|
|
},
|
|
|
|
"replace" :
|
|
|
|
{
|
|
|
|
"//amp\\." : "//",
|
|
|
|
"[\\?&]__twitter_impression=[^&]+" : "",
|
|
|
|
"[\\?&]utm_[^&]+" : "",
|
|
|
|
"[\\?&]wt_zmc=[^&]+" : "",
|
|
|
|
"[\\?&]wtmc=[^&]+" : ""
|
2018-05-20 14:25:20 +02:00
|
|
|
}
|
2018-06-04 00:59:28 +02:00
|
|
|
}
|
|
|
|
```
|
2018-05-11 06:57:41 +02:00
|
|
|
|
2018-05-29 15:13:01 +02:00
|
|
|
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
|
2018-05-22 13:44:41 +02:00
|
|
|
daemon.
|
|
|
|
|
2018-05-11 02:21:44 +02:00
|
|
|
# Copyright
|
|
|
|
|
2018-06-08 00:12:21 +02:00
|
|
|
```PLAIN
|
2018-06-04 00:59:28 +02:00
|
|
|
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.
|
|
|
|
```
|