IPTV AUSTRALIA · 1 MONTH AUD $11.99 TOTALInstall your player. Request a one-day trial ↗

Help · IPTV Australia

HLS WebVTT timestamp mapping

Segmented subtitles need a timing relationship with the audio and video they accompany. In HLS, a WebVTT timestamp map can provide that relationship. A caption file opening correctly as text does not by itself establish that its cue times align with the intended media timeline.

Two coordinate systems need a map

RFC 8216 describes X-TIMESTAMP-MAP linking a local WebVTT cue time with the MPEG media timestamp used by other renditions. The two numeric forms have different units and origins. Comparing their raw integers as if both were wall-clock seconds would be incorrect.

For an original explanatory model, think of a caption cue at a known local position and a corresponding anchor on the media clock. Later cue positions follow the applicable relationship. The mapping does not translate the words or select the user's language; it locates their presentation in time.

Segment boundaries do not necessarily end a cue

The HLS rules allow cue display intervals to extend across the period represented by one subtitle segment. A segment can also contain no cues when no subtitles should display during its period. An empty subtitle interval is therefore not automatically a missing translation or corrupt download.

If a long line is cut at every media boundary, an authorised developer should inspect cue coverage and mapping rather than only a global subtitle delay slider. A fixed slider may hide one symptom while leaving boundary handling wrong elsewhere. Preserve the exact content position and relevant media configuration.

Keep source-specific evidence

A useful report distinguishes a caption request failure, invalid WebVTT, a selected but hidden track and timing that is wrong after otherwise successful rendering. These states lead to different investigations. An image of late text cannot independently identify which timestamp field caused it.

The format also needs careful handling of its timestamp domain and wrap behaviour. Viewers should use the supported player and report the symptom, while authorised developers inspect the applicable fields. This reference does not supply private subtitle resources, claim a tested implementation or assert that IPTV Australia uses a particular clock mapping. It clarifies why text validity and media alignment require separate evidence.

Questions about this guide

Does valid WebVTT text prove audiovisual alignment?

No. Its cue clock must map correctly to the media timeline.

Is an empty subtitle segment always a failure?

No. It can represent an interval in which no captions should be shown.

Sources and further reading

Get your setup right from the start.

Tell us your device and player. We’ll help you take the next step with a clear plan enquiry or trial request.

Talk to IPTV Australia ↗