MastodonTootFollower/README.md

52 lines
1.4 KiB
Markdown

# MastodonTootFollower
Follow Toots on Mastodon - don't miss new replies or edits.
## Usage - Demo instance
Visit [https://mastodon-toot-follower.privacy1st.de/]() to generate a link to follow a conversation on Mastodon.
## Usage - Local instance and CLI
Start a local server from local python venv:
```shell
make prod
```
Start a local server with docker-compose:
```shell
sudo docker-compose up -d
```
Visit [http://localhost:5000]() to generate a link to follow a conversation on Mastodon.
Additionally, one can view news from a conversation on the commandline:
```shell
MASTODON_TOOT_URL=https://mastodon.instance/@user@another.instance/123456 make cli
```
## Used libraries
See [requirements.txt](requirements.txt).
- [Mastodon.py](https://mastodonpy.readthedocs.io/en/stable/index.html): Fetch Toot and replies from a Mastodon instance.
- [python3-feedgen](https://github.com/lkiesow/python-feedgen): Generate an Atom/RSS feed.
- [Flask](https://flask.palletsprojects.com): Provide a web API (JSON, RSS+XML, HTML).
- [Waitress](https://docs.pylonsproject.org/projects/waitress/en/stable/): Web server.
## Test RSS feed
Tested with [gfeeds](https://gitlab.gnome.org/World/gfeeds):
```shell
rm -rf ~/.config/org.gabmus.gfeeds.* ~/.cache/org.gabmus.gfeeds
gfeds
```
Tested with [Nextcloud News](https://github.com/nextcloud/news).
Other feed readers: https://wiki.archlinux.org/title/list_of_applications#News,_RSS,_and_blogs