Modrinth Watcher

Get an email every time one of your Modrinth mods gets a new download. No Gmail login required — uses Resend to deliver to any inbox.

Setup

1. Install dependencies

pip install -r requirements.txt

2. Create your config

cp config.example.json config.json

Edit config.json:

• resend_api_key — get a free key at resend.com (3,000 emails/month free)
• to_email — where notifications go (any email address)
• mods — list of mods to watch. The slug is the last part of your mod's Modrinth URL: modrinth.com/mod/YOUR-SLUG
• poll_interval_seconds — how often to check (default 300 = every 5 minutes)

3. Test it

python3 watch.py --test

You should receive a test email confirming everything works.

Running

One-time check (good for cron):

python3 watch.py --once

Daemon mode (runs forever):

python3 watch.py

Auto-run every 5 minutes (macOS/Linux cron):

(crontab -l 2>/dev/null; echo "*/5 * * * * cd /path/to/modrinth-watcher && python3 watch.py --once >> watcher.log 2>&1") | crontab -

How it works

• On first run, records the current download count as the baseline (no email sent)
• On each subsequent check, if downloads increased, sends you an email with the delta and a link to the mod page
• State is persisted in state.json between runs
• Logs are written to watcher.log

Notes

• config.json and state.json are gitignored — your API key is never committed
• Mods still under Modrinth review will show "not found" in logs — this is expected and harmless
• Uses the Modrinth v2 API — no authentication required for public data

License

MIT