<commit_before># ![Shaka Player](docs/shaka-player-logo.png)

Shaka Player is an open-source JavaScript library for adaptive media.  It plays
adaptive media formats (such as [DASH][] and [HLS][]) in a browser, without
using plugins or Flash.  Instead, Shaka Player uses the open web standards
[MediaSource Extensions][] and [Encrypted Media Extensions][].

Shaka Player also supports [offline storage and playback][] of media using
[IndexedDB][].  Content can be stored on any browser.  Storage of licenses
depends on browser support.

Our main goal is to make it as easy as possible to stream adaptive bitrate
video and audio using modern browser technologies. We try to keep the library
light, simple, and free from third-party dependencies. Everything you need to
build and deploy is in the sources.

[DASH]: http://dashif.org/
[HLS]: https://developer.apple.com/streaming/
[MediaSource Extensions]: https://www.w3.org/TR/media-source/
[Encrypted Media Extensions]: https://www.w3.org/TR/encrypted-media/
[IndexedDB]: https://www.w3.org/TR/IndexedDB-2/
[offline storage and playback]: https://shaka-player-demo.appspot.com/docs/api/tutorial-offline.html


## Platform and browser support matrix

|Browser    |Windows   |Mac      |Linux    |Android  |iOS⁶|ChromeOS|Other|
|:---------:|:--------:|:-------:|:-------:|:-------:|:--:|:------:|:---:|
|Chrome¹    |**Y**     |**Y**    |**Y**    |**Y**    | N  |**Y**   | -   |
|Firefox¹   |**Y**     |**Y**    |**Y**    |untested⁵| N  | -      | -   |
|Edge¹      |**Y**     | -       | -       | -       | -  | -      | -   |
|IE ≤ 10    | N        | -       | -       | -       | -  | -      | -   |
|IE 11      |**Y** ⁴   | -       | -       | -       | -  | -      | -   |
|Safari¹    | -        |**Y**    | -       | -       | N  | -      | -   |
|Opera¹     |untested⁵ |untested⁵|untested⁵|untested⁵| N  | -      | -   |
|Chromecast²| -        | -       | -       | -       | -  | -      |**Y**|
|Tizen TV³  | -        | -       | -       | -       | -  | -      |**Y**|

NOTES:
 - ¹: Only the latest stable version is tested and supported. Older releases may still be usable, and we will accept pull requests for them, but they will not be officially tested or supported.
 - ²: Latest stable Chromecast firmware is tested. Both sender and receiver can be implemented with Shaka Player.
 - ³: Tizen 2017 model is actively tested and supported by the Shaka Player team. Tizen 2016 model is community-supported and untested by us.
 - ⁴: IE 11 offers PlayReady support on Windows 8.1 and Windows 10 only. IE 11 can play clear content on Windows 8.0. IE 11 does not support adaptive playback on Windows 7 and under. A separate [Promise polyfill][] is required for IE 11.
 - ⁵: These are expected to work, but are not actively tested by the Shaka Player team.
 - ⁶: All iOS browers use the same HTML engine (Apple WebKit) and are not supported because they lack MediaSource support. For more information, see: https://github.com/google/shaka-player/issues/997

[Promise polyfill]: https://github.com/lahmatiy/es6-promise-polyfill


## Manifest format support matrix

|Format|Video On-Demand|Live |Event|In-Progress Recording|
|:----:|:-------------:|:---:|:---:|:-------------------:|
|DASH  |**Y**          |**Y**| -   |**Y**                |
|HLS   |**Y**          |**Y**|**Y**| -                   |

You can also create a [manifest parser plugin][] to support custom manifest formats.

[manifest parser plugin]: https://shaka-player-demo.appspot.com/docs/api/tutorial-manifest-parser.html


## DASH features

DASH features supported:
 - VOD, Live, and In-Progress Recordings (dynamic VOD content)
 - MPD@timeShiftBufferDepth for seeking backward in Live streams
 - Multi-period content (static and dynamic)
 - Xlink elements (actuate=onLoad only, resolve-to-zero, fallback content)
 - All forms of segment index info: SegmentBase@indexRange, SegmentTimeline, SegmentTemplate@duration, SegmentTemplate@index, SegmentList
 - Multi-codec/multi-container manifests (we will negotiate support with the browser and choose the best ones)
 - Encrypted content (including custom ContentProtection schemas, PSSH in the manifest)
 - Key rotation
 - Trick mode tracks

