Dispatcharr Integration

Teamarr creates and manages channels in Dispatcharr automatically. This guide covers initial setup and how the integration works day-to-day.

Initial Setup

1. Connect to Dispatcharr

1. Go to Settings > Dispatcharr
2. Enable the integration toggle
3. Enter your Dispatcharr URL (e.g., http://dispatcharr:9191)
4. Enter your Dispatcharr username and password
5. Click Test to verify the connection shows “Connected”
6. Click Save

2. Set Up EPG Source

1. Go to the EPG page in Teamarr and copy the XMLTV URL (e.g., http://teamarr:9195/api/v1/epg/xmltv)
2. In Dispatcharr, add a new EPG source using that URL
3. Back in Teamarr Settings > Dispatcharr, select your Teamarr EPG source from the dropdown
4. Click Save

3. Configure Defaults

While still in Settings > Dispatcharr, configure:

• Default Channel Profiles — which Dispatcharr profiles Teamarr channels appear in
• Default Stream Profile — which stream profile to assign to streams
• Default Channel Group — which channel group to assign channels to (static, dynamic by sport/league, or custom pattern)

See Settings > Dispatcharr for details on each option.

How It Works

Once connected, Teamarr manages the full channel lifecycle in Dispatcharr:

1. EPG Generation runs (manually or on schedule)
2. Teamarr matches streams to events and resolves templates
3. Channels are created in Dispatcharr with names, logos, EPG data, streams, and profile/group assignments
4. Channels are updated when event data changes (scores, status, streams)
5. Channels are deleted when events end (based on lifecycle timing)

M3U Account Refresh

Before matching streams, Teamarr refreshes your M3U accounts in Dispatcharr to get the latest stream data. This happens automatically at the start of each EPG generation run.

Profile & Group Sync

Teamarr enforces profile and group assignments on every generation run. If someone manually changes a channel’s profiles in Dispatcharr, Teamarr will correct it on the next run. This self-healing behavior ensures your configuration stays consistent.

Dynamic wildcards ({sport}, {league}) automatically create profiles and groups in Dispatcharr if they don’t exist.

Reconciliation

The Channels page can detect drift between Teamarr’s expected state and Dispatcharr’s actual state:

• Drifted channels have mismatched profiles, streams, or settings — corrected on next generation
• Orphaned channels exist in Dispatcharr but aren’t tracked by Teamarr — can be cleaned up manually

Network Configuration

Teamarr and Dispatcharr need to be able to reach each other over the network.

Docker Compose (Same Host)

If both containers are on the same Docker network, use the container name as the hostname:

# Teamarr Settings > Dispatcharr URL:
http://dispatcharr:9191

# Dispatcharr EPG source URL:
http://teamarr:9195/api/v1/epg/xmltv

Separate Hosts

Use the IP address or hostname of each server:

# Teamarr → Dispatcharr
http://192.168.1.100:9191

# Dispatcharr → Teamarr EPG
http://192.168.1.101:9195/api/v1/epg/xmltv

Troubleshooting Connection Issues

Problem	Solution
“Disconnected” status	Verify the URL is correct and Dispatcharr is running. Check Docker networking.
“Error” status	Hover over the badge for details. Common causes: wrong credentials, firewall blocking port.
EPG source dropdown empty	Make sure you’ve added the Teamarr XMLTV URL as an EPG source in Dispatcharr first.
Channels not appearing	Run EPG generation. Check that you have templates assigned and streams available.