[![npm][npm-image]][npm-url]

hls.js

hls.js is a JavaScript library which implements an [HTTP Live Streaming] client.
It relies on [HTML5 video][] and [MediaSource Extensions][] for playback.

it works by transmuxing MPEG-2 Transport Stream into ISO BMFF (MP4) fragments.
this transmuxing could be performed asynchronously using [Web Worker] if available in the browser.

hls.js does not need any player, it works directly on top of a standard HTML```element.

hls.js is written in [ECMAScript6], and transpiled in ECMAScript5 using [Babel].

[HTML5 video]: http://www.html5rocks.com/en/tutorials/video/basics/
[MediaSource Extensions]: http://w3c.github.io/media-source/
[HTTP Live Streaming]: http://en.wikipedia.org/wiki/HTTP_Live_Streaming
[Web Worker]: http://caniuse.com/#search=worker
[ECMAScript6]: https://github.com/ericdouglas/ES6-Learning#articles--tutorials
[Babel]: https://babeljs.io

Demo

public demo : http://dailymotion.github.io/hls.js/demo

private demo accessible from Dailymotion network: http://gdupontavice.dev.dailymotion.com/hls.js/demo/index.html




player integration

hls.js is (being) integrated in the following players:

- [Clappr] (https://github.com/clappr/clappr), integrated since 0.2.14
- [Flowplayer] (https://www.flowplayer.org) through [flowplayer-hlsjs] (https://github.com/flowplayer/flowplayer-hlsjs)
- [Videojs] (http://videojs.com) through [Videojs-hlsjs] (https://github.com/benjipott/videojs-hlsjs)
- [Videojs] (http://videojs.com) through [videojs-hls.js] (https://github.com/streamroot/videojs-hls.js). hls.js is integrated as a SourceHandler -- new feature in Video.js 5.

it might also be integrated in the following players if you push for it !

- [MediaElement.js] (http://mediaelementjs.com/) through [#1609
] (https://github.com/johndyer/mediaelement/issues/1609)

Chrome integration

- [native-hls] (https://chrome.google.com/webstore/detail/native-hls-playback/emnphkkblegpebimobpbekeedfgemhof), plays hls from address bar and m3u8 links

Firefox integration

- [firefox-hls] (https://github.com/mangui/firefox-hls), plays hls from address bar and m3u8 links (alpha stage)

Dependencies

No external JS libs are needed.
prepackaged build is included in the [dist] (dist) folder:

- [hls.js] (dist/hls.js)
- [hls.min.js] (dist/hls.min.js)

if you want to bundle the application yourself, use node

`
npm install hls.js
`

Installation

either directly include dist/hls.js or dist/hls.min.js

or type

`sh
npm install --save hls.js
`

Compatibility

hls.js is compatible with browsers supporting MSE with 'video/MP4' inputs.
as of today, it is supported on:

* Chrome for Android 34+
* Chrome for Desktop 34+
* Firefox for Android 41+
* Firefox for Desktop 42+
* IE11+ for Windows 8.1
* Safari for Mac 8+ (beta)

CORS

All HLS resources must be delivered with CORS headers permitting GET requests.

Features

- VoD & Live playlists
- DVR support on Live playlists
- MPEG-2 TS container
- AAC container (audio only streams)
- Adaptive streaming
- Manual & Auto Quality Switching
- 3 Quality Switching modes are available (controllable through API means)
- instant switching (immediate quality switch at current video position)
- smooth switching (quality switch for next loaded fragment)
- bandwidth conservative switching (quality switch change for next loaded fragment, without flushing the buffer)
- in Auto-Quality mode, emergency switch down in case bandwidth is suddenly dropping to minimize buffering.
- Accurate Seeking on VoD & Live (not limited to fragment or keyframe boundary)
- ability to seek in buffer and back buffer without redownloading segments
- Built-in Analytics
- every internal events could be monitored (Network Events,Video Events)
- playback session metrics are also exposed
- resilience to errors
- retry mechanism embedded in the library
- recovery actions could be triggered fix fatal media or network errors
- Redundant/Failover Playlists
- Timed Metadata for HTTP Live Streaming (in ID3 format, carried in MPEG-2 TS)
- AES-128 decryption (AES-128 mode)
- CEA-708 captions (pop-on, channel 1)

Not Supported (Yet)

- CEA-708 captions (roll-up, paint-on, channel 2)
- MP3 / WebVTT container
- Alternate Audio Track Rendition (Master Playlist with alternative Audio)

$3

- #EXTM3U
- #EXTINF
- #EXT-X-STREAM-INF (adaptive streaming)
- #EXT-X-ENDLIST (Live playlist)
- #EXT-X-MEDIA-SEQUENCE
- #EXT-X-TARGETDURATION
- #EXT-X-DISCONTINUITY
- #EXT-X-BYTERANGE
- #EXT-X-KEY (https://tools.ietf.org/html/draft-pantos-http-live-streaming-08#section-3.4.4)
- #EXT-X-PROGRAM-DATE-TIME (https://tools.ietf.org/html/draft-pantos-http-live-streaming-18#section-4.3.2.6)

Getting Started

`js



`

Video Control

video is controlled through HTML `` element.

HTMLVideoElement control and events could be used seamlessly.




API and Configuration Parameters

hls.js can be configured and controlled easily, click here for details.




License

hls.js is released under Apache 2.0 License

Contributing

Pull requests are welcome. Here is a quick guide on how to start.

- First, checkout the repository and install required dependencies
`sh
git clone https://github.com/dailymotion/hls.js.git


setup dev environnement

cd hls.js
npm install

build dist/hls.js, watch file change for rebuild and launch demo page

npm run dev

lint

npm run lint
`
- Use EditorConfig or at least stay consistent to the file formats defined in the .editorconfig file.
- Develop in a topic branch, not master
- Don't commit the updated dist/hls.js` file in your PR. We'll take care of generating an updated build right before releasing a new tagged version.

Design

click here for details.

[npm-image]: https://img.shields.io/npm/v/hls.js.svg?style=flat
[npm-url]: https://npmjs.org/package/hls.js