# Bazarr

**🟢 Media Service**

## Service Overview

| Property | Value |
|----------|-------|
| **Service Name** | bazarr |
| **Host** | Atlantis (Synology) |
| **Category** | Media / Subtitles |
| **Docker Image** | `lscr.io/linuxserver/bazarr:latest` |
| **Compose File** | `hosts/synology/atlantis/arr-suite/docker-compose.yml` |
| **URL** | http://192.168.0.200:6767 |
| **Version** | 1.5.6 |

## Purpose

Bazarr is the subtitle companion to Sonarr and Radarr. It monitors your library for missing or
wanted subtitles, searches configured providers, and downloads them automatically. It syncs
directly with Sonarr/Radarr via SignalR so new items trigger subtitle searches immediately.

## API Access

| Field | Value |
|-------|-------|
| **URL** | http://192.168.0.200:6767 |
| **API Key** | `REDACTED_BAZARR_API_KEY` |
| **Header** | `X-Api-Key: "REDACTED_API_KEY"` |

```bash
BAZARR="http://192.168.0.200:6767"
BAZARR_KEY="REDACTED_BAZARR_API_KEY"

# System status and version
curl -s "$BAZARR/api/system/status" -H "X-Api-Key: $BAZARR_KEY" | python3 -m json.tool

# Health check
curl -s "$BAZARR/api/system/health" -H "X-Api-Key: $BAZARR_KEY" | python3 -m json.tool

# Missing subtitles count
curl -s "$BAZARR/api/badges" -H "X-Api-Key: $BAZARR_KEY" | python3 -m json.tool

# List missing episode subtitles
curl -s "$BAZARR/api/episodes/wanted" -H "X-Api-Key: $BAZARR_KEY" | python3 -m json.tool

# List missing movie subtitles
curl -s "$BAZARR/api/movies/wanted" -H "X-Api-Key: $BAZARR_KEY" | python3 -m json.tool
```

## Current Status (2026-03-02)

- Sonarr SignalR: **LIVE**
- Radarr SignalR: **LIVE**
- Missing episode subtitles: 846
- Missing movie subtitles: 6
- Provider issues: 0

## Configuration

### Docker Compose (in docker-compose.yml)

```yaml
bazarr:
  image: lscr.io/linuxserver/bazarr:latest
  container_name: bazarr
  environment:
    - PUID=1029
    - PGID=100
    - TZ=America/Los_Angeles
    - UMASK=022
    - DOCKER_MODS=ghcr.io/themepark-dev/theme.park:bazarr
    - TP_SCHEME=http
    - TP_DOMAIN=192.168.0.200:8580
    - TP_THEME=dracula
  volumes:
    - /volume2/metadata/docker2/bazarr:/config
    - /volume1/data:/data
  ports:
    - "6767:6767"
  networks:
    media2_net:
      ipv4_address: 172.24.0.x
  security_opt:
    - no-new-privileges:true
  restart: always
```

Config on Atlantis: `/volume2/metadata/docker2/bazarr/config/config.yaml`

Note: The API key is stored in `config.yaml` on Atlantis (not in this repo). Retrieve it with:
```bash
grep "apikey" /volume2/metadata/docker2/bazarr/config/config.yaml
```

## Connected Services

| Service | Connection | Status |
|---------|-----------|--------|
| Sonarr | SignalR + API | LIVE |
| Radarr | SignalR + API | LIVE |

Bazarr connects *to* Sonarr/Radarr (not the reverse). Configure under
Settings → Sonarr and Settings → Radarr in the Bazarr UI.

## Troubleshooting

**SignalR shows CONNECTING or DISCONNECTED**
- Verify Sonarr/Radarr are running: `docker ps | grep -E 'sonarr|radarr'`
- Check the host/API key in Bazarr Settings → Sonarr/Radarr
- Restart Bazarr: `docker restart bazarr`

**No subtitle providers**
- Check badges: `providers` field should be 0 for no errors
- Go to Settings → Providers in the Bazarr UI to configure providers (OpenSubtitles, etc.)

**Subtitle not found for a specific episode**
- Go to the episode in Bazarr → Manual Search to browse provider results
- Check the episode language profile matches what providers offer

## Related Services

- Sonarr — http://192.168.0.200:8989
- Radarr — http://192.168.0.200:7878
- See also: `docs/services/individual/download-priority.md` for the NZB-first strategy