downstream-electron

DOWNstream For Electron

Summary

DOWNstream is an open-source plugin to use with Electron allowing encrypted MPEG-DASH and Smooth Streaming streams to be safely downloaded and stored locally on a user’s Windows or Mac computer.

castLabs Electron Release for Content Security

To simplify the use of Widevine DRM and allow protected playback of offline content within Electron castLabs has created a fork with support for Widevine CDM installation, Verified Media Path (VMP), and protected storage of offline licenses. Such a release is installed by the default npm package scripts, see Development and Build sections below.

More information is available here:

https://github.com/castlabs/electron-releases

Development

• (optional) npm run clean
• npm install
• npm start

Build

• npm install
• npm run build
• npm start

Examples

• npm install
• npm start -- example=name

• (default) Example: main

Extended example showing most of the features of the downstream_electron library

• Example: drm

Basic example presenting usage of DRM protected stream with downstream_electron library

Integrations

Redux

Directory integrations/redux contains a full example of integration downstream_electron with React & Redux frameworks.

Development

• cd integrations/redux
• npm install
• npm run dev

Release

• cd integrations/redux
• npm install
• npm run dist

Documentation

Documentation is available publicly at https://castlabs.github.io/downstream_electron/

• npm run jsdoc
• Open jsdoc/index.html in any browser
• If you want to generate docs with private methods run npm run jsdoc_prv

ESLint

• npm run eslint

Debugging in intellij / webstorm

• Create new node.js configuration
• Node interpreter: /node_modules/.bin/electron
• Javascript file: index.js

Known issues

• Electron installation in macOS (https://github.com/castlabs/electron-releases/issues/144) - we recommend to use one of the workaround mentioned in the GitHub issue.

More information

https://castlabs.com/resources/downstream/

License

Copyright (C) 2017 Castlabs GmbH. Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0