Official community catalog of subtitle provider plugins for the Bazarr+ Provider Hub. Load extra subtitle sources into your Bazarr+ install without waiting on a new release.

Bazarr+ is an enhanced fork of Bazarr that adds a Provider Hub: a plugin system that loads subtitle providers from an external catalog and runs each one in an isolated worker. This repo is that catalog.

If you run Bazarr+ alongside Sonarr / Radarr / Plex / Jellyfin / Emby, install providers from here via the Bazarr+ Marketplace to expand your subtitle sources beyond the built-in providers, with no rebuild and no restart of Sonarr/Radarr.

Every provider here ships independently of Bazarr+ releases. Contribute your own.

1. Open Bazarr+ → Settings → Providers → Provider Hub → Marketplace.
2. Point the catalog source at this repo's catalog.json:

   https://raw.githubusercontent.com/LavX/bazarr-provider-catalog/main/catalog.json
   

3. Browse the Marketplace, click Install on the provider you want, and restart Bazarr+ when prompted.
4. Configure the provider from the regular Providers settings page. Each plugin advertises its own config schema.

See the Bazarr+ documentation for the broader install / config flow.

• catalog.json: embedded Provider Hub V1 catalog manifest. This is the file Bazarr+ fetches.
• providers/addic7ed/: uses Addic7ed movie and episode subtitle listings with login or cookie authentication.
• providers/animekalesi/: scrapes AnimeKalesi Turkish anime episode subtitle pages.
• providers/animesubinfo/: scrapes AnimeSub.info Polish anime movie and episode subtitles.
• providers/animetosho/: archive-only AnimeTosho JSON feed provider for embedded subtitle attachments on older anime episodes by AniDB episode id.
• providers/betaseries/: searches the BetaSeries API for token-authenticated French and English episode subtitles.
• providers/bollynook/: scrapes BollyNook movie subtitle pages and downloads.
• providers/bsplayer/: uses the BSPlayer subtitles SOAP API for hash and size based movie and episode subtitle lookup.
• providers/embeddedsubtitles/: extracts subtitle streams embedded in local movie and episode media files with ffprobe and ffmpeg.
• providers/fansubs/: production community provider, scrapes fansubs.ru for Russian anime and Asian cinema subtitle releases.
• providers/gestdown/: uses the public Gestdown API for episode subtitles by TVDB id, season, episode, and language.
• providers/greeksubs/: scrapes GreekSubs movie and episode subtitle listings by IMDb id.
• providers/greeksubtitles/: scrapes GreekSubtitles movie and episode search results.
• providers/isubtitles/: scrapes iSubtitles movie and episode subtitle pages.
• providers/jimaku/: uses the Jimaku API for Japanese movie and episode subtitles.
• providers/kitsunekko/: scrapes Kitsunekko anime subtitle directories and ZIP packs.
• providers/ktuvit/: uses Ktuvit.me services for Hebrew movie and episode subtitles.
• providers/legendasnet/: uses the Legendas.net API for Brazilian Portuguese movie and episode subtitles.
• providers/moviesubtitles/: scrapes Moviesubtitles.org movie subtitle listings and multipart downloads.
• providers/napisy24/: uses the Napisy24 hash API for Polish movie and episode subtitles.
• providers/my_subs/: scrapes My-Subs.co movie and episode subtitle listings.
• providers/napiprojekt/: searches NapiProjekt Polish subtitles by hash and catalog pages, with ai-cloudscraper, inline Anubis solving, and optional FlareSolverr fallback for catalog Cloudflare challenges.
• providers/nekur/: scrapes Nekur Latvian movie subtitle listings and archive downloads.
• providers/opensubtitles_org/: scrapes OpenSubtitles.org natively with ai-cloudscraper, inline Anubis solving, and optional FlareSolverr fallback.
• providers/opensubtitlescom/: uses the official OpenSubtitles.com API for movie and episode subtitles.
• providers/prijevodionline/: scrapes Prijevodi-Online episode subtitle listings and archive downloads.
• providers/regielive/: uses the RegieLive Bazarr API for Romanian movie and episode subtitles, with public HTML search fallback when the API rejects a request.
• providers/shooter/: queries Shooter.cn's hash-based API for English and Chinese movie and episode subtitles.
• providers/smoke/: deterministic no-network smoke provider for install and worker checks.
• providers/soustitreseu/: scrapes Sous-Titres.eu movie and episode subtitle listings and archive downloads.
• providers/subcentral/: scrapes SubCentral.de forum threads for German and English episode subtitles.
• providers/subclub/: scrapes Subclub.eu movie and episode subtitle listings and downloads.
• providers/subdl/: uses the official SubDL API for movie and episode subtitles with optional anime pack handling.
• providers/subf2m/: scrapes SubF2M movie and episode subtitle pages and ZIP downloads.
• providers/subs4free/: scrapes Subs4Free movie subtitle listings and anti-block downloads.
• providers/subs4series/: scrapes Subs4Series episode subtitles with ai-cloudscraper, inline Anubis solving, optional FlareSolverr fallback, anti-block requests, optional captcha helper settings, and archive extraction.
• providers/subhd/: scrapes SubHD.tv Chinese-first movie and episode subtitle pages.
• providers/subsarr/: connects to a configured self-hosted Subsarr API.
• providers/subsource/: uses the official SubSource API for movie and episode subtitles.
• providers/subsynchro/: scrapes SubSynchro French movie release subtitle ZIP files.
• providers/subtis/: queries api.subt.is for Spanish movie subtitles using hash, size, filename, and alternative lookups.
• providers/subtitrarinoi/: scrapes subtitrari-noi.ro Romanian movie and episode subtitle downloads.
• providers/subtitlestar/: scrapes subtitlestar.com for Persian/Farsi movie and episode subtitles.
• providers/subtitriid/: scrapes subtitri.do.am for Latvian movie subtitles.
• providers/subtitulamostv/: scrapes subtitulamos.tv for episode subtitle pages and direct downloads.
• providers/sub_scene/: scrapes sub-scene.com (Subscene clone) for movie and episode subtitles in 35+ languages including Vietnamese, Arabic, Bengali, Danish, Dutch, using ai-cloudscraper, inline Anubis solving, and optional FlareSolverr fallback.
• providers/subsro/: uses the Subs.ro API for Romanian and English movie and episode subtitles with API-key authentication.
• providers/subssabbz/: scrapes subs.sab.bz for Bulgarian and English movie and episode subtitles with ZIP and RAR downloads.
• providers/subsunacs/: scrapes subsunacs.net for Bulgarian and English movie and episode subtitles with direct entry pages plus ZIP, RAR, and 7Z downloads.
• providers/subx/: uses the SubX API for Spanish movie and episode subtitles with API-key authentication.
• providers/subtitlecat/: first production community provider, scrapes subtitlecat.com using stdlib only. Worked example referenced by docs/writing-a-scraper-provider.md.
• providers/yavkanet/: scrapes Yavka.net by IMDb id, including ai-cloudscraper, inline Anubis solving, Cloudflare fallback, and archive downloads.
• providers/supersubtitles/: scrapes feliratok.eu Hungarian and English movie and episode subtitle listings.
• providers/titrari/: scrapes Titrari.ro movie and episode subtitle listings, including ZIP and RAR downloads.
• providers/titlovi/: uses the Titlovi Kodi API for authenticated movie and episode subtitle search and downloads.
• providers/turkcealtyaziorg/: scrapes TurkceAltyazi.org movie and episode subtitle listings by IMDb id.
• providers/tvsubtitles/: scrapes tvsubtitles.net episode subtitle listings and ZIP downloads.
• providers/wizdom/: uses wizdom.xyz for Hebrew movie and episode subtitles, with TMDB lookup when an IMDb id is missing. Uses ai-cloudscraper with inline Anubis solving and optional FlareSolverr fallback for Cloudflare browser challenges.
• providers/whisperai/: generates subtitles through a configured Whisper web service after extracting local audio with ffmpeg.
• providers/yifysubtitles/: scrapes YIFYSubtitles movie subtitle pages and ZIP downloads.
• providers/zimuku/: scrapes Zimuku / srtku.com for Chinese and English movie and episode subtitles, with native Yunsuo image verification and optional helper settings.
• sdk/: standalone authoring tools and templates, see the SDK reference.
• providers/titulky/: scrapes Titulky.com Czech and Slovak movie and episode subtitle listings and archive downloads.
• tests/: catalog validation tests that do not import Bazarr internals.

