tsotimus1/moderatarr repository overview

⁠Moderatarr

Moderatarr is a lightweight TypeScript webhook server that listens to incoming requests from Overseerr or Jellyseerr and provides intelligent anime detection and automation.

⁠Features

• 🎌 Better Anime Detection - Advanced anime detection using TMDB data
• 📁 Automatic Configuration - Root folder and quality profile changes when anime is detected
• 📧 Email Notifications - Automatic email notifications to users via Resend
• 👥 Contact Management - Automatic contact addition to Resend
• 🐳 Docker Ready - Easy deployment with Docker

⁠Quick Start

⁠Step 1: Pull the Docker Image

docker pull tsotimus1/moderatarr:latest

⁠Step 2: Run the Container

docker run -d \
  --name moderatarr \
  -p 3000:3000 \
  -v moderatarr_data:/app/data \
  -e RESEND_API_KEY=your_resend_api_key \
  -e RESEND_AUDIENCE_ID=your_resend_audience_id \
  -e TMDB_API_TOKEN=your_tmdb_api_token \
  -e SEERR_API_TOKEN=your_seerr_api_token \
  -e SEERR_BASE_URL=http://your-seerr:5055 \
  -e [email protected] \
  -e [email protected] \
  -e SEERR_EMAIL_URL=http://your-seerr:5055 \
  --restart unless-stopped \
  tsotimus1/moderatarr:latest

⁠Step 3: Verify it's Running

# Check if container is running
docker ps | grep moderatarr

# Check application health
curl http://localhost:3000/health

⁠Step 4: Setup Webhook in Overseerr/Jellyseerr

⁠For Overseerr:

1. In Overseerr, go to Settings → Notifications → Webhook
2. Set the webhook URL to: http://your-server-ip:3000/webhook/overseerr
3. Enable the webhook for "Media Pending" notifications
4. Save the configuration

⁠For Jellyseerr:

1. In Jellyseerr, go to Settings → Notifications → Webhook
2. Set the webhook URL to: http://your-server-ip:3000/webhook/overseerr
3. Enable the webhook for "Media Pending" notifications
4. Save the configuration

That's it! Your Moderatarr instance is now running and ready to process anime requests.

⁠Configuration

⁠Required Environment Variables

⁠Optional Environment Variables