andersonviudes/legendarr repository overview

⁠ legendarr

⁠About

Self-hosted companion for Radarr and Sonarr that automatically translates subtitles, with flexible language profiles and the ability to translate any subtitle, including tracks embedded inside the video.

Full documentation: andersonviudes.github.io/legendarr⁠.

⁠Installation

Full walkthrough (path mappings, PUID/PGID, building from source): Installation docs⁠.

⁠Docker

docker run -p 8000:8000 -v ./data:/config -v /path/to/your/library:/media \
  -e LEGENDARR_RADARR_URL=http://radarr:7878 \
  -e LEGENDARR_RADARR_API_KEY=your-radarr-api-key \
  -e LEGENDARR_SONARR_URL=http://sonarr:8989 \
  -e LEGENDARR_SONARR_API_KEY=your-sonarr-api-key \
  -e PUID=1000 -e PGID=1000 \
  andersonviudes/legendarr:latest

⁠Docker Compose

Save as docker-compose.yml (also available as docker-compose.example.yml⁠ in the repo root), adjust the paths/env vars, then docker compose up -d:

services:
  legendarr:
    image: andersonviudes/legendarr:latest
    environment:
      - LEGENDARR_RADARR_URL=http://radarr:7878
      - LEGENDARR_RADARR_API_KEY=your-radarr-api-key
      - LEGENDARR_SONARR_URL=http://sonarr:8989
      - LEGENDARR_SONARR_API_KEY=your-sonarr-api-key
      - PUID=1000
      - PGID=1000
    volumes:
      - ./data:/config
      - /path/to/your/library:/media
    ports:
      - "8000:8000"
    restart: unless-stopped

docker compose up -d

The dashboard is then available at http://localhost:8000.

For working on legendarr itself, the repo also ships a docker-compose.dev.yml⁠ development stack — a sandbox pairing legendarr with a real Sonarr instance (and optionally Plex/Jellyfin) for manually exercising sync, webhooks, and path mapping. Not part of the shipped product; end users only need the compose file above.

⁠Features

• Language Profiles⁠ — named source/target language and translation-preference sets, e.g. "translate embedded Japanese to pt-BR and en for anime".
• Media Library Sync⁠ — keeps track of every movie and series in your Radarr/Sonarr library on a background schedule.
• Subtitle Discovery⁠ — finds every subtitle a video already has, external or embedded.
• Subtitle Acquisition⁠ — downloads subtitles from your configured provider sites when none exist yet.
• Subtitle Translation⁠ — pluggable translation backends behind a single provider interface.
• Subtitle Timing Sync⁠ — re-aligns a subtitle's cues against the video with ffsubsync.
• Authentication⁠ — optional single-admin login for self-hosted deployments.
• External API⁠ — the same REST API the dashboard uses, documented for scripts and other tools.
• Media-Server Integration⁠ — notifies Plex/Jellyfin automatically after a subtitle is written.
• Internationalization⁠ — pick your own UI language from Settings.
• Backup & Restore⁠ — snapshot legendarr's configuration before an upgrade or a move to a new host.

⁠License

Licensed under the GNU General Public License v3.0⁠ or later.