DASH features **not** supported:
 - Xlink with actuate=onRequest
 - Manifests without any segment info: https://github.com/google/shaka-player/issues/1088
 - Changing codecs during a presentation (unsupported by MSE)
 - Multiple trick mode tracks for the same resolution at varying framerates or bitrates


## HLS features

HLS features supported:
 - VOD, Live, and Event types
 - Encrypted content with Widevine
 - ISO-BMFF / MP4 / CMAF support
 - MPEG-2 TS support (transmuxing provided by [mux.js][] v4.4+, must be separately included)
 - WebVTT and TTML

HLS features **not** supported:
 - Encrypted content with FairPlay: https://github.com/google/shaka-player/issues/382
 - Encrypted content with PlayReady: https://github.com/google/shaka-player/issues/1145
 - Key rotation: https://github.com/google/shaka-player/issues/917
 - I-frame-only playlists: https://github.com/google/shaka-player/issues/742
 - CEA-608/708 captions: https://github.com/google/shaka-player/issues/276
 - Raw AAC (without an MP4 container): https://github.com/google/shaka-player/issues/1083

[mux.js]: https://github.com/videojs/mux.js/releases


## DRM support matrix

|Browser   |Widevine  |PlayReady|FairPlay |ClearKey⁷ |
|:--------:|:--------:|:-------:|:-------:|:--------:|
|Chrome¹   |**Y**     | -       | -       |**Y**     |
|Firefox²  |**Y**     | -       | -       |**Y**     |
|Edge³     | -        |**Y**    | -       | -        |
|IE 11⁴    | -        |**Y**    | -       | -        |
|Safari    | -        | -       |**N** ⁵  | -        |
|Opera     |untested⁶ | -       | -       |untested⁶ |<commit_msg>Move CEA-608/708 to list of supported HLS features (#1465)<commit_after># ![Shaka Player](docs/shaka-player-logo.png)

Shaka Player is an open-source JavaScript library for adaptive media.  It plays
adaptive media formats (such as [DASH][] and [HLS][]) in a browser, without
using plugins or Flash.  Instead, Shaka Player uses the open web standards
[MediaSource Extensions][] and [Encrypted Media Extensions][].

Shaka Player also supports [offline storage and playback][] of media using
[IndexedDB][].  Content can be stored on any browser.  Storage of licenses
depends on browser support.

Our main goal is to make it as easy as possible to stream adaptive bitrate
video and audio using modern browser technologies. We try to keep the library
light, simple, and free from third-party dependencies. Everything you need to
build and deploy is in the sources.

[DASH]: http://dashif.org/
[HLS]: https://developer.apple.com/streaming/
[MediaSource Extensions]: https://www.w3.org/TR/media-source/
[Encrypted Media Extensions]: https://www.w3.org/TR/encrypted-media/
[IndexedDB]: https://www.w3.org/TR/IndexedDB-2/
[offline storage and playback]: https://shaka-player-demo.appspot.com/docs/api/tutorial-offline.html


## Platform and browser support matrix

|Browser    |Windows   |Mac      |Linux    |Android  |iOS⁶|ChromeOS|Other|
|:---------:|:--------:|:-------:|:-------:|:-------:|:--:|:------:|:---:|
|Chrome¹    |**Y**     |**Y**    |**Y**    |**Y**    | N  |**Y**   | -   |
|Firefox¹   |**Y**     |**Y**    |**Y**    |untested⁵| N  | -      | -   |
|Edge¹      |**Y**     | -       | -       | -       | -  | -      | -   |
|IE ≤ 10    | N        | -       | -       | -       | -  | -      | -   |
|IE 11      |**Y** ⁴   | -       | -       | -       | -  | -      | -   |
|Safari¹    | -        |**Y**    | -       | -       | N  | -      | -   |
|Opera¹     |untested⁵ |untested⁵|untested⁵|untested⁵| N  | -      | -   |
|Chromecast²| -        | -       | -       | -       | -  | -      |**Y**|
|Tizen TV³  | -        | -       | -       | -       | -  | -      |**Y**|

NOTES:
 - ¹: Only the latest stable version is tested and supported. Older releases may still be usable, and we will accept pull requests for them, but they will not be officially tested or supported.
 - ²: Latest stable Chromecast firmware is tested. Both sender and receiver can be implemented with Shaka Player.
 - ³: Tizen 2017 model is actively tested and supported by the Shaka Player team. Tizen 2016 model is community-supported and untested by us.
 - ⁴: IE 11 offers PlayReady support on Windows 8.1 and Windows 10 only. IE 11 can play clear content on Windows 8.0. IE 11 does not support adaptive playback on Windows 7 and under. A separate [Promise polyfill][] is required for IE 11.
 - ⁵: These are expected to work, but are not actively tested by the Shaka Player team.
 - ⁶: All iOS browers use the same HTML engine (Apple WebKit) and are not supported because they lack MediaSource support. For more information, see: https://github.com/google/shaka-player/issues/997

[Promise polyfill]: https://github.com/lahmatiy/es6-promise-polyfill


## Manifest format support matrix

|Format|Video On-Demand|Live |Event|In-Progress Recording|
|:----:|:-------------:|:---:|:---:|:-------------------:|
|DASH  |**Y**          |**Y**| -   |**Y**                |
|HLS   |**Y**          |**Y**|**Y**| -                   |

You can also create a [manifest parser plugin][] to support custom manifest formats.

[manifest parser plugin]: https://shaka-player-demo.appspot.com/docs/api/tutorial-manifest-parser.html


## DASH features

DASH features supported:
 - VOD, Live, and In-Progress Recordings (dynamic VOD content)
 - MPD@timeShiftBufferDepth for seeking backward in Live streams
 - Multi-period content (static and dynamic)
 - Xlink elements (actuate=onLoad only, resolve-to-zero, fallback content)
 - All forms of segment index info: SegmentBase@indexRange, SegmentTimeline, SegmentTemplate@duration, SegmentTemplate@index, SegmentList
 - Multi-codec/multi-container manifests (we will negotiate support with the browser and choose the best ones)
 - Encrypted content (including custom ContentProtection schemas, PSSH in the manifest)
 - Key rotation
 - Trick mode tracks

DASH features **not** supported:
 - Xlink with actuate=onRequest
 - Manifests without any segment info: https://github.com/google/shaka-player/issues/1088
 - Changing codecs during a presentation (unsupported by MSE)
 - Multiple trick mode tracks for the same resolution at varying framerates or bitrates


## HLS features

HLS features supported:
 - VOD, Live, and Event types
 - Encrypted content with Widevine
 - ISO-BMFF / MP4 / CMAF support
 - MPEG-2 TS support (transmuxing provided by [mux.js][] v4.4+, must be separately included)
 - WebVTT and TTML
 - CEA-608/708 captions

HLS features **not** supported:
 - Encrypted content with FairPlay: https://github.com/google/shaka-player/issues/382
 - Encrypted content with PlayReady: https://github.com/google/shaka-player/issues/1145
 - Key rotation: https://github.com/google/shaka-player/issues/917
 - I-frame-only playlists: https://github.com/google/shaka-player/issues/742
 - Raw AAC (without an MP4 container): https://github.com/google/shaka-player/issues/1083

[mux.js]: https://github.com/videojs/mux.js/releases


## DRM support matrix

|Browser   |Widevine  |PlayReady|FairPlay |ClearKey⁷ |
|:--------:|:--------:|:-------:|:-------:|:--------:|
|Chrome¹   |**Y**     | -       | -       |**Y**     |
|Firefox²  |**Y**     | -       | -       |**Y**     |
|Edge³     | -        |**Y**    | -       | -        |
|IE 11⁴    | -        |**Y**    | -       | -        |
|Safari    | -        | -       |**N** ⁵  | -        |
|Opera     |untested⁶ | -       | -       |untested⁶ |
{'fraction_non_alphanumeric': 0.15240963855421688, 'fraction_numerical': 0.012994836488812393, 'mean_word_length': 2.493986770895971, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 31, 'lorem ipsum': 0, 'www.': 6, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 21, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6658381', 'n_tokens_mistral': 3870, 'n_tokens_neox': 3629, 'n_words': 1145}