Sublarr runs in Docker on your own server and works with Sonarr,
Radarr, Jellyfin and Emby: search, score, sync, clean up.
Built for the hard cases — absolute episode numbering, ASS styling,
fansub groups. Whatever handles those handles the rest of your
library without breaking a sweat.
docker run -d -p 5765:5765 ghcr.io/abrechen2/sublarr:latest
28
Provider Adapters
183
Subtitle Languages
0
Cloud Calls Unless You Enable Them
GPL-3.0
Open Source
Features
Built for power users with self-hosted media stacks.
Screenshots
A look at the real Sublarr interface.
Workflow
01
Link Sonarr, Radarr, Jellyfin or Emby. Sublarr receives webhooks whenever new media arrives.
02
28 provider adapters searched in parallel. Subtitles scored, deduplicated and ranked — ASS preferred.
03
Optionally translate with a local LLM, sync timing with ffsubsync, then deliver to your media server.
Installation
# Pull and run
docker run -d \
--name sublarr \
-p 5765:5765 \
-v /path/to/config:/config \
-v /path/to/media:/media \
ghcr.io/abrechen2/sublarr:latestThen open http://localhost:5765 in your browser — or read the Installation Guide for the full setup.
Trust
A subtitle manager reaches into your media library. So here is what happens, without the marketing voice.
Hash-based search computes a checksum locally and sends only that — never the file itself.
Usage statistics are opt-in. Nothing is sent until you actively agree, and you can withdraw at any time.
Removed subtitles go to a trash folder and stay restorable for 30 days. No immediate hard delete.
The invasive tools — cleanup, repair, the automation dry run — show you what they would change first.
Files hardlinked into your torrent client are skipped on remux by default — rewriting them would break the seed.
Translation is optional and off. If you use it, you choose between local Ollama and cloud services.
Support
Sublarr is free and open source — built and maintained in my free time. If it saves you hours of subtitle hunting, a small donation goes a long way to keep the project alive.
No account required. Any amount appreciated.
Documentation
From your first docker compose up
to the plugin API — the docs are part of the project.
Open source, versioned, no tracking.
Installation, onboarding and first run.
Dashboard, library, wanted list and activity.
Edit subtitles, waveform sync and batch processing.
AI-powered translation with cost and glossary management.
Providers, languages, scoring, automation and more.
*arr integrations, plugin marketplace, AniDB and more.
When something breaks — common issues and performance tuning.
Architecture, REST API, database schema and plugin development.
Full overview in the docs — searchable, with sidebar and full-text search.
