Livesim2 URL generator

host=https://livesim.dashif.org

Asset MPDs

SegmentTemplate variant $Number$ SegmentTimeline with $Time$ SegmentTimeline with $Number$ SegmentTimeline with $Time$ using Pattern for audio SegmentTimeline with $Number$ using Pattern for audio

General timing ...

time-shift buffer depth (seconds) minimum update period (seconds). Default is the segment duration suggestedPresentationDelay (seconds) UTCTiming methods (comma-separated list of: direct, head, ntp, sntp, httpxsdate, httpxsdatems, httpiso, httpisoms, keep, none. "keep" keeps values from the VoD MPD and cannot be combined with other values. Default is httpiso) startNumber (default=0) -1 translates to no value in MPD (fallback to default = 1)

Multi-period ...

number periods per hour (1-60) period continuity signaling XLink for completed periods

Low latency...

availabilityTimeOffset (float in seconds or inf) chunk duration for low-latency (float in seconds) low-latency target (milliseconds)

SSR

SSR Configuration (adaptationSetId,ssrValue;adaptationSetId,ssrValue;...) chunk duration for ssr (decimal) (adaptationSetId,chunkDuration;adaptationSetId,chunkDuration;...)

MPD Patch...

Provides delta DASH MPDs at a PatchLocation

Set a positive TTL in seconds

SCTE-35...

SCTE-35 emsg frequency No SCTE-35 emsg boxes 1 event per minute, duration 20s, start at hh:mm:10 2 events per minute, duration 10s, start at hh:mm:10 and hh:mm:40 3 events per minute, duration 10s, start at hh:mm:10, hh:mm:36, hh:mm:46

Start and stop...

timeline start (and availabilityStartTime) relative to Epoch (in seconds) stop time for time-limited event (in seconds) timeline start (and availabilityStartTime) relative to now (in seconds). Normally negative value. stop time for time-limited event relative to now (in seconds)

Generate time subtitles...

languages for generated subtitles in stpp-format (comma-separated) languages for generated subtitles in wvtt-format (comma-separated) Cue duration of generated time subtitles in ms (<=1000)

Time subtitle region Region 0 (bottom) Region 1 (top)

Inject in-band CTA-608 captions...

CEA-608 channel and language as <channel>-<lang> (e.g. CC1-eng). Injected into the AVC/HEVC video as a ticking UTC clock plus segment number, and advertised with an Accessibility descriptor. Only CC1 is supported. Rejected for encrypted or already-captioned assets.

Encryption and DRM

Encryption on-the-fly with keys via ECCP or commercial DRM systems. Pre-encrypted assets cannot be changed.

No DRM ECCP with cbcs encryption ECCP with cenc encryption EZDRM-provided DRM with one key CBCS encryption and certURL for Widevine, PlayReady, and Fairplay EZDRM-provided DRM setup with separate video and audio keys (Widevine and PlayReady, no certURL)

See /config for what commercial DRMs are configured.
For more about DASH-IF ECCP see DASH-IF IOP Part 6

Annex I URL Parameters...

query parameters in MPD to propagate to all video segment requests. Comma-separated key=value pairs.

Server-Guided Ad Insertion (SGAI, DASH Ed.6)...

Personalized live ad replacement via Alternative-MPD Replace events Ad-break schedule and options

The live stream is annotated with DASH 6th-edition Alternative-MPD Replace events. At each break the player resolves an ad-decisioning endpoint (default /sgai/ads), plays the returned ad pod (a List MPD), then resumes the live stream. Grammar:

( <off>:<dur>[,<off>:<dur>...] | p<period>:<dur> )[;key=val;...]

where each off:dur is one break, both in seconds:

off — break start, seconds from the period (availabilityStartTime) start
dur — break duration; also the maximum ad-pod duration (ads are trimmed to fit)
p<period>:<dur> — recurring breaks instead: a break of dur at every wall-clock multiple of period (e.g. p60:20 = 20 s at every start of a UTC minute, forever). Anchored to the wall clock, not the session start, so all viewers share the schedule and a late joiner can land in the middle of a break.

Optional ;key=val settings after the break list:

skipafter=<s> — ads become skippable after s seconds (default: not skippable)
nojump=<0|1|2> — restrict skipping the break by seeking (default 0)
clip=<0|1> — clip the replaced main content (default 1)
once=<0|1> — each event executes only once (default 1)
resolve=<s> — earliestResolutionTimeOffset: how many seconds before the break the player may resolve the ad (default 60)
ep=<path> — ad-decisioning endpoint path (default /sgai/ads)

Example:

30:15,90:15;skipafter=5;nojump=2

