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.mpdto use SegmentTimeline/livesim2/ato_inf/testpic_2s/Manifest.mpdto set availabilityTimeOffset to infinity/livesim2/periods_60/testpic_2s/Manifest.mpdfor 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