bazarr/README.md

Bazarr

A companion application to Sonarr and Radarr that manages and downloads subtitles based on your requirements.

About

Bazarr is a companion application to Sonarr and Radarr. It manages and downloads subtitles based on your requirements. You define your preferences by TV show or movie, and Bazarr takes care of everything for you.

Bazarr does not scan your disk to detect series and movies. It only manages the series and movies that are indexed in Sonarr and Radarr.

Links

Resource	Link
Documentation	Wiki
Support	Discord
Bug reports	GitHub Issues
Feature requests	Feature Upvote

Support the project

At the request of some users, here is a way to show appreciation for the efforts made in the development of Bazarr:

Major features

• Support for major platforms: Windows, Linux, macOS, Raspberry Pi, etc.
• Automatically add new series and episodes from Sonarr.
• Automatically add new movies from Radarr.
• Series- and movie-based subtitle language configuration.
• Scan your existing library for internal and external subtitles and download any missing ones.
• Keep a history of what was downloaded, from where, and when.
• Manual search to download subtitles on demand.
• Upgrade previously downloaded subtitles when a better one is found.
• Delete external subtitles from disk.
• Support for 184 subtitle languages, including forced/foreign subtitles depending on providers.
• A beautiful UI based on Sonarr.

Supported subtitle providers

• Addic7ed
• AnimeKalesi
• Animetosho (requires AniDb HTTP API client described here)
• AnimeSub.info
• Assrt
• AvistaZ, CinemaZ (Get session cookies using method described here)
• BetaSeries
• BSplayer
• Embedded Subtitles
• Gestdown.info
• GreekSubs
• GreekSubtitles
• HDBits.org
• Hosszupuska
• Karagarga.in
• Ktuvit (Get hashed_password using method described here)
• LegendasDivx
• Legendas.net
• Napiprojekt
• Napisy24
• Nekur
• OpenSubtitles.com
• OpenSubtitles.org (VIP users only)
• Pipocas.tv
• Podnapisi
• Prijevodi-Online
• RegieLive
• Sous-Titres.eu
• subf2m.co
• Subs.sab.bz
• Subs4Free
• Subs4Series
• Subsarr (self-hosted, requires slimcdk/subsarr)
• Subscene
• Subscenter
• SubsRo
• Subsunacs.net
• SubSynchro
• Subtis
• Subtitrari-noi.ro
• subtitri.id.lv
• Subtitulamos.tv
• SubX
• Supersubtitles
• Titlovi
• Titrari.ro
• Titulky.com
• Turkcealtyazi.org
• TuSubtitulo
• TVSubtitles
• Whisper (requires ahmetoner/whisper-asr-webservice)
• Wizdom
• XSubs
• Yavka.net
• YIFY Subtitles
• Zimuku

Screenshot

Acknowledgements

Thanks to the folks at OpenSubtitles for their logo, which inspired ours.

License

• GNU GPL v3
• Copyright 2010-2026