Bazarr

Automated subtitle management for Sonarr and Radarr

Bazarr is a companion application to Sonarr and Radarr. It manages and downloads subtitles based on your requirements. You define your preferences by TV show or movie and Bazarr takes care of everything for you—from downloading to syncing and organizing subtitles automatically.

Installation

Install from the Dashboard

Open App Dashboard → Package Management (/dashboard?mode=packages), find Bazarr in the catalog (browse Media Management or search), and click Install. The dashboard streams the install log live and Bazarr appears in your Application Control panel when it finishes. Reinstall, Update, and Remove are available from the same panel.

For subtitles on a dedicated 4K library, install Bazarr4K — a separate instance with its own port, configuration (/username/bazarr4k), and language profiles, so your standard and 4K subtitle workflows never conflict. It appears as its own catalog entry in Package Management; on the CLI it is the --4k flag on qb install bazarr (see below).

What you see and can manage is gated by your account: admins manage any user’s apps; regular users manage their own. For the full package flow see App Management.

Install and manage from the CLI

The CLI runs the same scripts as the Dashboard and is the full power-user/automation surface. Install Bazarr for a specific user:

qb install bazarr -u username

The complete command set:

Full flag reference: CLI Reference.

Accessing Bazarr

After installation, access Bazarr at:

Standard installation:

https://your-server-ip/username/bazarr

4K instance:

https://your-server-ip/username/bazarr4k

Initial Configuration

1. Connect to Sonarr & Radarr

Link Bazarr to your *arr apps for automatic subtitle management:

Sonarr:

1. Settings → Sonarr
2. Click Add Sonarr (+)
3. Enter connection details:
   • Address: http://localhost:8989
   • API Key: Copy from Sonarr (Settings → General → Security → API Key)
   • URL Base: /username/sonarr
4. Test connection and save

Radarr:

1. Settings → Radarr
2. Click Add Radarr (+)
3. Enter connection details:
   • Address: http://localhost:7878
   • API Key: Copy from Radarr (Settings → General → Security → API Key)
   • URL Base: /username/radarr
4. Test connection and save

2. Configure Subtitle Providers

Add subtitle providers for downloading:

1. Settings → Providers
2. Click Add Provider (+)
3. Select provider (OpenSubtitles, Subscene, etc.)
4. Enter credentials (if required)
5. Set provider priority

Popular Providers:

• OpenSubtitles - Large database, requires free account
• Subscene - Quality subtitles, no account needed
• Addic7ed - Excellent for TV shows, requires account
• Podnapisi - Good coverage, no account needed

3. Set Language Profiles

Configure subtitle language preferences:

1. Settings → Languages
2. Create language profile
3. Select desired languages
4. Set fallback languages (optional)
5. Configure forced subtitle options

Example Profile:

• Primary: English
• Secondary: English (Forced)
• Fallback: Spanish

4. Enable Automatic Search

Configure automatic subtitle downloads:

1. Settings → Sonarr/Radarr
2. Enable Download Only Monitored
3. Set Automatic Search:
   • When episode/movie is added
   • When episode/movie is upgraded
   • On schedule (every X hours)

Service Management

Bazarr runs as a systemd service for reliability and automatic startup.

Standard installation:

systemctl status bazarr@username     # Check status
systemctl restart bazarr@username    # Restart service
journalctl -u bazarr@username -f     # View live logs
systemctl enable bazarr@username     # Start on boot
systemctl disable bazarr@username    # Prevent auto-start

4K instance:

systemctl status bazarr4k@username
systemctl restart bazarr4k@username
journalctl -u bazarr4k@username -f

Troubleshooting

Bazarr Won’t Start

journalctl -u bazarr@username -f

Check for port conflicts:

grep 'port:' ~/.config/Bazarr/config/config.yaml
# Default: 6700

Subtitles Not Downloading

Provider Rate Limiting

# Check provider status
# Settings → Providers → View provider stats
 
# Adjust rate limits per provider
# Edit Provider → Advanced → Rate Limit

Permission Issues

qb fix permissions -u username
systemctl restart bazarr@username

Python Virtual Environment Issues

# Verify virtual environment exists
ls -la /opt/username/lib/python/Bazarr/.venv
 
# Reinstall to recreate venv
qb reinstall bazarr -u username

Best Practices

Related Applications

Additional Resources