§ 01 · Plugin · One-Line Filed 2026.04.21 · Edition 01

Bazarr+
Subtitles

A Jellyfin 10.11+ subtitle-provider plugin that proxies searches and downloads to a self-hosted Bazarr+ instance over its OpenSubtitles-compatible REST API. Configure subtitle providers once in Bazarr+; reuse them from every media server on your LAN, without pasting credentials into each one.

§ 02

What / Architecture

One backend. Every media server.

Subtitle providers,
configured once.

The problem. Jellyfin ships native subtitle providers, each with its own credentials, its own rate-limit accounting, its own retry logic. Every provider you add is one more thing to configure inside Jellyfin. The same story plays out on every other media server on your LAN.

Bazarr+ is a self-hosted subtitle orchestration service. It aggregates multiple subtitle providers behind a single endpoint, exposes them over an OpenSubtitles-compatible REST API at /api/v1/*, centralises credentials and rate-limit budgets, caches search results, and fans requests out in parallel with dedup and ranking. Your Jellyfin library inherits every provider you’ve configured in Bazarr+, with zero extra setup on the Jellyfin side.

This plugin is the Jellyfin side of that conversation. Point it at your Bazarr+ URL, paste its token, and every provider enabled in Bazarr+’s Settings → Subtitles Sources becomes one search away from inside Jellyfin’s subtitle pipeline.

DATA FLOW per subtitle search

JELLYFIN                    (media server, asks for subs)
   ↓  SubtitleSearchRequest
   ↓
THIS PLUGIN                 (dll in Jellyfin plugins/)
   ↓  GET /api/v1/subtitles?imdb_id=…&languages=…
   ↓  POST /api/v1/download  {file_id}
   ↓
BAZARR+                     (compat endpoint)
   ↓  parallel fan-out
   ↓
PROVIDERS                   OpenSubtitles · subdl · Addic7ed
                            Podnapisi · Napiprojekt …

API Surface: endpoints the plugin calls from Jellyfin
Method	Path	Purpose
POST	/api/v1/login	Handshake. Returns a JWT and a user object with quota info.
GET	/api/v1/infos/languages	Supported language list. Cached locally for subsequent searches.
GET	/api/v1/subtitles	Unified search across all enabled Bazarr+ providers. Returns candidates ranked by match strength.
POST	/api/v1/download	Resolves a search result into a signed, short-lived stream URL plus remaining quota counters.
GET	/api/v1/download/stream/<tok>	Streams the actual subtitle bytes (SRT) back to Jellyfin’s subtitle pipeline.

§ 03

Manifest / Repository URL

Single source. One click. Copy.

Drop the URL.
Point at your LAN. Done.

Paste this into Jellyfin. It is the only URL you need.

https://LavX.github.io/jellyfin-plugin-bazarr-plus/manifest.json

Copied. Paste into Jellyfin Dashboard → Plugins → Repositories.

§ 04

Install / Three Steps

T + 60 seconds

Step 01

Add the repository

Open the Jellyfin admin dashboard. Under Plugins → Repositories, use the + button. Jellyfin treats external repos exactly like the default catalog; you can add as many as you want.

Dashboard→Plugins→Repositories→+

Step 02

Paste the manifest

Name the repository anything you like (Bazarr+ Subtitles is fine). For URL, paste the manifest from § 03. On save, Jellyfin fetches the JSON and the new plugin appears in the catalog within a few seconds.

Paste URL→Save

Step 03

Install and configure

Install Bazarr+ Subtitles from Jellyfin’s plugin catalog and restart when prompted. Open Dashboard → My Plugins → Bazarr+ Subtitles and paste your Bazarr+ URL and API Token. Finally, for every library that should receive subtitles, go to Dashboard → Libraries → [library] and tick Bazarr+ Subtitles in the Subtitle Downloaders list.

Install→Paste URL + Token→Enable on library

§ 05

Requirements / Spec Sheet

Self-hosted. Homelab. LAN.

Req 01 · Host: Jellyfin 10.11+ stableThe plugin targets the 10.11 plugin ABI (net9.0). It will not load into 10.10 or older.
Req 02 · Backend: Bazarr+ 2.2+ reachable over HTTP(S) LAN-okNeeds the External Integration endpoint enabled. Self-signed TLS is fine on a private network; the plugin doesn’t verify certificates on internal hosts.
Req 03 · Providers: At least one provider enabled in Bazarr+ Settings → Subtitles SourcesBazarr+ is the thing that actually talks to OpenSubtitles / subdl / Addic7ed / etc. If nothing is enabled there, searches return zero results.
Req 04 · Token: Bazarr+ API Token pasted into the plugin configShown in Bazarr+ Settings → External Integration. The plugin sends it as the Api-Key header on every request.

§ 06

Source & Related Projects

Plugin · Backend · Stack

§ 07

Troubleshooting

When the wire goes dark

401 UNAUTHORIZED

API token mismatch

The Bazarr+ token pasted into the plugin doesn’t match the one in Bazarr+’s Settings → External Integration. Regenerate the token in Bazarr+ and paste it back; the plugin re-authenticates on the next search.

503 AT STREAM

Upstream provider fetch failed

Search returned results but /download/stream/… returned 503. That’s Bazarr+’s upstream provider call failing: missing credentials, rate-limited, or the provider itself is down. Check Bazarr+ logs for the real error.

200 EMPTY RESULTS

No providers enabled

Searches succeed but return zero subtitles. Almost always means Bazarr+ has no providers enabled. Open Bazarr+’s Settings → Subtitles Sources and enable at least one (OpenSubtitles.com, subdl, Podnapisi, etc.); a background re-index may be needed before results flow.

HOST UNREACHABLE

Plugin can’t see Bazarr+

If Jellyfin runs in Docker and Bazarr+ runs on the host, localhost and 127.0.0.1 point at Jellyfin’s own container, not Bazarr+. Use the LAN IP, the host’s host.docker.internal, or place both containers on the same docker network and use the service name.

Self-signed TLS works on the LAN; the plugin does not enforce certificate verification against internal hosts.

Bazarr+Sub­titles.

Subtitle providers,configured once.

Drop the URL.Point at your LAN. Done.