livesim-content

This repo contains test content used by the DASH-IF online service livesim2.

For easy download, a mixed storage format is used where each representation directory with hundreds of files is made into an archive (in zip format) while top-level files are kept separated.

This allows for simple changes to the MPDs, while making the downloads more efficient. Since github has a file size limit of 100MB, git-lfs is used.

There are also metadata files for each representation to allow for boosted startup of livesim2, like testpic_2s/V300_data.json.gz. By reading these files, livesim2 has the knowledge about the duration of each segment and does not need to scan all the segments at startup. These reduces the startup time for livesim2 when run with all the content of this repo substantially goint from minutes to seconds.

The repdata files are generated by running livesim2 with the option --writerepdata.

Download assets

To download the assets, you need git-lfs installed.

On Linux, use your package manager to install it like:

> apt install git-lfs

On Mac, you can analogously run

> brew install git-lfs

After that, it should be fine to run

> git clone VoD source for DASH-IF livesim2.git

Unpacking the content

You finally need to unpack the content.

ALl content can be unzipped using the top-level command

> unpack_all.sh

that iterates through the directories and unzips all zip files.

You can also unpack a single asset like testpic_2s using

> cd testpic_2s
> ../tools/unpack.sh

to unpack all the zip-files. If you want to remove the .zip files, run tools/unpack_and_clean.sh instead.

You can remove the zip-files, but it may be good to keep them so that an update via git only downloads new assets. After a git update, check if any zip-file has been updated and run the unpack tool on that specific directory.

The asset should now be in a format that can be read and processed by livesim2, provided that it is in a subdirectory under --vodroot.

Assets

The assets available are:

testpic_2s

A 1-hour long asset with 2s segments with 30fps video and many subtitle options.

The MPDs that can be played live are:

Name	Specifics	livesim2 status
Manifest.mpd	base simple MPD using SegmentTemplate with $Number$	OK
Manifest_avc3.mpd	same as Manifest.mpd but with avc3 codec signaling	Bad (init_avc3.mp4 missing)
Manifest_dvb.mpd	same as Manifest.mpd, but adding DVB profiles	OK
Manifest_stpp.mpd	Manifest.mpd extended with stpp subtitles	OK
Manifest_thumbs.mpd	Manifest.mpd extended with DASH-IF image subtitle track	OK
Manifest_trickmode.mpd	Manifest.mpd extended with DASH trick mode track	OK
audio.mpd	audio only	OK
cea608.mpd	video includes two CEA-608 caption tracks	OK
cea608_and_segs.mpd	same as cea608.mpd extended with stpp subtitle track	OK
multi_subs.mpd	Manifest.mpd extended with 5 subtitle and caption tracks in stpp format	OK
stpp_one_region.mpd	Manifest.mpd extended with S1_one_region stpp subtitles	OK
stpp_two_regions.mpd	Manifest.mpd extended with S1_two_regions stpp subtitles	OK
stpp_two_regions_multi_color.mpd	Manifest.mpd extended with S1_two_regions_multi_colors stpp subtitles	OK

In addition, there is a couple of MPDs that can only be played as VoD because of side-loaded subtitle files or too short subtitle track.

Name	Specifics	livesim2 status
img_subs.mpd	Manifest.mpd extended with image subtitles in side-loaded TTML format (not supported by livesim)	N/A
ttml_subs.mpd	Manifest.mpd extended with side-loaded TTML files (1h) (not supported by livesim)	N/A
imsc1_img.mpd	Manifest.mpd with properly signaled IMSC-1 stpp image subtitles. Only one minute	Does not play

testpic_6s

A 1-hour long asset with 6s segments with 30fps video and two audio tracks.

The MPDs are:

Name	Specifics	livesim2 status
Manifest.mpd	base simple MPD using SegmentTemplate with $Number$	OK
multiaudio.mpd	same as Manifest.mpd but with two audio tracks (the second is a copy of the first via a symbolic link)	OK
mixeddur.mpd	combination of 6s audio segments with 2s video segments (the latter from testpic_2s)	OK

testpic4_8s

A 1-hour long asset with 8s segments with 30fps video at three bitrates (300kbps, 600kbps, and 1200kbps) and MPDs that contain different subsets.

The MPDs are:

Name	Specifics	livesim2 status
Manifest.mpd	base simple MPD using SegmentTemplate with $Number$ and all bitrates	OK
Manifest_300.mpd	same as Manifest.mpd but limited to 300kbps video	OK
Manifest_600.mpd	same as Manifest.mpd but limited to 300kbps and 600kbs video	OK