two 15 s breaks (at 30 s and 90 s), skippable after 5 s, not skippable by seeking.
During each break the underlying (clear AVC) video track serves a generated AD BREAK slate with a per-second countdown to the end of the break — the visible "ad to be replaced", i.e. the base ad. Players that execute the Replace event cover it with the personalized pod; others show the slate. Audio is untouched.
An ad pod is only returned for an interest-steered request: with no interests (or interests that match no creative) the decisioning answers 404, the Replace event is skipped, and every player keeps the AD BREAK slate (the base ad). This is the default when neither sessionId nor interests are given.
Cannot be combined with the multi-period / xlink / insertad options.

sessionId — personalization & reporting key (keys the impression beacons; with interests, rotates the pod per session for variety). On its own it does not produce a pod. There is a single sessionId per viewer, shared with Content Steering — this field and the steering one are kept in sync. interests — comma-separated interest tags; matching ads (tagged in ads/ads.json) lead the pod. Required to get an ad pod — without interests the player keeps the AD BREAK slate (the base ad). The bundled demo ads are tagged travel (train, Namibia ×2, of which one also safari) and sailing/boats (Gotland Runt, Sailing in Stockholm) — see /api/sgai/ads.

sessionId and interests are added as MPD-URL query parameters and propagated to the ad-decisioning request via Annex I, so each viewer can receive a different, interest-steered ad pod. With no interests the decisioning returns no pod and the viewer sees the base ad (the AD BREAK slate). Watch ad decisions and impression beacons live at /sgai/session_status.

DASH Content Steering (ISO/IEC 23009-1 6th ed., ETSI TS 103 998)...

Multi-CDN steering with a steering server on this same host Service locations and options

The MPD advertises two or more service locations ("CDNs") — all pointing back to this server — plus a root <ContentSteering> element referencing a steering endpoint here. The player polls it, gets a PATHWAY-PRIORITY ordering with a TTL, and switches CDN accordingly. Grammar:

<loc1>,<loc2>[,<loc3>...][;key=val;...]

at least two comma-separated service-location names, then optional ;key=val settings:

ttl=<s> — steering-manifest TTL in seconds; the client re-polls every TTL (default 300)
mode=rotate|trigger — trigger (default) holds the priority at the default order until you trigger a switch via the API / monitor; rotate rotates the priority one step every TTL automatically (wall-clock based, all clients in lockstep)
qbs=<0|1> — queryBeforeStart: resolve the steering server before playback starts (default 0)
default=<name> — the initial top service location (default: the first one listed)

Example:

alpha,beta;ttl=20

two CDNs, 20 s TTL, priority held on alpha until you flip it (trigger is the default).
Cannot be combined with the traffic option (both generate BaseURLs).

sessionId — per-viewer steering & reporting key (baked into each BaseURL so segment requests are attributed per CDN; required to follow one session in the monitor). There is a single sessionId per viewer, shared with SGAI — this field and the SGAI one are kept in sync. csid — optional content-steering group id (path token). Give several viewers the same csid (with distinct sessionIds) and one switch moves the whole group together, while each viewer's per-CDN counts and verification stay individual. Leave empty for a standalone stream.

Watch the per-CDN segment request distribution and the current priority live, and drive a change with the Switch CDN / make-top buttons, at /steering/session_status, or via the API at /api/steering/sessions[/<sid>] and POST /api/steering/sessions/<sid>/switch. To move a whole group at once use /api/steering/groups[/<csid>] and POST /api/steering/groups/<csid>/switch, or open the monitor with ?csid=<group>.

Negative test cases...

Patterns of cyclic segment response codes

A square-bracket-surrounded list of comma-separated patterns, like

[{code:404,cycle:30,rsq:0,rep:video},{code:403,cycle:60,rsq:1}]

where:

code is an HTTP response code in the range 400-599
cycle is cycle in seconds
rsq is the relative sequence number in the cycle
rep is a comma-separated list of representation IDs to which the pattern applies (can be empty)

Traffic Patterns for one or more BaseURLs

Specify time interval for loss patterns for one or more BaseURLs with "up (u)", "down (d)", "slow (s)", or "hang (h)" states, like

u50d10,u10d50

d1,u1,u45s10h5

where:

u50d10,u10d50 is two pairs (two base URLS)
u50d10 means 50s up time and 10s downtime (60s cycle)
u10d50 means 10s up time and 50s downtime (60s cycle)
d1,u1,u45s10h5 means three base URLS where the first is always down, the second is always up, and the third is up 45s, slow 10s, and hanging 5s every minute

During a "down (d)" interval, all segment requests will result in a "404 Not Found" response.
During a "slow (s)" interval, all segment responses are delayed by 2s.
During a "hang (s)" interval, all segment responses hang for 10s before resulting in 503.