This plugin integrates Jellyfin with Bazarr to provide on-demand subtitle searching and downloading. Instead of navigating to Bazarr's web UI, users can search and download subtitles directly from Jellyfin's native subtitle interface.

• Native Integration - Uses Jellyfin's built-in subtitle search UI
• Movies & Episodes - Full support for both content types
• Smart Caching - Results cached for 1 hour to avoid repeated searches
• Background Search - Long searches continue in background, UI stays responsive
• One-Click Download - Select and download subtitles instantly
• Auto-Refresh - Library automatically refreshes after download

1. Edit subtitle

2. Choose language, and hit search

3. If the search takes longer than your set value (default 25 seconds), this placeholder pops up.

flowchart TB
    subgraph media[Shared Media Folders]
        folders["/movies    /tv"]
    end
    
    subgraph arr[*arr Stack]
        sonarr["Sonarr (:8989)"]
        radarr["Radarr (:7878)"]
        bazarr["Bazarr (:6767)"]
        sonarr --> bazarr
        radarr --> bazarr
    end
    
    subgraph jf[Jellyfin]
        plugin[Bazarr Plugin]
    end
    
    bazarr -->|writes subtitles| media
    media -->|reads| jf
    plugin <-->|API| bazarr

flowchart TB
    A[User clicks Search] --> B[Plugin receives IMDB/TVDB ID]
    B --> C[Lookup Bazarr ID]
    C --> D[Search subtitles]
    D --> E{Results within 25s?}
    E -->|Yes| F[Return subtitle list]
    E -->|No| G[Return placeholder]
    G --> H[Search continues in background]
    H --> I[Results cached 1 hour]
    I --> J[Click Search again]
    J --> F

flowchart TB
    A[Select subtitle] --> B[Plugin decodes ID]
    B --> C[POST to Bazarr]
    C --> D[Bazarr downloads .srt]
    D --> E[Trigger library refresh]
    E --> F[Subtitle in player]

From Repository (Recommended)

1. Go to Dashboard → Plugins → Repositories
2. Add: https://raw.githubusercontent.com/enoch85/bazarr-jellyfin/main/manifest.json
3. Install "Bazarr" from Catalog
4. Restart Jellyfin

Manual Installation

1. Download latest release from GitHub Releases
2. Extract to plugins directory:
   • Linux: ~/.local/share/jellyfin/plugins/Bazarr/
   • Docker: /config/plugins/Bazarr/
   • Windows: %AppData%\Jellyfin\plugins\Bazarr\
3. Restart Jellyfin

Navigate to Dashboard → Plugins → Bazarr:

Click Test Connection to verify your settings.

• .NET 10.0 SDK
• Jellyfin Server 12.0+ for testing

git clone https://github.com/enoch85/bazarr-jellyfin.git
cd bazarr-jellyfin
dotnet build

dotnet test                 # unit tests
dev-env/e2e/run-e2e.sh      # Playwright tests against a real Jellyfin server

See dev-env/e2e/README.md for what the end-to-end suite provisions.

git tag -a v1.x.x -m "Description" && git push origin v1.x.x

The GitHub Actions workflow automatically builds and publishes the release.

If Bazarr is behind an authentication proxy (Authentik, Authelia, Keycloak, etc.), the plugin cannot authenticate with OAuth2 - it only has an API key for Bazarr.

Solution: Bypass authentication for Bazarr's API paths.

http:
  routers:
    bazarr-api:
      rule: "Host(`bazarr.example.com`) && PathPrefix(`/api`)"
      service: bazarr
      # No authentik middleware - direct access
    bazarr-ui:
      rule: "Host(`bazarr.example.com`)"
      service: bazarr
      middlewares:
        - authentik
      priority: 1

location /api/ {
    proxy_pass http://bazarr:6767/api/;
    # No auth for API
}

location / {
    proxy_pass http://bazarr:6767/;
    auth_request /auth;
}

Use the internal container name instead of the external URL:

Plugin config: http://bazarr:6767
Browser access: https://bazarr.example.com (with auth)

Don't worry - this is safe:

• Internal URLs (localhost, http://bazarr:6767) never leave your machine/Docker network
• Bazarr's API key still protects all API endpoints, even without the auth proxy
• You're only bypassing the external authentication layer, not removing security

This is normal - Bazarr is querying multiple providers which takes time. Wait 5-15 minutes and click Search again to see cached results.

The row's comment carries Bazarr's own message. The most common one is All providers are throttled: a provider hit its rate or download limit - often right after a download - so Bazarr benched it for 1-3 hours. Check Bazarr → System → Providers for the retry time, or enable more providers.

The plugin triggers a library refresh after download. If it still doesn't appear:

1. Manually refresh the item in Jellyfin
2. Check that Bazarr successfully downloaded the file to the media folder

Ensure the item exists in Radarr/Sonarr and Bazarr has synced. The plugin matches movies by IMDB ID, and episodes by series TVDB/IMDB ID or title.

See Reverse Proxy Setup if using an authentication proxy.

Otherwise, verify your URL format:

• Use base URL: http://localhost:6767 (not http://localhost:6767/api)
• Check network access from Jellyfin to Bazarr
• Test: http://your-bazarr-url/api/system/languages should return JSON, not HTML

GPLv3

Contributions welcome! Please open an issue or PR on GitHub.