29-provider search
- 22 native adapters + 7 Subliminal wrappers, queried in parallel
- ASS-first bonus (+50) and anti-MT penalty (−40) in the score
- SHA-256 deduplication catches identical files
- AniDB resolution for anime with alternate episode order
Sublarr is currently in public beta — working well, but still evolving.
v1.0 Coming Soon
Follow on GitHub →
v0.84.0-beta · 29 providers · 12 translation backends · OpenAPI live
The subtitle manager
your media library deserves.
Self-hosted, open source, built for anime and media.
LLM translation, smart provider search, *arr integration — all on
your LAN.
Docker
docker run -d -p 5765:5765 ghcr.io/abrechen2/sublarr:latest
localhost:5765 — Library
29
Subtitle Providers
63
Subtitle Languages
100%
Local — No Cloud
GPL-3.0
Open Source
Features
Everything your subtitles need.
Built for power users with self-hosted media stacks.
Multi-engine sync
- Fallback chain: ffsubsync (audio-feature) + alass (alignment)
- Auto-sync after every download
- Large drift (>2s) → alass first, fallback ffsubsync
- Per-engine audit log with score + correction
Waveform editor
- Audio waveform with snap-to-wave (frame-accurate)
- ASS/SRT syntax highlighting in the cue editor
- Active-cue bar + region labels above the waveform
- Auto-repair on save: BOM, encoding, cue overlap
*arr integration
- Sonarr & Radarr webhooks: on-import + on-upgrade
- Multi-instance: multiple Sonarr/Radarr/Jellyfin/Emby in parallel
- Tag-based language profiles (tag "anime" → DE+EN)
- Library refresh via API for Jellyfin & Emby
Wanted scanner
- 4-hour library scan filtered by profile
- Batch search with backlog reserve against quota bursts
- Slow-mode backoff for unfindable items (4h → 24h)
- Subtitle upgrade job: better ASS to replace existing SRT
Reliability
- Per-provider circuit breaker (CLOSED → OPEN → HALF_OPEN)
- State persists across container restarts
- Budget manager with 429 backoff + refunds
- Multi-key pool: rotates API keys before hitting limits
Library & sidecar tools
- Sidecars as first-class citizens on detail pages
- Inline HI removal, timing shift, format convert
- Embedded track extraction via ffmpeg
- Trash with 14-day retention instead of hard delete
Localization
- Full UI in German + English with one click
- 63 subtitle languages in language profiles (up from 20)
- Per-profile cutoff stops searches when target hits
- audioExclude skips items with matching audio language
Cleanup operations
- 6 ops: language, format, orphan files & DB, backups, foreign tracks
- Dry-run preview shows every file before apply
- Trash with 14-day retention — restore supported
- Path-mapping aware, scheduler-integrated
Optional translation Experimental
- 12 backends: Ollama, DeepL, Claude, Gemini, OpenAI, DeepSeek, …
- Live queue with per-backend cost tracking
- Off by default — opt in via Settings → Translation
- Local models experimental, cloud backends more reliable
Screenshots
See it in action.
A look at the real Sublarr interface.
localhost:5765 / dashboard
Workflow
From download to subtitled — automatically.
01
Connect your stack
Link Sonarr, Radarr, Jellyfin or Emby. Sublarr receives webhooks whenever new media arrives.
02
Search & Score
29 providers searched in parallel. Subtitles scored, deduplicated and ranked — ASS preferred.
03
Translate & Sync
Optionally translate with a local LLM, sync timing with ffsubsync, then deliver to your media server.
Installation
Up and running in minutes.
# 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.
Support
Like Sublarr? Buy me a coffee.
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.
- Keeps the project maintained and updated
- Funds server costs for the translation model
- Motivates new features and bug fixes
No account required. Any amount appreciated.
