People usually meet the .m3u8 extension in one of two ways: a provider hands them a link that ends in it, or they right-click a video, find an .m3u8 request in the network tab, and wonder why opening it downloads a tiny text file instead of playing anything. Both reactions come from the same misunderstanding — the file is an index, not a video.
This guide explains what is actually inside an .m3u8, how it differs from a classic .m3u, how master and media playlists relate to each other, and how to open one in a browser without converting anything.
M3U vs M3U8 — what is the difference?
Both are the same playlist format. The difference is encoding and intent: .m3u is the original extension, historically Latin-1 encoded; .m3u8 is the UTF-8 variant, which is why it became the standard extension for manifests containing non-ASCII channel names and accented titles. In practice, an .m3u8 file is either a list of stream entries or a manifest for a single stream — Decodr detects which and handles both. For the tag-by-tag breakdown of the syntax, see what an M3U playlist is.
What is inside an .m3u8 file
Open one in a text editor and you will find readable lines. There are two shapes worth knowing.
The master playlist
A master playlist lists the quality variants of the same content. Each #EXT-X-STREAM-INF line declares a bandwidth, a resolution and a codec string, and the URL beneath it points to a media playlist for that rendition:
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=800000,RESOLUTION=640x360
360p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2400000,RESOLUTION=1280x720
720p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=5200000,RESOLUTION=1920x1080
1080p/index.m3u8The media playlist
A media playlist is the actual segment list for one rendition. Each #EXTINF gives a segment duration, and the line under it names the file to fetch:
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:4207
#EXTINF:6.000,
seg-4207.ts
#EXTINF:6.000,
seg-4208.tsFor a live stream, the player re-downloads this same file every few seconds to discover new segments. For video on demand, the list is complete and ends with #EXT-X-ENDLIST. Every one of these tags is defined in IETF RFC 8216, the HTTP Live Streaming specification. How a player then chooses between variants during playback is covered in the HLS player guide.
Why you do not need to convert .m3u8 to MP4
Search results are full of converters, and for playback they solve a problem you do not have. There is nothing to convert: the manifest is an index, and any HLS-capable player reads it and streams the segments it references. Converting is only relevant when you want an offline archive of content you own — and for live streams it is meaningless, because the segment list never ends.
Decodr never downloads, re-encodes or stores a stream. It plays the link as it is, in your browser, on your device.
How to open an .m3u8 file online
- Open the Decodr player.
- Paste the
.m3u8URL, or press Open file to select the file from your disk. - Decodr detects whether the file is a channel list or a single manifest and switches engine accordingly.
- Press play. Where the master playlist exposes multiple renditions, the quality menu lets you pin one instead of letting the player choose automatically.
Note one caveat for local files: opening a manifest from your disk still requires the segment URLs inside it to be reachable. If they are relative paths to files that only exist on the origin server, playback will fail even though the manifest parsed fine.
Browser support for M3U8
Safari on macOS and iOS plays HLS natively, so Decodr hands the URL straight to the browser. Chrome, Edge and Firefox have no built-in HLS support, so Decodr uses a JavaScript engine that downloads the manifest, fetches segments and pushes them into the video element through Media Source Extensions. The user experience is identical; only the plumbing differs.
Common M3U8 player errors and fixes
- CORS blocked — the host does not permit browser playback from another origin. Nothing on the player side can fix this; the header must come from the server.
- 404 or expired token — many manifests are signed and expire within minutes. Re-copy a fresh link from the source.
- Unsupported codec — browsers decode H.264 and AAC widely; HEVC, AC-3 and EAC-3 are inconsistent across devices.
- Mixed content — an
http://stream requested from an HTTPS page is blocked outright by the browser. - The link opens as text — you loaded the manifest in a browser tab rather than a player. Paste the same URL into Decodr instead.
- Encrypted segments — a stream protected with DRM or a private
#EXT-X-KEYwill parse but not decode without authorised keys.
Where legitimate .m3u8 links come from
Broadcasters publish them for free-to-air feeds, universities use them for lecture capture, sports bodies use them for official streams, and self-hosted media servers generate them on the fly. If you subscribe to an IPTV service, your provider issues one for your account. Decodr publishes none of these and indexes nothing — you bring a link you are entitled to use, and it plays. The online M3U player guide covers loading full channel playlists rather than single manifests.
Frequently asked questions
What is an .m3u8 file?
An .m3u8 file is a UTF-8 encoded M3U playlist. In streaming it is usually an HLS manifest listing the video segments or the available quality variants of a stream.
How do I open an M3U8 file online?
Paste the .m3u8 URL into Decodr, or open the file from your device. Decodr detects whether it is an HLS manifest or a playlist of entries and plays it accordingly — no app or account needed.
Can I play M3U8 on Chrome?
Yes. Chrome has no native HLS support, so Decodr uses a JavaScript HLS engine (hls.js) to decode the manifest and feed segments to the browser's media pipeline.
Why do I get a CORS or network error?
Browsers require the stream host to allow cross-origin playback. If the host does not send the right headers, or the link has expired, playback fails and Decodr shows the reason.
Do I need to convert .m3u8 to MP4 to watch it?
No. An .m3u8 file is only an index, so there is nothing to convert for playback — a browser player reads the manifest and streams the segments it points to. Conversion tools exist for archiving, but Decodr plays the link as-is and never downloads or re-encodes it.
Why does my M3U8 link say 404 or expired?
Many HLS manifests are signed with a token that expires within minutes. Copy a fresh link from the source and paste it again.
Does an .m3u8 file contain the video itself?
No. It is a plain text index a few kilobytes in size. Every line either points to a video segment or to another playlist, which is why you can open one in a text editor and read it.
Can I play M3U8 on iPhone or Safari?
Yes. Safari on macOS and iOS plays HLS natively, so Decodr hands the .m3u8 link straight to the browser's built-in player for the most efficient playback.
Can I edit an .m3u8 file?
Yes — it is UTF-8 text, so any editor works. You can remove entries, rename channels or regroup them, then reopen the file in Decodr. Keep the #EXTM3U header on the first line or players will treat it as a plain list.
How do I open a local .m3u8 file from my device?
Use Open file in the Decodr player and pick the .m3u8 from your disk. Parsing happens in your browser; the file is never uploaded. Note that segment URLs inside the file must still be reachable over the network.
Why does my .m3u8 link open as text instead of playing?
The server is sending it as a downloadable text file, or you opened it directly in a browser tab. Paste the same URL into a player instead — Decodr requests the manifest, parses it and plays the segments rather than displaying the file.
Is it legal to play M3U8 links?
Playing manifests for streams you are authorised to access — your own subscriptions, free-to-air broadcasts, your own server — is fine. Decodr hosts no streams and cannot grant access to anything.
What does 'manifest load error' mean in an M3U8 player?
The player could not fetch or parse the .m3u8 manifest. The usual causes are an expired signed URL, the host blocking cross-origin requests (CORS), the stream going offline, or the URL pointing to a web page instead of the manifest itself.
How do I find the real .m3u8 URL of a stream?
Legitimate sources give you the manifest URL directly — your IPTV provider's portal, a broadcaster's developer documentation, or your own media server. If a site hides its streams, do not scrape around its restrictions; use sources that intend their manifests to be played.
What is the difference between a master playlist and a media playlist?
A master .m3u8 lists several quality variants (for example 1080p, 720p, 480p) with their bitrates. Each variant points to a media playlist that lists the actual video segments. Adaptive players read the master list first, then switch between variants automatically.
Why is the M3U8 audio out of sync with the video?
Audio drift usually comes from the encoder at the source, not the player. Try pausing and resuming, or reloading the stream. If every channel from one provider drifts, report it to the provider.
Can I play an M3U8 file on Android TV or Firestick?
Yes. Open Decodr in any browser on the TV — Silk on Firestick, Chrome or the built-in browser on Android TV — paste the .m3u8 link and press Load. No app install is needed.
Does this M3U8 player work on Windows, Mac and Linux?
Yes. Any modern browser on Windows, macOS, Linux or ChromeOS can run Decodr. HLS decoding happens in JavaScript where the browser lacks native support, and natively in Safari.
What character encoding should an .m3u8 file use?
UTF-8, without a byte-order mark. That is the only difference the extension implies over .m3u, and it is why channel names with accents or non-Latin scripts display correctly in .m3u8 but can break in a legacy .m3u file.
Final thoughts
Almost every confusion around .m3u8 files disappears once you accept that the file is an index, not a video. You do not convert it, you do not download it, and you cannot judge it by its size. You point a player at it, the player reads the list, and the list tells the player what to fetch next. Decodr does exactly that in the browser, in the open, with your own links.
