Lingarr is an application designed to automate the translation of subtitle files, supporting both local and cloud-based translation services. It caters to users who frequently work with foreign language media and require efficient subtitle localization, offering flexibility through multiple backend translation providers.

How It Works

Lingarr acts as a central hub for subtitle translation, integrating with various translation APIs. Users can configure their preferred translation service (e.g., LibreTranslate, DeepL, OpenAI, Gemini) and point Lingarr to their media directories. The application then scans for subtitle files and initiates translations based on user-defined settings, managing the process and storing translated files. This approach allows users to leverage the best available translation technology for their needs, whether it's a free local service or a high-quality commercial API.

Quick Start & Requirements

• Installation: Docker Compose is the recommended installation method. A Docker CLI example is also provided.
• Prerequisites: Docker and Docker Compose. For local LibreTranslate, Python and specific directories with permissions are needed.
• Configuration: Requires mapping media directories and a configuration directory. Environment variables are used for database connections (MySQL/SQLite) and service URLs.
• Resources: Running LibreTranslate locally may require significant disk space for language models.
• Documentation: API documentation is available via a Swagger definition.

Highlighted Details

• Supports multiple translation services: LibreTranslate, Local AI (Ollama, OpenAPI), DeepL, Anthropic, OpenAI, DeepSeek, Gemini, Google, Bing, Yandex, Azure.
• Offers a RESTful API for programmatic integration.
• Configurable via environment variables for database connections and job concurrency.
• Includes health checks for the LibreTranslate service.

Maintenance & Community

• Active development is implied by recent updates and community contributions are welcomed.
• Community support is available via Discord.

Licensing & Compatibility

• The project's primary license is not explicitly stated in the README. The Docker image lingarr/lingarr:latest suggests a public repository. LibreTranslate is typically AGPL-3.0.

Limitations & Caveats

• The README notes potential issues with dynamic volume mapping for deep media directories, advising users to consult the wiki or create an issue.
• The specific license for the Lingarr application itself is not clearly defined, which could impact commercial use or integration with closed-source projects.