andypiper / mastodon_digest

A Python script that aggregates recent popular posts from your Mastodon timeline

A fork of hodgesmr/mastodon_digest that

• runs on github actions
• renders mastodon posts without iframes
• in a clean and responsive style

see live 🎉

---

Mastodon Digest scans posts you haven't yet seen in your timeline, finds the most popular ones and shows them to you in a pretty page.

To run your own

1. Fork this repository
2. Create repository secrets (Settings → Secrets and variables → Actions → New repository secrets) for:

• MASTODON_BASE_URL: the url of your instance, like https://mastodon.social
• MASTODON_USERNAME: your user name, like Gargron
• MASTODON_TOKEN: the access token you request in your instance settings under Preferences → Development

3. Adjust the github workflow however you want

• edit cron to define how often you want the digest to run
• edit the command python run.py -n 12 -s SimpleWeighted -t lax with your own preferences for:

  -n {1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24}
                        The number of hours to consider (default: 12)
  -s {ExtendedSimple,ExtendedSimpleWeighted,Simple,SimpleWeighted}
                        Which post scoring criteria to use. Simple scorers take a geometric
                        mean of boosts and favs. Extended scorers include reply counts in
                        the geometric mean. Weighted scorers multiply the score by an
                        inverse sqaure root of the author's followers, to reduce the
                        influence of large accounts. (default: SimpleWeighted)
  -t {lax,normal,strict}
                        Which post threshold criteria to use. lax = 90th percentile, normal
                        = 95th percentile, strict = 98th percentile (default: normal)

4. Enable github actions under Settings → Actions → General
5. Allow github actions to write to the repo under Settings → Actions → General, check Read and write permissions and Save
6. Create the gh-pages branch
7. Run the action from the Actions tab and when it succeeds publish your digest by going to Settings → Pages and selecting to deploy from the root of the gh-pages branch.