Service: HLS Playlist Viewer - EyevinnOSC/community GitHub Wiki
HLS Playlist Viewer
HLS Playlist Viewer (serviceId nfrederiksen-hls-viewer) is an open source browser-based tool for inspecting HLS streams. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance. Source: Nfrederiksen/hls-viewer.
What it can do
- Load any HLS manifest URL (
.m3u8) and browse the playlist hierarchy: master playlist, media playlists and segment details. - Show variant streams with bandwidth, resolution and codecs.
- Show segment durations, discontinuity markers and byte ranges.
- Show EXT-X tags including program date/time, media sequence and target duration.
- Debug adaptive bitrate issues and verify output from a packager such as Shaka Packager or SVT Encore, including checking segment counts and durations.
Creating an instance
HLS Playlist Viewer has no dependencies on other OSC services. Create it with create-service-instance, serviceId: "nfrederiksen-hls-viewer", and a config object with only a name (alphanumeric, at most 20 characters):
{ "name": "myhlsviewer" }
Use wait-for-service-ready or get-instance-status to confirm it is running, then describe-service-instance to read the instance URL.
With the OSC CLI:
npx -y @osaas/cli create nfrederiksen-hls-viewer myhls-viewer
npx -y @osaas/cli describe nfrederiksen-hls-viewer myhls-viewer
Options
| Option | Required | Type | Meaning |
|---|---|---|---|
| name | Yes | string | Name of the instance. Alphanumeric, at most 20 characters. |
There are no other options.
Using the instance
Open the instance URL in a browser, paste an HLS manifest URL into the input field and press Load. The tool fetches and parses the manifest and displays the playlist details listed above.
The service has no authentication of its own; the viewer is accessible at the instance URL.
Resources
- GitHub: Nfrederiksen/hls-viewer
- Service: HLS Stream Monitor, automated alerting for HLS stream health