Categories
self-hosted media-management radarr home-media sonarr subtitle-translation ai-translationStars
Forks
Watchers
Developer links
Lingarr
When international movies and series arrive in a Radarr or Sonarr library without native-language captions, Lingarr automatically translates subtitle files across dozens of languages using local AI models or cloud translation engines. Connect your existing movie and television directories to scan media folders, identify missing target-language subtitles, and generate translated caption files alongside the original video streams. Administrators can configure an ordered chain of 13 translation backends, pairing a primary engine such as OpenAI, Anthropic, Gemini, DeepSeek, Mistral, xAI, or DeepL with automatic fallback to self-hosted LibreTranslate or local Ollama models whenever rate limits occur. Context-aware prompt templates inject preceding and following dialogue lines into each AI request so idioms, speaker tone, and timing remain natural across scene transitions, while batch translation mode processes multi-line blocks in a single call. From the web dashboard, users can browse indexed movies and episodes, trigger manual single-file or library-wide translations, and monitor active queues, progress percentages, and historical logs in real time. Scheduled background tasks and a documented REST API allow media servers to automate caption generation completely hands-free as new releases finish downloading. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. AGPL-3.0 licensed.
Benefits
- Ordered Multi-Provider Translation Fallbacks
- Configures an ordered JSON array of primary and fallback translation engines across 13 supported providers, automatically switching to secondary services if an API quota or network timeout occurs.
- Native Radarr And Sonarr Integration
- Connects directly to Radarr on port 7878 and Sonarr on port 8989 via API keys to index movie and television libraries, detect source subtitles, and write translated files in place.
- Context-Aware AI Subtitle Prompts
- Passes surrounding dialogue variables including contextBefore and contextAfter alongside each subtitle line to OpenAI, Anthropic, Gemini, or local Ollama models for accurate conversational translation.
- Flexible Database And Container Setup
- Deploys as a multi-architecture AMD64 and ARM64 Docker container listening on port 9876 with support for SQLite, PostgreSQL, and MySQL persistence plus environment-driven configuration.
Features
- Thirteen Translation Backends
- Supports LibreTranslate, Ollama and OpenAI-compatible local AI endpoints, DeepL, OpenAI, Anthropic, Gemini, DeepSeek, Mistral, xAI, Google, Microsoft, Bing, and Yandex translators.
- Radarr And Sonarr Sync
- Synchronizes movie and series metadata via RADARR_URL and SONARR_URL API integrations to discover existing subtitle tracks and automate target-language subtitle generation.
- Batch AI Subtitle Processing
- Groups consecutive subtitle lines into structured JSON batches via USE_BATCH_TRANSLATION with automatic Gemini and LLM batch repair to reduce API round-trips and token overhead.
- Real-Time Job Queue Dashboard
- Streams live translation job progress, active worker status, and completed subtitle history to the Vue web interface while exposing a Swagger-documented REST API.
- Scheduled Automation Cron Jobs
- Executes recurring background library scans and automated subtitle translation tasks on configurable schedules with customizable request concurrency and job timeouts.