albahadly/animewatcher repository overview

⁠AnimeWatcher

Self-hosted anime tracker. AnimeWatcher monitors your favorite anime via the AniList⁠ API and sends push notifications through Pushover⁠ when new episodes air, a new season starts, a sequel is announced, or a season finishes.

Source code, documentation, and issues: github.com/albahadly/AnimeWatcher⁠

⁠Features

• 🔍 Search AniList and add anime to your watchlist with one click
• 👁️ Background monitoring on a configurable interval (rate-limit aware)
• 🔔 Pushover notifications: new episode, season started, new season announced, season finished
• ⚙️ Global and per-anime notification preferences
• 📖 Full change history for episodes and seasons
• 🌐 Synopsis translation (RTL languages supported)
• 💾 Scheduled database backups with retention, plus JSON export/import of your watchlist
• 🔐 Flexible authentication: always required, local-network bypass, or disabled

⁠Quick Start

docker run -d \
  --name animewatcher \
  -p 8111:8111 \
  -v animewatcher-data:/app/data \
  -v animewatcher-animedb:/app/animedb \
  -v animewatcher-keys:/home/appuser/.aspnet/DataProtection-Keys \
  -v animewatcher-logs:/app/logs \
  albahadly/animewatcher:latest

Then open http://localhost:8111⁠, register an account, add your Pushover keys under Settings, and start monitoring.

⁠Docker Compose

services:
  animewatcher:
    image: albahadly/animewatcher:latest
    container_name: animewatcher
    ports:
      - "8111:8111"
    volumes:
      - animewatcher-data:/app/data
      - animewatcher-animedb:/app/animedb
      - animewatcher-keys:/home/appuser/.aspnet/DataProtection-Keys
      - animewatcher-logs:/app/logs
    restart: unless-stopped

volumes:
  animewatcher-data:
  animewatcher-animedb:
  animewatcher-keys:
  animewatcher-logs:

⁠Tags

⁠Volumes

⁠Environment Variables

Monitoring interval, Pushover keys, notification types, authentication mode, and backup schedule are all configured in the web UI under Settings — no environment variables needed.

⁠Notes

• The container runs as a non-root user and exposes a health check at /health.
• Put the app behind a reverse proxy (nginx, Traefik, Caddy) for HTTPS — see the deployment guide⁠.
• Built with .NET 10 / Blazor. Licensed under the MIT License⁠.