License Key

After registration on our website, you can get an evaluation key by clicking the following button:




The website will ask you to login before you can get a key. If you do not have a login, please go to registration first.

Unified Origin

The following lists available features (y indicates they're part of the evaluation):

VOD/Live

  HLS HDS ISS DASH Progressive/MP4 Encoder Ingest
VOD y y y y    
Live y y y y   y

DRM

DRM is not port of the evaluation. Please see Unified Origin - DRM for an overview of possibilities.

License key location

Please note that each of the webservers has their own unique location for its configuration.

Apache License Key

For Apache, the UspLicenseKey server directive must be used which maye be placed in the vhost conf file before the actual virtual host:

UspLicenseKey /path/to/usp-license.key

<VirtualHost *:80>

  # Rest of config

</VirtualHost>

Nginx License Key

For Nginx, the usp_license_key server directive must be used which is placed in the http section of nginx.conf (before any server block):

http {
  usp_license_key /path/to/usp-license.key;

  # rest of config

}

Unified Capture

You need to pass the key on the command line with the --license-key option.

#!/bin/bash

unified_capture --license-key=/path/to/usp-license.key \
  -o oceans.ismv \
  http://example.com/channel01/channel01.isml/Manifest

Capture is not part of the evaluation. Possible outputs are:

Capture VOD Live
DASH y n
F4F (HDS) y n
HLS y n
ISMV (Smooth) y y
MP4 n n
Decrypt y y

When capturing Live, the only format available is ismv. The packager can be used to create other formats.

Unified Packager

The following features are available with the evaluation. Please note that all features can be licensed.

Packaging MP4 HSS HDS HLS DASH CMAF
MP4            
HSS            
HDS            
DASH            
CMAF            
Subtitles            
Alternate Audio            
Server Manifest creation   y        
Client Manifest creation   y        

License key

You need to pass the key on the command line with the --license-key option.

#!/bin/bash

mp4split --license-key=/path/to/usp-license.key \
  -o oceans.ism \
  oceans.mp4

License key wrapper

For convience, you may want to create a wrapper script or alias for mp4split.

The wrapper for mp4split could be the following:

#!/bin/bash
mp4split --license-key=/path/to/usp-license.key $@
  • this you save in a file in your home directory (where you enter when logging in) as for instance 'mp4split-run'
  • the $@ part will pass the options you give the script to mp4split
  • to make the script executable do 'chmod +x mp4split-run'

The second option is to create an alias in your .bashrc

alias mp4split="/path/to/mp4split --license-key=/path-to/usp-license.key $@"

License installation check

After (re)starting Apache you should see the following in the Apache error.log (/var/log/apache2/error.log on Ubuntu):

License key found: YOUR_KEY
Apache/2.4.7 (Ubuntu) IISMS/4.0 configured -- resuming normal operations

Alternatively you can execute mp4split which will either complete (and complain about 'no output file') or print an error message as outlined below:

#!/bin/bash

mp4split --license-key YOUR_LICENSE_KEY

License duration check

The license key is a base64 encoded string which can be decoded as follows:

#!/bin/bash

echo YOUR_LICENSE_KEY | base64 -d

A decoded example for instance looks like the following:

test@unified-streaming.com|20180901 00:00:00,90|package(iss,mp4,hds,hls,dash,cmaf);stream(vod,live);drm(aes);io_opt();capture();check();support(1);oem();remix(npvr,vod);encode();decode();metadata(timed);version(1.7.4)|default|563d86f08c744f30b74dbe5fe8c3c08b|93d57ab62da31239772e0307d13e3926c4de5eea1288d674591834516ebadfa0f45d9e3a6b3f8f279285866650964369016c3962c2c085e16e854e790dee661597bfef02305083c5635820e3bb3234c820c378a93b9d5a272dee7fc9fab51e59b7943e22c263a55ada6245ecb1d2258c9b6e43cb09d8e847c5edcc2db91ac20e

The fields have the following use and meaning:

Key part Example
Email address test@unified-streaming.com
Start date and duration 20180901 00:00:00,90
Policy (licensed options) package(iss,mp4,hds,hls,dash,cmaf);stream(vod,live);drm(aes);io_opt();capture();check();support(1);oem();remix(npvr,vod);encode();decode();metadata(timed);version(1.7.4)
Key name default
Identity (a UUID) 563d86f08c744f30b74dbe5fe8c3c08b
Signature (key string signed with private key) 93d57ab62da31239772e0307d13e3926c4de5eea1288d674591834516ebadfa0f45d9e3a6b3f8f279285866650964369016c3962c2c085e16e854e790dee661597bfef02305083c5635820e3bb3234c820c378a93b9d5a272dee7fc9fab51e59b7943e22c263a55ada6245ecb1d2258c9b6e43cb09d8e847c5edcc2db91ac20e

In short, license key duration 9and expiry) can be calculated from the second field using the following rule:

start date + duration = expiry date

Error messages

Errors related to the license key are described below.

'no policy for'

If a call to mp4split (or the webserver) results in for instance the following it means the required permission is not part of the license:

Status: 403 FMP4_403
X-USP-Error: drm: no policy for Widevine encryption

This message will be printed in the Apache error log or in the shell (stdout). Please contact license@unified-streaming.com.

'verify license signature not valid'

The key is meant for a different version (for instance trying a 1.6 key with a 1.7 version)

'license expired'

The license expired, please contact license@unified-streaming.com.

'base64_decode: unexpected end of file'

If you get the following error in your Apache error.log:

terminate called after throwing an instance of 'fmp4::exception'
what(): 415 FMP4_415 (base64_decode: unexpected end of file?)

please check you copied the license key correctly.

You can for instance test with

#!/bin/bash

mp4split --license-key=YOUR_LICENSE_KEY

where YOUR_LICENSE_KEY is the key you received.

'keyfile not found'

This means the license key cannot be found. Please refer to the License Key page on how to install it:

'could not connect to host'

Evaluation versions require internet access to the following:

  • Google's DNS servers (8.8.8.8:53/8.8.4.4:53)
  • keys.unified-streaming.com (46.23.86.208:80)

Please make sure your firewall settings allow this.

If this is not set up the resulting error will look like the following:

apache mod_smooth_streaming (version=1.7.10) failed to initialize! (error
message: could not connect to host), please contact license@unified-streaming.com