Mastoscore Logo

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.

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

  1. fetch
  2. analyse (analyse is implicitly run by post, graph, and wordcloud. But it's available to run separately for testing purposes. )
  3. post
  4. graph
  5. wordcloud
  6. postgraphs (postgraphs can only be run if you've run graph and wordcloud already to create the image and alt text files.)

Directory Structure

Mastoscore organizes data in a structured way:

journaldir/
├── YYYY/
│   ├── MM/
│   │   ├── DD/
│   │   │   ├── hashtag-YYYYMMDD-server1.json
│   │   │   ├── hashtag-YYYYMMDD-server2.json
│   │   │   └── ...
graphs/
├── hashtag-YYYYMMDD.png              # Time-based graph
wordcloud/
├── wordcloud-hashtag-YYYYMMDD-as-is.png
├── wordcloud-hashtag-YYYYMMDD-remove.png
ini/
└── ...

Example series of toots:

Example Monsterdon

More Documentation

References

Contact