@amazon/vinyl

An HTML5 playback engine for DASH and HLS streaming with first-class TypeScript support, zero runtime dependencies, and adaptive bitrate, prefetching, and gapless playback built in.

Install

npm install @amazon/vinyl

Quick Start

import { createVinylPlayer } from '@amazon/vinyl'

const media = new Audio()
media.controls = true
document.body.appendChild(media)

const player = createVinylPlayer({ media })
player.load({
    type: 'dash',
    uri: 'https://example.com/manifest.mpd',
})

Documentation

• Usage Guide — installation, loading tracks, queueing, prefetching, and configuration.
• Architecture — pipeline, controllers, and extensibility.
• DRM Configuration — Widevine, FairPlay, and PlayReady setup.
• DRM Controller — implementing custom license acquisition.
• DASH Manifest Transforms — rewriting manifests before parsing.
• Auto Reset — recovering from terminal playback errors.

Browse the full docs and TypeDoc API reference at amazonmusic.github.io/vinyl.

License

Apache-2.0