JavaScript player library / DASH client / MSE-EME player
JavaScript Python Other
joeyparrish Move availabilityWindowOverride to manifest parsers
This reverts the implementation to an earlier draft state.  During
review of the first version, I recommended moving the implementation
to Player so that it would be independent of the manifest parsers.
That was bad advice on my part, because this overlooked updates made
by the parsers when live manifests are updated later.

Closes #1177
Closes #1307

Change-Id: I4611e00824dead83c6467da04a2a11afa892ace7
Latest commit ecd27fb Jul 20, 2018
Permalink
Failed to load latest commit information.
.github Change goo.gl links to bit.ly. Jun 22, 2018
build Created Destroyer Class To Handler IDestroyable Jul 9, 2018
demo Make Storage Only Accept Non-Null Player Jul 17, 2018
docs Add list sign-up screenshot Jul 9, 2018
externs Move availabilityWindowOverride to manifest parsers Jul 20, 2018
lib Move availabilityWindowOverride to manifest parsers Jul 20, 2018
test Move availabilityWindowOverride to manifest parsers Jul 20, 2018
third_party Fix output wrapper for Electron, ESM, and Closure Jun 20, 2018
.eslintrc.js Re-enable some disabled style rules Jul 9, 2018
.gitattributes [ES6] Force JS files to use unix newlines on Windows Jan 18, 2018
.gitignore Ignore the package lock from new versions of npm Aug 28, 2017
.htmlhintrc Whitelist svg camelcase attributes in htmlhint Jan 18, 2017
.npmignore Add missing .gitattribute to .npmignore Feb 9, 2016
AUTHORS Add new request type TIMING for clock sync requests (#1489) Jul 16, 2018
CHANGELOG.md Update changelog for v2.4.2 and v2.3.10 Jun 29, 2018
CONTRIBUTING.md Remove all.sh and test.sh Feb 3, 2016
CONTRIBUTORS Add new request type TIMING for clock sync requests (#1489) Jul 16, 2018
LICENSE Renaming LICENSE.txt to LICENSE to match google3 requirement Sep 4, 2015
README.md Add list sign-up screenshot Jul 9, 2018
index.html Fix accessibility issues Oct 17, 2016
karma.conf.js Increase launcher shutdown timeout Jun 13, 2018
package.json Unfork "wd" module Jun 1, 2018
shaka-player.uncompiled.js Integrate StorageMuxer and Player May 9, 2018
support.html Fix demo background, margins on TV Mar 27, 2018

README.md

Shaka Player

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.

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

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.

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:

DRM support matrix

Browser Widevine PlayReady FairPlay ClearKey⁷
Chrome¹ Y - - Y
Firefox² Y - - Y
Edge³ - Y - -
IE 11⁴ - Y - -
Safari - - N -
Opera untested⁶ - - untested⁶
Chromecast Y Y - untested⁶
Tizen TV Y Y - untested⁶

Other DRM systems should work out of the box if they are interoperable and compliant to the EME spec.

NOTES:

  • ¹: Only official Chrome builds contain the Widevine CDM. Chromium built from source does not support DRM.
  • ²: DRM must be enabled by the user. The first time a Firefox user visits a site with encrypted media, the user will be prompted to enable DRM.
  • ³: PlayReady in Edge does not seem to work on a VM or over Remote Desktop.
  • ⁴: IE 11 offers PlayReady support on Windows 8.1 and Windows 10 only.
  • ⁵: FairPlay DRM support in Safari is a work in progress due to a lack of documentation. For more information, see https://github.com/google/shaka-player/issues/382
  • ⁶: These are expected to work, but are not actively tested by the Shaka Player team.
  • ⁷: ClearKey is a useful tool for debugging, and does not provide actual content security.

Media container and subtitle support

Shaka Player supports:

  • ISO-BMFF / CMAF / MP4
    • Depends on browser support for the container via MediaSource
    • Can parse "sidx" box for DASH's SegmentBase@indexRange and SegmentTemplate@index
    • Can find and parse "tfdt" box to find segment start time in HLS
  • WebM
    • Depends on browser support for the container via MediaSource
    • Can parse cueing data elements for DASH's SegmentBase@indexRange and SegmentTemplate@index
    • Not supported in HLS
  • MPEG-2 TS
    • With help from mux.js v4.4+, can be played on any browser which supports MP4
    • Can find and parse timestamps to find segment start time in HLS
  • WebVTT
    • Supported in both text form and embedded in MP4
  • TTML
    • Supported in both XML form and embedded in MP4

Subtitles are rendered by the browser by default. Applications can create a text display plugin for customer rendering to go beyond browser-supported attributes.

Important Links

Contributing

If you have improvements or fixes, we would love to have your contributions. Please read CONTRIBUTING.md for more information on the process we would like contributors to follow.

FAQ

For general help and before filing any bugs, please read the FAQ.