Skip to main content
The Channels page shows all event-based channels currently managed by Teamarr. These are ephemeral channels created for sporting events and automatically deleted when events end.
Team-based channels are managed separately on the Teams page.

Channels table

Each row represents a channel synced — or pending sync — to Dispatcharr.
ColumnDescription
ChannelChannel name, logo, number, and TVG ID
EventAway @ Home matchup with event date and time
SportSport display name (e.g., Basketball, Soccer)
LeagueLeague name badge
StatusSync status with Dispatcharr
Delete AtScheduled deletion time shown as a relative value (e.g., “in 2h”)
ActionsManual delete button

Filters

Use the filter bar above the table to narrow results:
FilterDescription
NameText search on channel name
SportFilter by sport
LeagueFilter by league
StatusFilter by sync status
Show deletedInclude soft-deleted channels in the table

Sync status

The Status column shows whether each channel is correctly synced to Dispatcharr.
StatusColorMeaning
In SyncGreenChannel matches Dispatcharr — profiles, streams, and settings are aligned
PendingGrayChannel created locally, awaiting first sync to Dispatcharr
CreatedBlueJust created in Dispatcharr, not yet verified
DriftedYellowConfiguration mismatch detected — profiles, streams, or settings differ from what Teamarr expects. Automatically re-synced on the next generation run.
OrphanedRedTracked locally but missing from Dispatcharr
ErrorRedSync encountered an error
Drifted channels self-heal automatically. The lifecycle sync compares Dispatcharr’s actual state against Teamarr’s expected state and corrects any differences on the next EPG generation.

Pending deletions

A banner at the top of the page shows how many channels are scheduled for deletion and when the next one expires. Channels are deleted automatically by the lifecycle scheduler based on the delete timing configured in Settings > Channels.

Bulk operations

Select multiple channels using the checkboxes to enable bulk delete. A fixed bar appears at the bottom of the page showing the selection count and a delete button.

Find orphans

The Find Orphans button scans Dispatcharr for channels that exist there but are not tracked by Teamarr. Orphans can appear when:
  • Teamarr was restarted or restored from a backup
  • Channels were created manually in Dispatcharr with Teamarr-style IDs
  • A sync error left channels behind without recording them locally
The modal lists each orphan individually. You can delete them one at a time or all at once.

Reset All

Reset All is a destructive operation. It removes all Teamarr-managed event channels from Dispatcharr immediately. Team channels are not affected.Use this only when you want a completely clean slate — for example, after major configuration changes. Channels will be recreated on the next EPG generation run.
The Reset All flow:
  1. Shows a preview of all channels that will be deleted
  2. Requires confirmation before proceeding
  3. Deletes all event channels from Dispatcharr

Recently deleted

A collapsible section at the bottom of the page shows the last 50 deleted channels, including the event, sport, league, and deletion timestamp. Use this to verify that lifecycle cleanup is working correctly or to identify channels that were removed unexpectedly.

Build docs developers (and LLMs) love