Bazarr Automated Your Subtitle Hell (Here’s How)

You know that moment when you fire up a movie and realize the subtitles are synced two seconds off, or worse, they’re in the wrong language entirely? Yeah, that’s the problem Bazarr solves. And it’s so good at solving it that manually managing subtitles afterward feels like choosing to use Internet Explorer in 2024.

If you’re running a homelab with Sonarr and Radarr, you’re already halfway there. Bazarr slots into that stack like it was always meant to be there — it watches your library, grabs subtitles automatically, and handles the matching so perfectly you’ll forget subtitles are even a thing that needs managing.

Why Bazarr Is the Glue Your *Arr Stack Actually Needs

Here’s the honest truth: Sonarr and Radarr are incredible at what they do, but they stop at downloads. Your fresh 4K encode of *The Matrix Resurrections* arrives without subtitles, and now you’re stuck either digging through OpenSubtitles manually or settling for whatever garbage first-match offers.

Bazarr fixes this by being obsessively smart about subtitle matching. It doesn’t just grab the first .srt file with the right name — it uses intelligent algorithms to match based on file hash, file size, duration, and frame rate. This means your subtitles actually sync. No more spending the first 20 minutes adjusting timings in VLC.

The real kicker? It supports 60+ languages, pulls from multiple providers (OpenSubtitles, Addic7ed, Podnapisi, you name it), and has a slick web UI that just works. I’ve been running it for six months and haven’t manually downloaded a single subtitle since setup.

The killer feature: Pair it with Whisper and Bazarr will actually generate subtitles from scratch if nothing good exists online. Sit that on top of the automation and you’ve basically got subtitle sorcery.

The Install (It’s Stupidly Easy in Docker)

If you’re already running Sonarr and Radarr in Docker, this takes literally five minutes.

version: '3.8'
services:
  bazarr:
    image: ghcr.io/morpheus65535/bazarr:latest
    container_name: bazarr
    restart: unless-stopped
    ports:
      - "6767:6767"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - ./bazarr/config:/config
      - /path/to/your/media/shows:/shows
      - /path/to/your/media/movies:/movies
    networks:
      - arr-network

networks:
  arr-network:
    external: true

Already running a reverse proxy like Traefik? Just add the labels:

labels:
  - "traefik.enable=true"
  - "traefik.http.routers.bazarr.rule=Host(`bazarr.your-domain.com`)"
  - "traefik.http.services.bazarr.loadbalancer.server.port=6767"

Start it up, hit `http://localhost:6767`, and you’re in the initial setup wizard. Takes about two minutes. Configure your media paths, pick your languages, choose your subtitle sources — and you’re done.

Pro tip: If your Sonarr and Radarr are on the same Docker network, Bazarr auto-discovers them. No manual API keys needed.

The Setup That Actually Matters

Out of the box, Bazarr works fine. But here’s where you tweak it into being genuinely excellent:

• Enable Subliminal Plus. This is the intelligent matching engine I mentioned. Leave it on. Period.
• Set up multiple providers. Don’t rely on just OpenSubtitles. Add Addic7ed, Podnapisi, and Subscene. Redundancy means you almost always find something.
• Configure automatic synchronization. Bazarr can auto-sync slightly off subtitles. It’s not perfect, but it catches most cases and saves you manual adjustment.
• Use Whisper for the gaps. If you want AI-generated subtitles when nothing exists, integrate Whisper. This is where Bazarr becomes genuinely future-proof.

Head into Settings → Languages and pick your defaults. I run English + French, but you’ll customize to your household. Once set, Bazarr automatically hunts for subtitles in those languages whenever Sonarr or Radarr adds something new.

The magic happens in Settings → Subtitles. Here you’re configuring sync tolerance, choosing whether to prefer hearing-impaired tracks, and deciding if you want to automatically grab subtitles for existing files (not just new ones). Check that box if you want Bazarr to retroactively subtitle your entire library — it’ll take a few hours depending on size, but it’s worth it.

Integration With the Rest of Your Homelab

Bazarr plays nicely with everything. Sonarr and Radarr integrate seamlessly — it listens for their webhooks and acts instantly when new content drops. You can also expose Bazarr to Home Assistant for automation.

Running Tailscale for remote access? Bazarr works perfectly through it. Need to monitor if subtitle downloads are failing? Set up a simple check in Uptime Kuma pointing to the Bazarr API.

If you’re neurotic about resource usage (and you should be in a homelab), Bazarr is lightweight. It idles around 50-100MB of RAM and barely touches CPU unless actively searching. On an older Proxmox box? Doesn’t matter. It’ll run fine.

The One Thing to Watch Out For

Subtitle provider APIs can be flaky. Sometimes OpenSubtitles rate-limits you. Sometimes Addic7ed is down. This is why having multiple sources configured matters — Bazarr will hammer through them in order until something sticks.

Also, if you’re running Whisper integration for AI-generated subtitles, that eats CPU and storage. Don’t enable it on a Pi Zero. A modern CPU can handle it, but know what you’re getting into.

The bigger gotcha? Make sure your media library paths in Bazarr exactly match what Sonarr and Radarr are using. Mismatch there and Bazarr won’t find your files. Spend two minutes verifying this during setup and save yourself hours of troubleshooting later.

Why This Became My Homelab Gold Standard

Before Bazarr, I was that guy hunting subtitles on my phone while media was playing. Now? Everything just works. New episode of *The Boys* drops, Sonarr grabs it, Bazarr silently downloads perfect subtitles in the background, and by the time I sit down to watch, everything’s ready.

It’s not flashy. It doesn’t do anything visually impressive. But it solves a genuine problem so completely that you’ll forget it’s even running — which is exactly what you want from a homelab tool.

If you’re running Sonarr and Radarr without Bazarr, you’re leaving money on the table (well, time on the table). Set it up this weekend, let it run for a month, and you’ll understand why everyone with a real media library recommends it.

Explore Bazarr in our AI Homelab Toolkit.