Go to file
2019-07-30 21:38:40 +02:00
.gitignore Initial commit 2019-05-30 14:29:49 +02:00
config.json.example Documenting a bit 2019-07-30 21:06:25 +02:00
hashtag-spreader.py Documenting a bit 2019-07-30 21:06:25 +02:00
README.md Link events and instances mentioned in the README 2019-07-30 21:14:46 +02:00

Mastodon Hashtag Spreader

For #GPN19 my Mastodon instance fem.social wants to get all posts for this hashtag. Most users at this event are connected to the instance chaos.social.

Our solution

We have a script on one of our servers which streams all posts for specific hashtag from chaos.social and puts the URLs of those posts into the search entry of our own instance. Thus, the URLs will get fetched by our instance and the posts is added to our hashtag timeline.


pip3 install Mastodon.py
git clone https://github.com/clerie/mastodon-hashtag-spreader.git
cd mastodon-hashtag-spreader/
cp config.json.example config.json
nano config.json

Edit config for your needs.

python3 hashtag-spreader.py


To get this script work, you need an application token on each instance you want to get connected to. The needed scopes are depending on the role of the instace.


  • read:statuses


  • read:search