Getting Started (TL;DR Version)

If you are as impatient was we are (and if you have Docker Compose installed - if not check the repo’s Readme), then go grab an evaluation license and run the following!

git clone
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

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

Output from 03_rtmp_to_hls_passthrough (ctrl-c to return to shell - this will not kill the containers!)

Multi variant playlist:
audio playlistUrl:
video playlistUrl:

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:

visualiser rtmp hls

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

./run-example stop

will clean up for you.


You are up and running with Norsk!