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

Folders and files

NameName
Last commit message
Last commit date

Latest commit

f63ce27 · Mar 11, 2025

History

9 Commits
Dec 4, 2024
Jan 17, 2025
Dec 4, 2024
Jan 15, 2025
Dec 4, 2024
Dec 4, 2024
Dec 4, 2024
Mar 11, 2025
Jan 15, 2025
Dec 4, 2024
Jan 15, 2025
Jan 15, 2025
Jan 15, 2025

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