How to Download an M3U8 Playlist File: A Step-by-Step Guide

What Is an M3U8 Playlist File?

An M3U8 playlist file is a plain-text index. Instead of holding video itself, it lists the media segments (usually .ts or .m4s files) that make up a stream, in the order they should be played. Think of it as a table of contents for a video rather than the video book.

When you "download an M3U8 file," there are really two things people mean:

• Saving the .m3u8 text file itself (easy, but useless on its own).
• Saving the actual video the playlist describes — which means fetching and merging all the segment files into one playable file like MP4.

Where to Find the M3U8 URL

Before you can download anything, you need the playlist URL. Here is the fastest way to grab it from almost any website:

Tip: Tip: If you see more than one .m3u8, the one with the most segments (often a "media playlist") is usually the one you want. A "master playlist" lists quality variants and points to the media playlists.

How Downloading an M3U8 File Works

Under the hood, downloading an M3U8 stream is a three-step process:

Tip: Some streams are encrypted (AES-128) and require a key to decode. Others are signed or expire quickly, which is why a download might work one minute and fail the next.

How to Download the TS Segments

Once you have the playlist URL, the next step is to pull down all the segment files. You can do this manually with a script, or let a tool handle it for you. The key points to watch:

• Segments are often named sequentially (segment-001.ts, segment-002.ts …), which makes bulk downloading straightforward.
• Some servers require the same cookies, Referer, or User-Agent as the original page, or they will refuse the request.
• If a segment is missing or returns an error, the final video may have a glitch at that spot.

How to Merge TS Segments into MP4

Individual TS segments are not a convenient video file on their own. To get something you can actually watch and share, you merge them into a single MP4. The general idea:

• Concatenate the segments in playlist order.
• Repackage the combined stream into an MP4 container.
• Keep the original codecs so you do not lose quality during the merge.

Tip: A good merger keeps the existing H.264/H.265 video and AAC audio and simply wraps them in MP4 — no re-encoding, no quality loss.

Fixing CORS Errors When Downloading

CORS (Cross-Origin Resource Sharing) is the most common wall you will hit. The video server tells browsers "only this website may load my files," so a direct download from a different origin gets blocked.

• Use a downloader that proxies the request through its own server or a Cloudflare Worker.
• Pass the original page’s Referer and User-Agent headers with the request.
• Try a different stream or source if the origin strictly blocks cross-site access.

Tip: This is exactly why tools with a built-in "Speed Boost" proxy exist — they fetch the segments server-side where CORS does not apply, then hand the merged file back to you.

Method 1: Using a Browser Extension

The simplest approach for casual downloads is a browser extension that detects M3U8 streams on the page you are already watching.

• Install an extension that captures HLS/M3U8 streams.
• Open the video page and let the extension detect the playlist.
• Click download and choose the output format (often MP4).

Tip: Extensions are convenient but limited: they depend on the page allowing the request, and they may not handle encrypted or protected streams.

Method 2: Manual Download (FFmpeg / curl)

If you are comfortable with a terminal, command-line tools give you the most control. FFmpeg can read an M3U8 playlist directly and output a merged file:

ffmpeg -i "https://example.com/path/playlist.m3u8" -c copy output.mp4

Tip: Replace the URL with your playlist. Add headers with -headers if the source requires a Referer or User-Agent. For just grabbing segments, curl can fetch each .ts file in a loop.

Method 3: Using an Online M3U8 Downloader

The most user-friendly option is an online M3U8 downloader that does the fetching, merging, and converting for you — right in your browser, no install needed.

• Paste the M3U8 URL into the downloader.
• Optionally enable a proxy to bypass CORS and hotlink protection.
• Choose MP4 as the output format and start the download.
• Save the merged video to your device.

Tip: Our free M3U8 Downloader works this way: paste a URL, toggle Speed Boost if needed, and download the result as MP4.

Best Practices for Downloading Safely

A few habits keep your downloads reliable and respectful:

• Only download content you own or have permission to save.
• Keep the original codecs (copy mode) to avoid quality loss.
• Use a proxy or correct headers when a source blocks cross-site requests.
• Act quickly — many signed or temporary URLs expire within minutes.
• Verify the merged file plays before deleting the source segments.

Common M3U8 Download Problems

When a download fails, it is almost always one of these:

• CORS blocked — use a proxy or correct Referer/User-Agent.
• Expired or signed URL — grab a fresh playlist URL.
• Encrypted segments — you need the decryption key.
• Authentication required — supply cookies or a token.
• Missing segments — the source removed some chunks; try another stream.