Skip to content
/ Enroll Public

Monitor Usenet Indexers and notify about open registrations.

License

Notifications You must be signed in to change notification settings

EthanC/Enroll

Repository files navigation

Enroll

GitHub Workflow Status Docker Pulls Docker Image Size (tag)

Enroll monitors Usenet Indexers and notifies about open registrations.

Setup

Although not required, a Discord Webhook is recommended for notifications.

Regardless of your chosen setup method, Enroll is intended for use with a task scheduler, such as cron.

Environment Variables:

  • LOG_LEVEL: Loguru severity level to write to the console.
  • LOG_DISCORD_WEBHOOK_URL: Discord Webhook URL to receive log events.
  • LOG_DISCORD_WEBHOOK_LEVEL: Minimum Loguru severity level to forward to Discord.
  • DISCORD_WEBHOOK_URL: Discord Webhook URL to receive open registration notifications.
  • INDEXER_DOGNZB: Check the Indexer DOGnzb for open registration.
  • INDEXER_DRUNKENSLUG: Check the Indexer DrunkenSlug for open registration.
  • INDEXER_NEWZBAY: Check the Indexer NewzBay for open registration.
  • INDEXER_NZBCAT: Check the Indexer NZB.Cat for open registration.
  • INDEXER_NZBSIN: Check the Indexer NZBs.in for open registration.
  • INDEXER_NZBCORE: Check the Indexer NZBCORE for open registration.
  • INDEXER_NINJACENTRAL: Check the Indexer NinjaCentral for open registration.
  • INDEXER_OMGWTFNZBS: Check the Indexer omgwtfnzbs for open registration.
  • INDEXER_TABULARASA: Check the Indexer Tabula Rasa for open registration.

Docker (Recommended)

Modify the following compose.yaml example file, then run docker compose up.

services:
  enroll:
    container_name: enroll
    image: ethanchrisp/enroll:latest
    environment:
      LOG_LEVEL: INFO
      LOG_DISCORD_WEBHOOK_URL: https://discord.com/api/webhooks/YYYYYYYY/YYYYYYYY
      LOG_DISCORD_WEBHOOK_LEVEL: WARNING
      DISCORD_WEBHOOK_URL: https://discord.com/api/webhooks/XXXXXXXX/XXXXXXXX
      INDEXER_DOGNZB: true
      INDEXER_DRUNKENSLUG: true
      INDEXER_NINJACENTRAL: true

Standalone

Enroll is built for Python 3.13 or greater.

  1. Install required dependencies using uv: uv sync
  2. Rename .env.example to .env, then provide the environment variables.
  3. Start Enroll: python enroll.py