# Bazarr

Bazarr is the subtitle layer of the Arrs stack. It connects to your existing [Radarr](</app/radarr/>) and [Sonarr](</app/sonarr/>) libraries, monitors what subtitles are missing, fetches them from configured providers (*OpenSubtitles, Addic7ed, Subscene, Podnapisi, and more*), and renames them to match your media files so Plex / Jellyfin / Emby pick them up automatically.

**When does managed Bazarr make sense?**

- **Family households** where some viewers prefer or require subtitles (*kids learning to read, hearing-impaired family members, anyone watching with the sound down*).
- **Multilingual setups**: Bazarr can fetch subtitles in multiple languages per title, so the same library serves a household with mixed language preferences.
- **Foreign-language content** where you want translated subs in your preferred language, not just the original.
- **Sync correction**: Bazarr can re-sync subtitles to fix offset issues automatically, including audio-derived sync via Whisper.

## How to wire it up on ElfHosted

1. **Open Bazarr from your apps dashboard.** SSO is handled, no extra login needed.
2. **Connect your Radarr and Sonarr.** Settings → Sonarr / Radarr → enter the in-cluster URL (`http://radarr:7878`, `http://sonarr:8989`) and your API key. ElfHosted's apps share a network so they reach each other by name.
3. **Configure subtitle providers.** OpenSubtitles is free with rate limits; OpenSubtitles VIP and Addic7ed accounts get higher quotas. Add multiple providers for fallback coverage.
4. **Set language profiles** per series and movie. Default a "must-have" language for everything, optional secondary languages where it matters.
5. **Run the initial scan.** Bazarr crawls the library and queues fetches for everything missing. First pass takes a while; after that, it's incremental.

## What's not in scope

Bazarr fetches subtitle files; it doesn't transcode or hard-burn subs into video. Plex / Jellyfin / Emby pick up the `.srt` / `.ass` files alongside the media and offer them as soft-subtitle tracks at playback time.

> [!NOTE]
>
> **Info**
>
> Bazarr is an open-source tool. ElfHosted provides hosting infrastructure only. Users are responsible for their use of this service in compliance with applicable laws and third-party terms of service.

[Get a 7-day trial of ElfHosted Bazarr! 🪄](<https://store.elfhosted.com/product/bazarr-hd/>)

## How do I access Bazarr?

Bazarr is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-bazarr.elfhosted.com](<https://your-username-bazarr.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/bazarr/>) and these become your personal, clickable links.

## How do I get Bazarr notifications on my phone?

Install [Sam](</app/sam/>), the assistant bundled with your account, and he pushes Bazarr's notifications to your phone.

Bazarr uses Apprise for notifications, so add this as an Apprise URL:

```
ntfy://elfbot:3000/bazarr
```

The address only works from inside your own account, and the name on the end is what Bazarr gets called in Sam.

Then open Sam on your phone, install him, and turn on notifications. The first alert is held so Sam can ask whether you want to hear from Bazarr at all, and every app gets its own switch, so you can mute one without losing the rest.

See [Sam](</app/sam/>) for the other formats, and for what happens when you tap an alert.

## Bazarr also works with

- [x] [Radarr](</app/radarr/>)
- [x] [Sonarr](</app/sonarr/>)

## How do I get support for Bazarr?

1. For general use of Bazarr, refer to the [official site](<https://www.bazarr.media/>) or to one of the links in the resources section below.
2. For specific support re your ElfHosted configuration / account, see the [ElfHosted support options](</get-help/>)!

## Sponsor Bazarr ❤️

You can contribute directly to the development of Bazarr using the following:

- [PayPal](<https://www.paypal.com/donate/?cmd=_s-xclick&amp;hosted_button_id=XHHRWXT9YB7WE&amp;source=url&amp;ssrt=1704275763056>)

## Bazarr resources

- [Bazarr (*official site*)](<https://www.bazarr.media/>)
- [Bazarr wiki](<https://wiki.bazarr.media>)
- [Bazarr subreddit](<https://www.reddit.com/r/bazarr/>)
- [Bazarr Discord](<https://discord.com/invite/MH2e2eb>)

> [!NOTE]
>
> **Your content, your responsibility**
>
> ElfHosted provides Bazarr as a hosted application — we do not supply content, accounts, or third-party credentials. You are responsible for ensuring that your use of this app complies with applicable laws and our [Acceptable Use Policy](</legal/acceptable-use/>). If you have questions about what is or isn't permitted, please [reach out](</get-help/>) — we're happy to help.