Module hls-parse

@slax/hls-parse — A robust M3U8 / HLS playlist parser.

Parses M3U8 playlists according to RFC 8216 (HTTP Live Streaming).

Features

Master Playlists — adaptive bitrate streaming, alternative renditions
Media Playlists — segments, encryption keys, byte ranges, discontinuities
LL-HLS — partial segments, preload hints, server control, skip, prefetch
Relative URL resolution — resolve all URIs against a base URL
Automatic version detection — detects required protocol version
Full TypeScript support — complete type definitions

Example: Quick Start

import { parse } from '@skax/hls-parse';

const playlist = parser(`#EXTM3U
#EXT-X-TARGETDURATION:10
#EXTINF:9.009,
segment.ts
#EXT-X-ENDLIST`);

if (playlist.isMasterPlaylist) {
  console.log('Master:', playlist.variants.length);
} else {
  console.log('Media:', playlist.segments.length);
}

Example: With URL Resolution

const playlist = parser(m3u8, {
  uri: 'https://example.com/hls/main.m3u8'
});
// All relative URIs are resolved to absolute

Functions

parser
parser

References

AllowedCpc → AllowedCpc
Byterange → Byterange
ContentSteering → ContentSteering
DateRange → DateRange
ExtInfo → ExtInfo
InvalidPlaylistError → InvalidPlaylistError
isMasterPlaylist → isMasterPlaylist
isMediaPlaylist → isMediaPlaylist
Key → Key
LowLatencyCompatibility → LowLatencyCompatibility
MasterPlaylist → MasterPlaylist
MediaInitializationSection → MediaInitializationSection
MediaPlaylist → MediaPlaylist
ParserOptions → ParserOptions
PartialSegment → PartialSegment
Playlist → Playlist
PrefetchSegment → PrefetchSegment
Rendition → Rendition
RenditionReport → RenditionReport
Resolution → Resolution
resolveUrl → resolveUrl
Segment → Segment
SessionData → SessionData
SpliceInfo → SpliceInfo
StartData → StartData
TAGS → constants
UserAttribute → UserAttribute
Variant → Variant

Module hls-parse

Features

Example: Quick Start

Example: With URL Resolution

Functions

References

Settings

On This Page