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