Service: Livesim2 - EyevinnOSC/community GitHub Wiki

Livesim 2

Livesim 2 (serviceId dash-industry-forum-livesim2, BSD license) is an open-source MPEG-DASH live stream simulator from the DASH Industry Forum. It generates infinite, continuously updating DASH manifests from pre-encoded content, so you can test DASH players, adaptive bitrate logic and live stream integrations without a real encoder or live feed. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance.

What it can do

  • Produce infinite live DASH streams from looping built-in test content, presented with a sliding window.
  • Change stream behavior through URL path parameters (SegmentTimeline, availabilityTimeOffset, multi-period and more).
  • Support flexible content handling and on-the-fly subtitles in multiple languages (per the project description).
  • Serve as a test and demo source for players and live workflows.

Creating an instance

Livesim 2 has no dependencies and its only option is the instance name. Call create-service-instance with serviceId: "dash-industry-forum-livesim2":

{ "name": "mylivesim" }

Then wait-for-service-ready (or get-instance-status) and describe-service-instance to get the instance URL.

Equivalent OSC CLI usage: osc create dash-industry-forum-livesim2 mylivesim

Options

Option Required Type Meaning
name Yes string Name of the instance. Letters, digits and underscore (^\w+$); OSC limits names to 20 characters.

Using the instance

The default test stream is available at:

https://<your-instance-url>/livesim2/testpic_2s/Manifest.mpd

URL path parameters control stream behavior, for example:

  • /livesim2/segtimeline_1/testpic_2s/Manifest.mpd to use SegmentTimeline
  • /livesim2/ato_inf/testpic_2s/Manifest.mpd to set availabilityTimeOffset to infinity
  • /livesim2/periods_60/testpic_2s/Manifest.mpd for a multi-period stream with 60-second periods

The full list of URL parameters is in the Livesim 2 README.

Play the stream with a DASH player:

// Using dash.js
const player = dashjs.MediaPlayer().create();
player.initialize(
  document.querySelector('video'),
  'https://<your-instance-url>/livesim2/testpic_2s/Manifest.mpd',
  true // autoplay
);

Or test with ffprobe:

ffprobe https://<your-instance-url>/livesim2/testpic_2s/Manifest.mpd

Resources