Skip to content

Sublarr Documentation

Sublarr is a self-hosted subtitle manager for anime and media libraries. It searches, scores, downloads, extracts, and syncs subtitles against your *arr stack. Translation is optional and can use local Ollama or cloud backends when no target-language subtitle exists.

Current release: 1.20.0 — an opt-in Automatic repair switch (Settings → Automation → Search, scan & upgrades) checks the timing of every download against the video, treats signs-only sidecars as missing and repairs wrong-timing subtitles during the nightly health sweep; the subtitle-health panel lists the new findings “Timing offset” and “Timing does not fit the video”. A “Duplicate language codes” cleanup rule (disabled by default) removes X.deu.srt next to X.de.srt. Jimaku matches the right season and episode, AnimeTosho uses torrent-level attachments and finds season packs of older seasons, and Gestdown, BetaSeries, Napisy24 and OpenSubtitles follow their API docs. 1.19 added signs & songs subtitles for anime (language profile options Prefer signs & songs and Download full subtitles), a minimum score per language, a disk-space warning and one shared set of rules for saving settings and importing backups. See the release notes for 1.20.0, 1.19.2 and 1.19.0.

New here? Walk through Installation → Quick Start → bookmark the FAQ.

Not sure yet? Scope & limitations says who Sublarr is built for, who should skip it, and what it cannot do — read that before you install rather than after.

Media app Sonarr / Radarr Wanted queue missing target lang Embedded tracks extract first 28 adapters search + score Sidecar subtitle write + refresh Optional: translate with one of 12 backends when no target subtitle exists.
Current Sublarr flow