License Key Information

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

Origin HLS MPEG-DASH HDS/HSS Encoder Ingest Metadata (SCTE 35) Progressive/MP4
VOD y y y      
Live 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>

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.

Note

Please note that on Linux unified_capture is installed by the mp4split package. There is no separate install or donwload as there is on Windows.

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 $@"

Showing License key features

To show which features are supported for a certain license key, use the --license-key option together with the --show-license option, and no other command line arguments:

mp4split --license-key=/path/to/usp-license.key --show-license

If the license is valid, and not expired, this will print feature information in a format similar to:

mp4split version=1.10.11 (18541)    Copyright 2007-2019 CodeShop B.V.

Product name: Unified Streaming Platform
License type: production
License email: license@unified-streaming.com
Starting at: 2019-01-30 00:00:00 UTC
Expiring at: 2020-02-01 00:00:00 UTC
Supported features:
  Packaging: DASH HDS HLS ISS MP4 CMAF
  Capturing: DASH HDS HLS ISS decryption
  Verifying: media urls sitemap
  Streaming: VOD Live MPEG-TS
  Remixing: VOD
  Encoding: AAC AVC HEVC
  Decoding: AAC AVC HEVC
  Metadata: Timed
  DRM: yes

Unified Remix

Licensing for Remix is available on request. Available options:

Remix Playlist MP4 Metadata Transcode AVC
VOD      

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 Information 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