Subtitlarr
Subtitlarr is a self-hosted companion for Bazarr that translates existing subtitles into missing languages using a local or cloud large language model.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
55/100 Fair
- Maintained
- 91last commit 18 days ago
- Popular
- 123 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 18 days ago
- GitHub stars
- 3
- Open issues
- 1
- Last commit
- 2026-11-02
- Latest release
- v1.1.0
- License
- AGPL-3.0
- Activity
- declining
Checked 6 days ago - source: GitHub (GerardUmbert/Subtitlarr)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- First login Use the seeded admin/admin account on first start and set a real password. If locked out, run subtitlarr --reset-admin from the container console. source
- Volumes Map only Subtitlarr's /data volume for its SQLite database; do not mount media folders because subtitle reads and writes use Bazarr's API. source
- Bazarr API setup Subtitlarr reads and writes subtitles through Bazarr's REST API, so it does not require media-folder mounts. source
Fetched 46 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
How do I set the initial password or recover access if I am locked out of Subtitlarr?
Use the seeded admin/admin account on first start and set a real password. If you are locked out, run subtitlarr --reset-admin from the container console.
Which volume should I persist and back up for Subtitlarr?
Map only the /data volume, which holds its SQLite database. Do not mount media folders because subtitle reads and writes go through Bazarr's API.
How does Subtitlarr handle multiple translation engines and failures?
You build an ordered cascade of local or cloud engine instances, and Subtitlarr tries the next one if an engine rate-limits, errors, or has blocked output. An engine with three consecutive failures gets a 24-hour cooldown and is skipped until it clears or you clear it manually.
Will Subtitlarr create subtitles when none already exist?
No, it only translates an existing subtitle in one of your preferred source languages. Items with no subtitle in any language are skipped, because finding or downloading subtitles is Bazarr's job.
Can Subtitlarr fix subtitles that are already out of sync?
No, translation is text-only and reuses the source subtitle's original timestamps. If a subtitle is out of sync before translation, it stays out of sync after.
What happens if the LLM returns well-formed text in the wrong language?
Subtitlarr's structural checks may not catch a well-formed but wrong response. The Jobs page Language Check audits recently completed items against their detected output language and resets mismatches to pending for a real retry.
Answers sourced from gerardumbert.github.io, gerardumbert.github.io, github.com
Community
- Subtitle/Closed Caption generation : r/selfhosted - Reddit (reddit)
- Any good subtitle sync fixing software? : r/selfhosted - Reddit (reddit)
Collected 49 days ago - public community threads