mastoroulette

Prints the URL of a random follower from your list of Mastodon followers you are not following as a suggestion for the next user you may consider following.

By default, it doesn't suggest a user that has already been suggested previously. To ignore previous suggestions, you can use the --ignore-repeats (or -i) parameter.

It downloads your list of followers and followings and caches it for reuse on every subsequent exection until it finds you have a new follower of following and in that case it redownloads the full list of followers and followings.
If you want to skip this check and always use the cached copy, you can use the --force-cache (or -c) option or --update-cache (or -u) option if you want to force an update of the cache.

Configuration

Edit the mastoroulette.py file and adjust the INSTANCE, USER and BEARER variables as described there.

For now, you will have to figure out yourself how to get an authentication bearer token. These links may help, but I haven't tested the instructions there myself:

https://takahashim.github.io/mastodon-access-token/
https://sohwatt.com/generating-a-token-on-mastodon/

You can get your numeric user id with a link like this:

https://<INSTANCE>/api/v1/accounts/lookup?acct=<ACCOUNT>

For example, to get the numeric id for the account @chuso@mastodon.social: https://mastodon.social/api/v1/accounts/lookup?acct=chuso

Roadmap

Planned features that may be implemented, or may not, depending on when I lose interest on this:

• Optionally return more than one user.
• Proper configuration support.
• Ability to retrieve the user id and bearer token.
• Convert it into an online service? (most likely no).