Want to add another subtitle source? Start with the full walkthrough:

→ docs/writing-a-scraper-provider.md

Adding providers in batches? Use the practical checklist:

→ docs/provider-bulk-creation-guide.md

The 5-minute version:

cp -R sdk/templates providers/myprovider
$EDITOR providers/myprovider/provider.json providers/myprovider/provider.py
python3 -B -m sdk build-catalog
python3 -B -m sdk validate
python3 -B -m sdk smoke-test --provider myprovider --config-json '{"api_token":"dev-token"}' --skip-download
python3 -B -m unittest discover -s tests

Use providers/smoke/ for the manifest reference and providers/subtitlecat/ for a real scraping pattern.

python3 -B -m sdk build-catalog   # regenerate catalog.json from all provider manifests
python3 -B -m sdk validate        # validate manifests, hashes, schema
python3 -B -m sdk runtime-matrix  # print supported Bazarr+ Python runtimes
python3 -B -m sdk smoke-test      # exercise a provider against the worker contract
python3 -B -m unittest discover -s tests

Provider Hub workers target the Bazarr+ Python runtime range >=3.12,<3.15: Python 3.12, 3.13, and 3.14. Python 3.11 is not the compatibility floor for this catalog.

Pure wheels such as py3-none-any can be covered by one hash. ABI-specific wheels need hashes for every supported ABI tag, currently cp312, cp313, and cp314, or a compatible stable-ABI wheel such as cp311-abi3, on every Bazarr+ platform the provider is expected to install on. Check the current policy with:

python3 -B -m sdk runtime-matrix

Provider manifests declare pure Python .py files only. Dependencies, when needed, must be pinned wheel requirements with SHA256 hashes. See the SDK reference.

Pull requests welcome. A good provider PR:

• Adds providers/<id>/provider.py and providers/<id>/provider.json.
• Adds tests/test_<id>.py exercising query building, parsing, scoring, and the search/download flow against captured HTML fixtures in tests/fixtures/.
• Bumps and regenerates catalog.json (python3 -B -m sdk build-catalog).
• Passes python3 -B -m sdk validate and python3 -B -m unittest discover -s tests.
• Follows the patterns in docs/writing-a-scraper-provider.md and the bulk checklist in docs/provider-bulk-creation-guide.md.

• Bazarr+: the enhanced Bazarr fork that consumes this catalog. Adds AI translation via OpenRouter, OpenSubtitles.org scraper, provider priority, API key encryption, batch translation, mass subtitle sync, advanced filters, and security hardening.
• Bazarr+ Documentation
• Bazarr (upstream)

_{Keywords: bazarr, bazarr+, bazarr plus, subtitle provider, subtitle plugin, subtitle scraper, subtitlecat, subtitles, jellyfin, plex, emby, radarr, sonarr, opensubtitles, provider hub, python plugin, subtitle automation.}