hls.js

[![npm](https://img.shields.io/npm/v/hls.js.svg?style=flat)](https://npmjs.org/package/hls.js)
[![npm](https://img.shields.io/npm/v/hls.js/canary.svg?style=flat)](https://www.npmjs.com/package/hls.js/v/canary)
[![](https://data.jsdelivr.com/v1/package/npm/hls.js/badge?style=rounded)](https://www.jsdelivr.com/package/npm/hls.js)
[![Sauce Test Status](https://saucelabs.com/buildstatus/robwalch)](https://app.saucelabs.com/u/robwalch)
[![jsDeliver](https://data.jsdelivr.com/v1/package/npm/hls.js/badge)](https://www.jsdelivr.com/package/npm/hls.js)
[![inspect.software](https://raw.githubusercontent.com/inspect-software/badges/main/v1/v/video-dev/hls.js.svg)](https://inspect.software/software/video-dev/hls.js)

[comment]: <> ([![Sauce Test Status]&#40;https://saucelabs.com/browser-matrix/robwalch.svg&#41;]&#40;https://saucelabs.com/u/robwalch&#41;)

# ![HLS.js](https://raw.githubusercontent.com/video-dev/hls.js/master/docs/logo.svg)

HLS.js is a JavaScript library that implements an [HTTP Live Streaming] client.
It relies on [HTML5 video][] and [MediaSource Extensions][] for playback, and on [Managed Media Source][] where MSE is not available (Safari on iOS 17.1+).

It streams VOD, Live, and Low-Latency HLS assets made up of fragmented MP4 (fMP4), MPEG-2 Transport Stream, or Packed Audio segments.
fMP4 segments (ISO BMFF, including CMAF) are passed through to MSE without remuxing, while MPEG-2 TS and Packed Audio (AAC, MP3, and AC-3) segments are transmuxed into fMP4.
Transmuxing is performed asynchronously using a [Web Worker] when available in the browser.

HLS.js streams media into a standard HTML `<video>` element, which handles decoding, rendering, playback, and seeking.
Control playback through the [`HTMLMediaElement`] API, and use HLS.js to load assets, choose quality levels and tracks, and listen for streaming events.
For assets with Interstitials, use [`hls.interstitialsManager`](docs/API.md#hlsinterstitialsmanager) to seek and track position on the integrated timeline of primary content and interstitial breaks.

HLS.js is written in [TypeScript] and transpiled using [Babel] to ECMAScript 5 syntax for the UMD bundles, and to native ES module syntax for the ESM bundles.
The [TypeScript compiler] and [API Extractor] are used for type checking and to generate the `hls.d.ts` type declarations.

[Rollup] is used to build the distro bundles and, in watch mode, the local development environment. Each release includes:

- `full` and `light` builds. The light build leaves out optional features such as alternate audio, subtitles, EME (DRM), CMCD, and Interstitials to reduce size (see [Build tasks](#build-tasks)).
- UMD bundles (`hls.js`, `hls.light.js`) for `<script>` tags and `require`. They target browsers as old as Chrome 47, Firefox 51, and Safari 10, and inline the transmuxer worker.
- ESM bundles (`hls.mjs`, `hls.light.mjs`) for `import` and modern bundlers. They do not inline the worker; set `workerPath` to the published `hls.worker.js` to transm