Automate subtitle downloads for your Sonarr and Radarr libraries
A

Automate subtitle downloads for your Sonarr and Radarr libraries

Automate subtitle downloads for your Sonarr and Radarr libraries

4,101 stars
N/A forks
N/A contributors

README

Project documentation from GitHub

Automate Your Subtitle Game with Bazarr

If you run a media server with Sonarr and Radarr, you know the drill: your shows and movies download automatically, but you're still stuck manually hunting for subtitles. It's that last bit of friction that keeps your setup from being truly hands-off. What if your subtitle downloads could be as automated as everything else?

Enter Bazarr. It's the missing piece that plugs directly into your Sonarr and Radarr libraries, automatically finding and syncing subtitles for your media. No more manual searches, no more out-of-sync .srt files. It just works in the background.

What It Does

Bazarr is a companion application to Sonarr and Radarr. Once connected, it continuously monitors your library. Whenever a new movie or episode is added, Bazarr springs into action. It searches through multiple subtitle providers and websites, downloads the best matching subtitle in your preferred language, and ensures it's correctly synced and named alongside your video file.

Why It's Cool

The clever part is how seamlessly it integrates. You don't have to change your workflow. Bazarr sits alongside your existing *arr stack, using their APIs to know exactly what you have and what you need. It respects your quality profiles and can even upgrade subtitles if better ones become available later.

It's highly configurable, too. You can set languages per series or movie, choose preferred subtitle providers (like OpenSubtitles, Addic7ed, or Subscene), and even set a score threshold to ensure you only get high-quality, accurate subs. For multi-language households or accessibility needs, it can download multiple language tracks for a single piece of media.

How to Try It

Getting started is straightforward, especially if you're already in the *arr ecosystem.

  1. Check the Repo: All the details are on the Bazarr GitHub repository.
  2. Choose Your Install: The easiest method for most is via Docker (docker pull ghcr.io/morpheus65535/bazarr:latest). There are also native installers for Windows, macOS, and Linux, and it's available in popular package managers like Unraid's Community Applications.
  3. Connect and Configure: After installation, point Bazarr to your Sonarr and Radarr instances via their API keys. Then, configure your default languages and subtitle providers in the clean, web-based UI.
  4. Let It Run: Once set up, it will scan your existing library and then sit idle, waiting to grab subs for any new content that arrives.

Final Thoughts

Bazarr is one of those utilities that feels obvious in hindsight. It completes the automation loop for your media server, removing a tedious manual task. For developers, it's a gr

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Jan 5, 2026