Allows you to create secondary name(s) for internal streams. Once an alias is created the localstreamname cannot be used to request playback of that stream. Once an alias is used (requested by a client) the alias is removed. Aliases are designed to be used to protect/hide your source streams.

API Parameter Table

Parameter Name Type Mandatory Default Value Description
localStreamName string true null The original stream name
aliasName string true null The alias alternative to the localStreamName
expirePeriod integer false -600 (10 mins) The expiration period for this alias. Negative values will be treated as one-shot but no longer than the absolute positive value in seconds, 0 means it will not expire, positive values mean the alias can be used multiple times but expires after this many seconds. The default is -600 (one-shot, 10 mins)

API Call Template

addStreamAlias localStreamName=<localStreamName> aliasName=<aliasName>

Sample API Call

addStreamAlias localStreamName=testpullStream aliasName=testStreamAlias expirePeriod=0

Stream with “testpullStream” as localStreamName will have an alias of “testStreamAlias”.

Success Response in JSON

"description":"Alias applied",

JSON Response

The JSON response contains the following details:

  • data – The data to parse.
    • aliasName – The alias alternative to the localStreamName
    • expirePeriod – The expiration period for the alias
    • localStreamName – The original stream name
  • description – Describes the result of parsing/executing the command
  • status – SUCCESS if the command was parsed and executed successfully, FAIL if not.

Alias in VOD

You can also set an alias for the VOD streams:

addStreamAlias localStreamName=mp4:myfile.mp4 aliasName=myVODalias expirePeriod=0

Media file with “myfile.mp4” filename will have an alias of “myVODalias


  • hasStreamAliases in config.lua should be TRUE
  • If you will use VOD as a stream source, you need to issue the VOD’s alias first or else the file will not be seen by EMS