https://github.com/ethanc/enroll
Monitor Usenet Indexers and notify about open registrations.
https://github.com/ethanc/enroll
available discord dognzb drunkenslug indexer newzbay ninjacentral notification nzb nzbcat nzbcore nzbsin omgwtfnzbs open python register script signup tabularasa usenet
Last synced: 6 months ago
JSON representation
Monitor Usenet Indexers and notify about open registrations.
- Host: GitHub
- URL: https://github.com/ethanc/enroll
- Owner: EthanC
- License: agpl-3.0
- Created: 2024-12-04T04:44:20.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-11T07:49:36.000Z (7 months ago)
- Last Synced: 2025-03-11T08:34:03.756Z (7 months ago)
- Topics: available, discord, dognzb, drunkenslug, indexer, newzbay, ninjacentral, notification, nzb, nzbcat, nzbcore, nzbsin, omgwtfnzbs, open, python, register, script, signup, tabularasa, usenet
- Language: Python
- Homepage:
- Size: 48.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yaml
- License: LICENSE
Awesome Lists containing this project
README
# Enroll
  
Enroll monitors Usenet Indexers and notifies about open registrations.
## Setup
Although not required, a [Discord Webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) is recommended for notifications.
Regardless of your chosen setup method, Enroll is intended for use with a task scheduler, such as [cron](https://crontab.guru/).
**Environment Variables:**
- `LOG_LEVEL`: [Loguru](https://loguru.readthedocs.io/en/stable/api/logger.html) severity level to write to the console.
- `LOG_DISCORD_WEBHOOK_URL`: [Discord Webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) URL to receive log events.
- `LOG_DISCORD_WEBHOOK_LEVEL`: Minimum [Loguru](https://loguru.readthedocs.io/en/stable/api/logger.html) severity level to forward to Discord.
- `DISCORD_WEBHOOK_URL`: [Discord Webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) URL to receive open registration notifications.
- `INDEXER_DOGNZB`: Check the Indexer [DOGnzb](https://dognzb.cr/login) for open registration.
- `INDEXER_DRUNKENSLUG`: Check the Indexer [DrunkenSlug](https://drunkenslug.com/login) for open registration.
- `INDEXER_NEWZBAY`: Check the Indexer [NewzBay](https://newzbay.cc/) for open registration.
- `INDEXER_NZBCAT`: Check the Indexer [NZB.Cat](https://nzb.cat/) for open registration.
- `INDEXER_NZBSIN`: Check the Indexer [NZBs.in](https://v2.nzbs.in/) for open registration.
- `INDEXER_NZBCORE`: Check the Indexer [NZBCORE](https://nzbcore.info/nnplus/www/) for open registration.
- `INDEXER_NINJACENTRAL`: Check the Indexer [NinjaCentral](https://ninjacentral.co.za/) for open registration.
- `INDEXER_OMGWTFNZBS`: Check the Indexer [omgwtfnzbs](https://omgwtfnzbs.org/login) for open registration.
- `INDEXER_TABULARASA`: Check the Indexer [Tabula Rasa](https://www.tabula-rasa.pw/login) for open registration.
### Docker (Recommended)
Modify the following `compose.yaml` example file, then run `docker compose up`.
```yaml
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](https://www.python.org/) or greater.
1. Install required dependencies using [uv](https://github.com/astral-sh/uv): `uv sync`
2. Rename `.env.example` to `.env`, then provide the environment variables.
3. Start Enroll: `python enroll.py`