HLS guide

How HLS video downloads work on Mac

HLS can look like one video in a browser while actually arriving as playlists plus many small media segments. Understanding that structure explains quality choices, live recording and many common download failures.

Written and checked by Bart Knobben, developer of Slurp · For Slurp 1.x · Updated

The short answer

HLS delivers video through one or more M3U8 playlists that point to media segments. A downloader reads the playlist, chooses an accessible rendition, fetches the segments in order and packages the result into a usable file. Live playlists keep changing while a broadcast runs; VOD playlists describe a completed presentation. Slurp handles supported HLS paths but does not bypass DRM or other access controls.

HLS in plain English

HTTP Live Streaming, usually shortened to HLS, is Apple’s adaptive streaming technology for delivering live and on-demand audio and video over ordinary HTTP. Instead of requiring one large movie file, HLS describes media with playlists and divides the presentation into a sequence of smaller segments.

A service can offer several variants of the same program at different bitrates or resolutions. A player can then select the variant that fits the connection and device. Apple’s HLS documentation describes the same playlist-and-segment model.

An M3U8 file is a playlist, not the whole video

HLS playlist files commonly use the .m3u8 extension. A multivariant or “master” playlist can point to several media playlists, each representing a particular video quality, audio track or other rendition. A media playlist then lists the media segments required for playback.

That is why simply saving an M3U8 text file does not give you a normal playable movie. A downloader has to interpret the playlist, choose the intended rendition, fetch the referenced media in order, and usually package or remux the result into a convenient local file.

Live HLS and VOD HLS behave differently

A VOD playlist describes a completed presentation, so the downloader can work through a finite list of media. A live playlist keeps changing: new segments are added as the broadcast continues, and older ones may disappear from the live window.

That difference is why a live-stream recorder must remain connected and follow the playlist over time, while a VOD downloader can usually determine the job’s complete media range up front.

How Slurp handles supported HLS

Slurp does not require you to hunt for an M3U8 URL manually. For supported pages, it analyzes the source and chooses the useful media path. Depending on what it finds, yt-dlp can provide format discovery, Streamlink can handle supported active live media, and FFmpeg can process or remux known media into the requested file.

If the page itself is needed to discover media, Slurp can use an isolated browser-assisted path on supported sources. The final result still has to be media Slurp can legitimately access from the source.

Why an HLS URL may still not be downloadable

Finding the letters m3u8 in a page or network request does not guarantee a reusable download. Playlist and segment URLs can be short-lived, signed to a session, tied to cookies or headers, encrypted, or protected by a DRM system such as FairPlay.

Slurp can work with supported accessible HLS media, but it does not bypass DRM or other access controls. If a source changes how it authorizes or delivers its playlists, compatibility may need an update before the link works again.

Common questions

What is an M3U8 file?

An M3U8 file is a text playlist used by HLS. It can list media segments directly or point to other playlists for different qualities, audio tracks or renditions.

Is HLS only for live video?

No. HLS supports both live and on-demand video. A live playlist changes as new media is published, while a VOD playlist describes a completed presentation.

Can Slurp download any M3U8 URL?

No. Slurp handles supported accessible media paths. Session-bound URLs, source changes, encryption, DRM and other access controls can prevent a playlist from being downloadable.

Why are there several HLS qualities?

HLS can publish multiple variants at different bitrates and resolutions so players can adapt to network conditions. A downloader can select among the variants the source exposes and the tool can access.

Use Slurp only for media you are authorized to save or record. Source availability can change; try the links you need during the free trial. Slurp does not bypass DRM. Usage & trademark notice.

Your next link

Try Slurp with a link of your own.

Every feature is included for seven days, starting with your first successful download or live recording. No card required.

Apple silicon M1 or later · macOS 14 or later