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