Subtitlarr

Subtitlarr is a self-hosted companion for Bazarr that translates existing subtitles into missing languages using a local or cloud large language model.

  • Automation
  • Media Applications
  • Tools & Utilities
Subtitlarr is a self-hosted companion for Bazarr that translates existing subtitles into missing languages using a local or cloud large language model. It polls Bazarr's wanted-subtitle list, checks for preferred source subtitles, and writes translated subtitles through Bazarr's API without mounting your media folders.

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

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

Collected 49 days ago - public community threads