Programme guide

Match XMLTV programmes to the right channel

Inspect one channel identifier and one programme record before remapping your electronic programme guide.

Close detail of the microphone button on a black television remote
Photo by Kaboompics Source · Pexels License

An XMLTV channel has an id and one or more display names. A programme refers to the channel through its channel attribute. The ID is the join. A familiar name, logo or number is only a label. Players may use their own matching rules when connecting a playlist to that ID.

FieldExampleWhat it tells you
Channel IDstation.city.exampleIdentifier inside this schedule
Display nameCity One HDLabel shown to a person
Programme channelstation.city.exampleWhich schedule row receives the programme
Start20261113183000 +0000Source timestamp with offset

Fix a single row first

Choose a station with a dependable schedule from the broadcaster. Open the guide mapping view if the app provides one. Match its exact regional feed to the relevant XMLTV entry, refresh and check an upcoming show. If you have both an eastern and western feed, label the region explicitly before reassigning the guide.

Watch for duplicate names and stale mappings

An import can retain an old manual mapping after a service changes its channel list. Compare whether a freshly added test profile picks a different match. Keep the existing profile while you test so you can preserve favourites. If the identifiers match but the published programme is wrong, send the broadcaster reference and timestamp to the schedule supplier.

Sources

Questions readers ask

Why does one channel show the wrong programmes?

Compare its exact regional feed and guide identifier. If other channels show the correct time, fix the affected channel’s mapping and verify a known programme before adjusting the whole guide.

Read the related guide

What does a channel ID do in XMLTV?

The programme entry points to a channel ID. That identifier connects the programme to a schedule row. A display name is separate and can be shared by different regional versions.

Read the related guide

Which identifier should I share when the schedule belongs to another channel?

Share the broadcaster, regional edition, visible channel name and public or redacted guide ID. Include one programme with its expected time. Remove private server addresses and tokens from exported files before sharing.

Read the related guide