Mastoscore Logo

Current Version: 2.0.0

This is a tool that will fetch all the recent toots on a specific hashtag and do a bunch of analysis on those toots. After fetching them all to a bunch of JSON files, it will then read those files, and output a series of toots that describe what we found. It can also produce graphs.

I created it because I love to participate in #monsterdon, which routinely has hundreds of people posting thousands of toots. I was wondering who tooted the most and which were the most popular toots and so on. If you hang around the fediverse much, you'll see that there are lots of watch parties! That's what inspired this tool, but you could use it for other things.

Usage Options

Mastoscore can be used in two ways:

  1. Web-based backstage: A browser-based UI for managing configurations and running analyses
  2. Command-line Interface: A CLI for scripting and automation

Backstage Web Interface

The easiest way to use Mastoscore is through the web interface:

./scripts/backstage.sh

This launches both the Flask API backend and React frontend in a tmux session. See Backstage documentation for details.

Command Line Interface

The work is divided into 6 phases that typically run in this order:

  1. fetch
  2. analyse
  3. graphs (Runs both graph and wordcloud)
  4. post
  5. postgraphs
  6. blog

Example series of toots:

Example Monsterdon

More Documentation

References

Contact