| name | bazarr |
| description | This skill should be used when the user wants to manage subtitles in Bazarr. Triggers include: "missing subtitles", "wanted subtitles", "search subtitles", "download subtitles", "subtitle providers", "Bazarr status", "what subtitles are missing", "find subtitles for", or any mention of subtitle management for movies or TV series. |
Bazarr Subtitle Management Skill
Inspect and trigger subtitle downloads in Bazarr for your Radarr movies and
Sonarr series via the Bazarr REST API.
Purpose
- List movies/series with wanted (missing) subtitles
- Trigger a subtitle search for a specific movie or episode
- List configured subtitle providers and their health
- Check Bazarr system status and badges (counts of wanted items)
All operations are read or search/refresh actions. Bazarr itself decides which
subtitle file to download; this skill triggers the search and reports results.
Setup
Credentials are configured in the bazarr plugin settings (userConfig). A
SessionStart hook writes them to ~/.config/lab-bazarr/config.env, which the
script loads automatically — no manual file editing. Variables used:
BAZARR_URL="http://localhost:6767"
BAZARR_API_KEY="your-api-key"
BAZARR_URL: Bazarr base URL (no trailing slash)
BAZARR_API_KEY: API key from Bazarr (Settings -> General -> Security -> API Key), sent as the X-API-KEY header
Commands
Run commands from this skill directory.
System status / badges
bash scripts/bazarr-api.sh status
bash scripts/bazarr-api.sh badges
Wanted (missing) subtitles
bash scripts/bazarr-api.sh wanted-movies
bash scripts/bazarr-api.sh wanted-series
Providers
bash scripts/bazarr-api.sh providers
Trigger a subtitle search
bash scripts/bazarr-api.sh search-movie <radarrId>
bash scripts/bazarr-api.sh search-episode <sonarrEpisodeId>
Raw GET (escape hatch)
bash scripts/bazarr-api.sh get "/api/system/status"
Workflow
- "What subtitles are missing?" ->
wanted-movies and wanted-series
- "Find subtitles for " -> identify the Radarr id, then
search-movie <id>
- "Which providers are configured?" ->
providers
- "Is Bazarr healthy?" ->
status
Notes
- Requires network access to your Bazarr server.
- Auth header is
X-API-KEY (not a query string). Never put the key in a URL.
- Bazarr ties items to their Radarr/Sonarr ids; use the radarr/sonarr skills to resolve titles to ids.
- Endpoint paths and parameters were authored from general knowledge and vary
across Bazarr versions. Before relying on the search/write commands, confirm
the exact paths against your instance's in-app API browser (Settings shows the
API; some builds expose
/api/swagger). If a call returns 404, adjust the path
to match your version. The search-movie / search-episode ids must be numeric.
Reference