Event Groups
Event-based EPG creates dynamic channels from M3U streams. Unlike team channels (which are persistent), event channels appear when a game is about to start and disappear after it ends.
How It Works
- Your IPTV provider delivers streams organized into groups (e.g., “NFL”, “ESPN+”, “DAZN”)
- You import these stream groups into Teamarr as event groups
- Teamarr parses each stream name, matches it to a real sporting event, and creates a channel with rich EPG data
- Channels are created in Dispatcharr with proper names, logos, EPG data, and group/profile assignments
Global Defaults vs Per-Group Settings
Teamarr uses a subscription model where global defaults apply to all groups:
- League subscriptions — which sports and leagues to scan for events
- Soccer configuration — follow teams, select leagues, or include all
- Template assignments — which EPG template to use by sport/league
- Team filter — include/exclude specific teams from matching
These are configured in the Global Defaults panel at the top of the Event Groups page.
Individual groups can override these defaults when needed (e.g., a hockey-only stream source that shouldn’t scan for football events).
The Event Groups Table
Below Global Defaults, the event groups table shows all configured groups with:
| Column | Description |
|---|---|
| Name | Group name and M3U account |
| Matched | Streams matched to events (with match rate and last-run timestamp) |
| Status | Enable/disable toggle |
| Actions | Preview matches, clear cache, edit, delete |
Click Matched numbers to see which streams matched to which events. Click the preview button to see current stream matches without running a full generation.
Importing Groups
Click Import to pull stream groups from your Dispatcharr M3U accounts. Teamarr shows available groups with stream counts. Select the groups you want and they’ll be created with default settings.
Stream Matching Pipeline
When EPG generation runs, each stream goes through:
- Filtering — include/exclude regex, built-in filters for non-sport content
- Classification — parse stream name to extract teams, league, date, time
- Matching — find the corresponding real-world event from provider data
- Channel creation — create/update the Dispatcharr channel with EPG data
Streams that can’t be matched appear in the Failed count. Click it to see details and use the Fix button to manually link a stream to an event.
See Creating Groups for detailed configuration options.