AdvertisementLeaderboard / responsive slot
HLS & M3U8 • Technical guide

HLS Master Playlist Guide: Variants, Audio & Subtitles

An HLS master playlist is the top-level manifest that tells a player which renditions are available. It usually contains #EXT-X-STREAM-INF entries pointing to child media playlists.

Quick answer

An HLS master playlist is the top-level manifest that tells a player which renditions are available. It usually contains #EXT-X-STREAM-INF entries pointing to child media playlists.

Purpose of the master playlist

The master playlist lets one playback URL adapt across devices and network conditions. Instead of exposing a single fixed video, it declares multiple combinations of bandwidth, resolution, codecs and alternate media.

Understanding #EXT-X-STREAM-INF

Each #EXT-X-STREAM-INF line describes the variant URI that follows. BANDWIDTH is required in common workflows and represents peak segment bitrate characteristics. Optional attributes can include AVERAGE-BANDWIDTH, RESOLUTION, FRAME-RATE, CODECS, AUDIO and SUBTITLES.

AdvertisementIn-content responsive slot

Variant example

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6200000,AVERAGE-BANDWIDTH=5800000,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2"
1080p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=3200000,RESOLUTION=1280x720,CODECS="avc1.4d401f,mp4a.40.2"
720p/index.m3u8

Alternate audio and subtitles

#EXT-X-MEDIA can define audio, subtitles and closed-caption renditions. Variants can then reference an AUDIO or SUBTITLES group by name. Correct grouping allows players to present language and accessibility controls independently from video quality.

Codec compatibility

A master playlist can advertise variants that not every device can decode. CODECS helps a player avoid incompatible renditions, but real-world playback also depends on container, profile, level, DRM and device capability.

Inspect before publishing

Check that child playlist URIs resolve correctly relative to the master, quoted CODECS strings are valid, group references exist and the bandwidth values are plausible. The HLS Inspector can summarise these attributes from pasted manifests.

Practical workflow for HLS Master Playlist Guide

A reliable way to work with HLS Master Playlist Guide is to create a small reproducible test before changing a production playlist or player configuration. Begin with the concepts covered above—Purpose of the master playlist, Understanding #EXT-X-STREAM-INF, Variant example—and confirm the expected result at each stage. Capture the exact manifest text you are testing and identify whether it is a master playlist or media playlist before changing anything. For a master, inspect the child variant URI and declared attributes; for a media playlist, inspect segment timing, sequence and segment locations. Keep network delivery failures separate from manifest syntax. This approach gives you a baseline that can be repeated after every change, which is far more useful than making several edits and then trying to infer which one affected the result.

Once the basic case behaves as expected, expand the test to the remaining areas: Alternate audio and subtitles, Codec compatibility, Inspect before publishing. HLS debugging becomes much easier when you follow the request chain. A successful response for the first .m3u8 file does not prove that child manifests, media segments or encryption keys are reachable. Likewise, a valid manifest cannot guarantee that the device supports the advertised codec, profile or rendition. Keep notes of the original input and the output produced by any editor, parser or converter. For larger playlists, entry counts, duplicate counts and metadata-completeness figures provide quick regression checks. If a result changes unexpectedly, return to the smallest known-good sample and reintroduce complexity one step at a time.

HLS Master Playlist Guide technical checklist

Before considering the job complete, review the following points against the actual use case rather than assuming that successful import in one application proves universal compatibility.

  • Purpose of the master playlist: An HLS master playlist is the top-level manifest that tells a player which renditions are available.
  • Understanding #EXT-X-STREAM-INF: The master playlist lets one playback URL adapt across devices and network conditions.
  • Variant example: Each #EXT-X-STREAM-INF line describes the variant URI that follows.
  • Alternate audio and subtitles: #EXT-X-MEDIA can define audio, subtitles and closed-caption renditions.
  • Codec compatibility: A master playlist can advertise variants that not every device can decode.
  • Inspect before publishing: Check that child playlist URIs resolve correctly relative to the master, quoted CODECS strings are valid, group references exist and the bandwidth values are plausible.

Common questions about HLS Master Playlist Guide

Does understanding HLS Master Playlist Guide prove that a stream will work?

No. An HLS master playlist is the top-level manifest that tells a player which renditions are available. It usually contains #EXT-X-STREAM-INF entries pointing to child media playlists. Playlist or manifest structure is only one layer. Availability, authorisation, network delivery and decoder support must be tested separately where they apply.

What should I preserve before making changes?

Keep the original text or file, note the player/device used for testing and record any stable identifiers such as tvg-id. For HLS work, keep the original manifest and any relevant child-manifest relationship. A known-good baseline makes rollback and comparison straightforward.

Which M3U.co.uk tool is the best starting point?

For general M3U structure, start with the M3U Checker. Use the Playlist Analyzer for counts and metadata, the M3U Editor for structured changes, and the HLS Inspector when the input contains HLS #EXT-X- directives.

Put it into practice

Inspect or edit your playlist

Use M3U.co.uk’s browser tools. Playlist content is processed locally unless a tool explicitly states otherwise.

Related HLS & M3U8 guides

M3U.co.uk toolkit

Learn the format. Inspect the playlist. Fix the problem.

Explore free tools