Repolode
Submit
morpheus65535

morpheus65535/bazarr

A companion app for Sonarr and Radarr that automatically finds, downloads and upgrades subtitles for your TV shows and movies.

Open-source alternative to:Subtitle Edit

View on GitHubWebsite
Stars
4,380
Forks
427
Open issues
31
Last commit
yesterday

What is it?

Bazarr manages subtitles for a media library that is already indexed in Sonarr and Radarr. You set language preferences per series or per movie, and Bazarr searches a long list of subtitle providers, downloads matches, and keeps them up to date. It does not scan your disk to discover media on its own; it only handles titles that Sonarr and Radarr know about.

Besides downloading missing subtitles, Bazarr can scan an existing library for internal and external subtitles, replace older files when a better match appears, and delete external subtitle files when needed. A history log records what was downloaded, from which provider, and when. Manual search is available for picking subtitles on demand.

Bazarr runs on Windows, Linux, macOS and Raspberry Pi, and supports 184 subtitle languages, including forced and foreign-only subtitles depending on the provider. It is written in Python and licensed under GPL-3.0.

Key features

  • 01Sets subtitle language preferences per series or movie.
  • 02Automatically adds new series, episodes and movies from Sonarr and Radarr.
  • 03Scans existing libraries for internal and external subtitles and fills gaps.
  • 04Upgrades previously downloaded subtitles when a better match is found.
  • 05Keeps a download history and supports manual search.
  • 06Connects to dozens of subtitle providers, including Embedded Subtitles and Whisper.

Use cases

  • Keeping a large Sonarr and Radarr library supplied with subtitles in several languages.
  • Backfilling subtitles for an older media collection that was never subtitled.
  • Running a home media server on a Raspberry Pi or NAS alongside the *arr stack.

Quick start

  1. 1

    Read the Wiki for installation options (Docker, Windows, Linux, macOS)

  2. 2

    Open the Documentation wiki for setup instructions

Things to know

  • Requires an existing Sonarr or Radarr instance, since it only manages titles indexed there.
  • Licensed under GPL-3.0, a copyleft license that applies to derivative works.

In collections

Self-hosted appsAI video & audio tools

Topics

#subtitles#sonarr#radarr#media-server#self-hosted#automation#python#download-subtitles#episodes#movie

FAQ

What is bazarr?
A companion app for Sonarr and Radarr that automatically finds, downloads and upgrades subtitles for your TV shows and movies. Bazarr manages subtitles for a media library that is already indexed in Sonarr and Radarr. You set language preferences per series or per movie, and Bazarr searches a long list of subtitle providers, downloads matches, and keeps them up to date. It does not scan your disk to discover media on its own; it only handles titles that Sonarr and Radarr know about.
Is bazarr free to use? What license does it have?
bazarr is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is bazarr still maintained?
Actively maintained. The last commit to bazarr was on Oct 23, 2026.
What can I use bazarr for?
Keeping a large Sonarr and Radarr library supplied with subtitles in several languages. Backfilling subtitles for an older media collection that was never subtitled. Running a home media server on a Raspberry Pi or NAS alongside the *arr stack.
How do I install bazarr?
Read the Wiki for installation options (Docker, Windows, Linux, macOS) Open the Documentation wiki for setup instructions
Where can I get bazarr?
The source code and installation instructions are on GitHub: https://github.com/morpheus65535/bazarr

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects