Logo of wyzie-docsWyzie Docs
DiscordDonate

wyziedevs/wyzie-subs

--

Donations

Donate

Wyzie Subs

IntroductionSources
Usage
NPM PackageDirect FetchingAI TranslationAPI Keys

Plugins

OverviewStremioBazarrKodi

Wyzie Proxy

IntroductionHosting

i6.shark

IntroductionHosting

Plugins

Bazarr Provider#

Bazarr manages subtitles for Plex, Jellyfin, Emby, Sonarr, and Radarr in one place. Adding Wyzie as a provider gives all of those servers access to OpenSubtitles, SubDL, and Podnapisi through a single key.

This is the recommended way to use Wyzie with Plex and Jellyfin. Bazarr downloads subtitle files next to your media, and your server picks them up automatically, so no separate native plugin is required.

Before you start#

Get a free Wyzie API key at store.wyzie.io/redeem, and have access to your Bazarr install files (typical Docker path: /opt/bazarr/bazarr/).

Install#

  1. Copy wyzie.py to bazarr/subliminal_patch/providers/wyzie.py.
  2. Edit bazarr/subliminal_patch/extensions.py and add wyzie to both provider_registry and provider_manager.
  3. Edit bazarr/list_subtitles.py (or bazarr/config.py, depending on your version) to expose the api_key, prefer_hi, and sources settings. Copy the pattern from an existing provider such as opensubtitlescom.
  4. Restart Bazarr.
  5. Go to Settings, Providers, Wyzie, paste your API key, and save.

A first-class pull request upstreaming this provider into Bazarr is planned. Until then it is a drop-in file you add to your own install.

Configuration#

FieldDefaultDescription
api_key—Your Wyzie key. Required.
prefer_hifalsePrefer hearing-impaired subtitles.
sourcesallComma-separated list of providers to query, or all.

When your quota runs out#

  • 402 or 429 (balance empty or daily cap hit): Bazarr logs a note with a link to store.wyzie.io and returns no results, so it cleanly falls back to your other providers. Nothing crashes.
  • 401 (bad key): Bazarr surfaces an authentication error so you know to re-enter the key.

Troubleshooting#

  • Wyzie does not appear in the providers list. Re-check the install step that edits extensions.py; the entry must be in both provider_registry and provider_manager, then restart Bazarr.
  • No subtitles found. Confirm the item has an IMDB ID in Bazarr and that the languages you have enabled have subtitles for it. Only narrow sources if you intend to.
  • Settings fields missing. The settings step was not applied for your Bazarr version; compare against a working provider settings block and restart.