HLS troubleshooting

An HLS playlist opens as text but a player rejects it

Check the first line before testing media, network speed or player settings.

Check the first line before testing media, network speed or player settings.

Reproduce the condition

The HLS sample below is a small synthetic file. It carries no active media source or account data.

# An illustrative file
#EXTINF:4,
segment-1.ts

What the local check found

Reproducible check against the packaged fixture and parser.
Expected signalObserved signal
Missing EXTM3U headerMissing EXTM3U header

What to do next

Use the actual playlist output from the authorized source. A list of segment names alone is insufficient for an HLS player.

What to share if the problem continues

  • The exact parser result and version of the importer or player.
  • A minimal redacted sample with dates, IDs or segment names retained as needed.
  • The output after checking the source export separately from the viewer app.

Sources and further reading