EUR full-term totals: 1 month €8.99 · 3 months €21.99 · 6 months €35.99 · 12 months €49.99 Compare plans →
Menu

Programme-guide authoring

An XMLTV display-name change should not silently change channel identity

Trace channel IDs and programme references when a guide label changes, keeping readable names separate from structural matching.

An EPG is programme information

A readable name and a reference serve different purposes

XMLTV describes channels with an id and one or more display names. Programme records refer to a channel through their channel attribute. The upstream DTD explains that this reference should match the channel's id. A display label is for the reader; structural matching is not simply the visual position of a channel in a list.

This distinction matters when an authorised guide publisher renames a label, adds a language variant or reorganises a display order. A familiar name can appear while programme references point elsewhere or nowhere. Before investigating time zones, verify that the programme record and channel identity belong together. A one-hour offset cannot repair a mismatched identifier.

A hypothetical regional guide edit

Suppose a guide author has two distinct regional feeds with similar readable names. They shorten one display name for a small screen but accidentally reuse the other feed's identifier in the programme records. The guide can now show plausible-looking titles under the wrong identity. The correct diagnosis starts with the reference mapping, not a claim that the video stream changed.

Use an authorised small sample containing the affected channel and a few programme records. Compare the channel id and each programme's channel reference exactly. Keep region and source information in the editorial record. Do not assume that a logo, country flag or shared brand name establishes which regional schedule the records describe.

Preserve identity through a controlled rename

If only the human-facing label changes, decide deliberately whether the underlying feed identity remains the same. Apply that decision consistently to the channel and programme records. Avoid mass find-and-replace operations that also alter unrelated identifiers or source URLs. Keep a before-and-after copy so a mistaken mapping can be reversed without reconstructing the entire guide.

The XMLTV DTD permits multiple display names, including language-tagged names. That can express readable alternatives without treating every spelling as a different feed. It does not remove the need for unique, coherent channel IDs. A publisher's own mapping conventions and downstream player's requirements should be documented rather than guessed from another application's screenshot.

Test both the structure and the programme shown

Validate the generated XML with the intended tooling, then import the small sample through the supported guide workflow. Check that the named channel receives the expected programme at a known time. A file passing XML syntax validation does not prove that its editorial feed mapping is correct. Likewise, a populated guide is not proof that the associated video source is authorised or available.

Record the source edition, identifier mapping and readable label change. If reporting a problem to a provider, give the affected display name, region, time and observed programme without publishing a private guide address. This lets the operator investigate the actual identity relationship instead of applying repeated time offsets to a structurally wrong mapping.

Questions answered

Does the channel's position in XMLTV define programme matching?

The upstream format describes matching through channel identifiers and programme references, not the visual list position.

Will changing a time offset fix the wrong regional feed mapping?

No. Verify the channel identity and source edition first; a time adjustment addresses a different problem.

Sources & further reading

Official references for the subjects discussed. Service terms and device software can change.

Your next step

A better setup starts with the right details.

Tell us your device model, viewing country and the programmes you want to discuss.

Talk on WhatsApp

+44 7532 814802

WhatsApp ↗↑ Top