Skip to main content
HLS Guides

How to download and merge M3U8 videos online for free

Learn how to extract, download, and seamlessly merge M3U8 video stream segments into an MP4 file using browser APIs and FFmpeg.

Updated September 8, 2026 By M3U8 Free Player Engineering 8 minute read

Downloading an M3U8 video stream isn't as straightforward as right-clicking a file and selecting "Save As." Unlike an MP4 file, an M3U8 is just a plain text playlist file that points to dozens or hundreds of small media segments, usually .ts (MPEG-2 Transport Stream) or fragmented MP4 (.m4s) files. To download the video, you must parse the playlist, download every individual segment sequentially, and safely merge them back together without losing audio sync or dropping frames.

In this advanced technical guide, we will explore the best methods to download and merge M3U8 videos online for free. We will cover browser-based tools, command-line engineering with FFmpeg, how to handle master vs. media playlists, and how to navigate common roadblocks like encryption and CORS policies.

Understanding the M3U8 Structure

Before jumping into download tools, understanding what you are downloading is critical. If you paste a raw M3U8 URL into a text editor, you'll see a series of HLS tags. A stream generally consists of two types of manifests:

  • Master Playlist: Contains multiple renditions (e.g., 1080p, 720p, 480p) and audio tracks. A downloader must parse this to select the highest quality stream.
  • Media Playlist: Contains the actual list of segment URLs (segment_001.ts, segment_002.ts). This is the file you actually iterate over to download data.

Master Playlist Indicator

If you see #EXT-X-STREAM-INF in the file, it is a Master Playlist. You must extract the URL beneath that tag to find the true media segments.

Segment Durations

Tags like #EXTINF:4.000, tell the downloader exactly how long each chunk is, allowing it to estimate total download time and merge progress accurately.

Using Online Browser-Based Downloaders

Modern web technologies allow us to download and merge M3U8 files entirely inside the browser using JavaScript APIs like fetch(), the File System Access API, or memory blobs. This is the fastest method for users who do not want to install terminal applications.

Our built-in M3U8 Free Player Online Downloader (available in the Tools menu) automates this pipeline. Here is how a robust browser downloader functions under the hood:

  1. Parsing: The JavaScript fetches the M3U8 URL. If it's a master playlist, it automatically selects the highest bandwidth #EXT-X-STREAM-INF URL.
  2. Fetching: It initiates parallel or sequential HTTP requests to download the .ts segments.
  3. Merging: It concatenates the array buffers of the binary video data in memory.
  4. Exporting: It generates a Blob from the merged buffers and triggers a browser download as a single .ts or .mp4 file.
Note: Browser-based downloaders are heavily constrained by Cross-Origin Resource Sharing (CORS). If the server hosting the M3U8 segments does not return an Access-Control-Allow-Origin: * header, the browser will block the download requests.

The Gold Standard: FFmpeg

For software engineers, network administrators, and power users, FFmpeg is the industry standard for processing HTTP Live Streaming (HLS). FFmpeg handles playlist parsing, segment downloading, stream merging, and container remuxing automatically in one command.

Basic Download and Merge Command

To download an M3U8 stream and remux it into an MP4 file without re-encoding the video (which preserves original quality and is significantly faster), use the -c copy flag:

ffmpeg -i "https://example.com/stream/master.m3u8"        -c copy -bsf:a aac_adtstoasc        output.mp4

In this command:

  • -i: Specifies the input URL. FFmpeg automatically parses master and media playlists.
  • -c copy: Copies the raw video and audio streams directly, bypassing the CPU-intensive decoding/encoding process.
  • -bsf:a aac_adtstoasc: A bitstream filter often required when remuxing AAC audio from an MPEG-TS container into an MP4 container.

Selecting Specific Quality Levels

If you feed FFmpeg a master playlist, it usually selects the stream with the highest resolution or bitrate by default. If you want to list all available streams and select a specific one, use the -map flag.

# First, probe the stream to see available mappings
ffprobe -i "https://example.com/stream/master.m3u8"

# Assuming the 720p video is stream 0:2 and audio is 0:3
ffmpeg -i "https://example.com/stream/master.m3u8"        -map 0:2 -map 0:3 -c copy output.mp4

Handling Encrypted HLS Streams

Many commercial M3U8 streams are protected with AES-128 encryption. If you inspect the M3U8 file and see a tag like #EXT-X-KEY:METHOD=AES-128,URI="https://example.com/key.bin", the segments are encrypted.

Standard AES-128

If the URI points to an accessible key file without requiring special authentication headers, FFmpeg will automatically download the key, decrypt the segments in memory, and output a DRM-free MP4. No extra commands are needed.

Tokenized Keys

If the key URL requires a session cookie, Bearer token, or specific User-Agent, FFmpeg will fail with a 403 Forbidden error.

To pass specific HTTP headers to FFmpeg so it can authorize the key request, use the -headers argument:

ffmpeg -headers "Authorization: Bearer YOUR_TOKEN
User-Agent: Mozilla/5.0
"        -i "https://example.com/encrypted.m3u8"        -c copy decrypted_output.mp4

Note: If the stream uses Widevine, PlayReady, or FairPlay DRM (often indicated by METHOD=SAMPLE-AES and a KEYFORMAT tag), the stream cannot be downloaded or decrypted by FFmpeg. These are hardware-level DRM systems designed explicitly to prevent downloading.

Troubleshooting Download Failures

Downloading HLS streams can be prone to network interruptions and server configurations. Here are the most common issues and how to resolve them:

1. 403 Forbidden Errors

Servers often block requests that do not come from an expected web browser or lack a valid referer. You can spoof the HTTP headers using FFmpeg's -user_agent and -headers flags to mimic the browser environment where the video originally played.

2. Disconnected or Incomplete Streams (Live HLS)

If you are downloading a live event, the M3U8 playlist updates continuously. FFmpeg handles live streams gracefully, but it will only stop when the stream issues an #EXT-X-ENDLIST tag. If you want to record only a specific duration (e.g., 1 hour), append -t 3600 to your FFmpeg command.

3. Audio/Video Sync Issues

When downloading segments that contain timestamp discontinuities (marked by #EXT-X-DISCONTINUITY), the merged MP4 may have corrupted timestamps, leading to lip-sync issues. Adding the -async 1 or using -f mp4 -movflags +faststart during the remuxing process can help realign the PTS (Presentation Time Stamp) clock.

Summary

Whether you are archiving a corporate webcast, backing up a VOD stream, or engineering a robust media pipeline, downloading M3U8 streams correctly requires parsing the manifest and safely concatenating the TS chunks. Browser-based tools offer convenience for unauthenticated, CORS-friendly streams, while FFmpeg provides the ultimate power for complex, authenticated, and encrypted HLS playlists.