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

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: /path/to/usp-license.key
Apache/2.4.7 (Ubuntu) IISMS/4.0 configured -- resuming normal operations

To check your license using mp4split, use the --license-key option together with the --show-license option described in the section below.

Showing License key features (and when it expires)

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

#!/bin/bash

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

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=/path/to/usp-license.key --show-license

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