Getting Started (TL;DR Version)
git clone https://github.com/norskvideo/media-examples cd media-examples ./run-example --list
That should prompt you for the location of your license file and what IP address you will access Norsk on (if in doubt you probably want 127.0.0.1).
You have to do that once, and once only (the results are stored in a file called
.config if you ever want to change your mind). You should then get a list of the examples in the repo, along with brief descriptions of what they do.
You can run examples via their full name (e.g.
01_rtmp_to_webrtc), just their number (
01) or just their name (
rtmp_to_webrtc). Lets get started with some low latency HLS and Dash…
./run-example start 03_rtmp_to_hls_passthrough
With any luck you’ll see several Docker Containers pulled down, some code compiling and then a number of containers spring to life, finishing with output along the lines of:
Workflow visualiser URL http://127.0.0.1:6791/visualiser
Output from 03_rtmp_to_hls_passthrough (ctrl-c to return to shell - this will not kill the containers!)
Multi variant playlist: http://127.0.0.1:8080/cmaf/file/multi-variant.m3u8
audio playlistUrl: http://127.0.0.1:8080/cmaf/file/stream/norsk/1/1/default/norsk.m3u8
video playlistUrl: http://127.0.0.1:8080/cmaf/file/stream/norsk/1/2/default/norsk.m3u8
If you point your favorite HLS player at one of those links, you should see (or hear!) output. (You might see a different IP depending on how you replied to the initial license / IP prompt and what the address of your Docker server is if it’s running remotely or in a VM.) And if you open the Workflow Visualiser you’ll see:
That little setup started the Norsk Media Server, compiled and ran the
rtmp_to_hls_passthrough demo and fired in a media source which the app converted into low latency HLS.
When you are done, running
will clean up for you.