Configuration

Reading time ~14 minutes

Before starting work with Cinegy Live, adjust the settings using the Cinegy Live configuration tool.

Setup button

To open the configurator, press this button or use the "Configure…" layout context menu command. The configuration window contains four tabs: General, Inputs, Sources, and Output.

General Settings

The "General" tab settings are split into groups: Transitions, Repository, and Logging.

Transitions

Mix duration – define the desired duration of the mix effect in milliseconds.
Crossfade – select this option to enable cross fade creation.

Repository

Path – leave the default destination folder or press the button to choose the desired path for storing service information about Cinegy Live application performance.

Logging

Debug log level – define the level for the log file by choosing "Partial", "Full", "Custom" or "None" to disable logging.
Debug log folder – define the location of the log file where the sequence of operations is recorded. Leave the suggested default folder or press the button to change the path.
Dump folder – define the location of dump files for recording information about Cinegy Live failure.
Custom debug log levels – manually choose the debug log level by changing values of trace level (0 – 5) and error level (0 – 5).

Note
This group is available for the custom level logging only.
New log file every – define how often a new log file is created.
New day start at – define when a new broadcasting day starts.

Input Settings

The "Inputs" tab allows users to map the input channels to the reference sources:

The left part of the "Inputs" tab contains the list of channels arranged in the numerical order. The right part of the tab indicates the type and source of the selected channel. The read-only "Type" field shows the source type defined by the selected source. To change the source of the selected channel, use the "Source" drop-down list to select a different configured source for the selected input.

The buttons below the channels list allow users to change the amount of channels and their order.

Up button

Use the "Up" and "Down" buttons to reorder the channels.

Add button

Press the "Add" button to add a new input channel. The channel is created at the end of the list. It has no source mapping, which is indicated by the <No source> title. To define its source, use the "Source" drop-down list.

Add button

Press the "Remove" button to delete the selected channel.

Source Settings

The "Sources" tab allows configuring of the input sources settings. It consists of the channels list (on the left) and their settings (on the right):

To add a channel to the list, press Add source below the list of channels. To delete a selected channel, press Remove source.

Select a channel in the list and use the following settings to configure it:

Title – enter the name to be imprinted on top of the channel preview. This title is used to define channel sources on the "Inputs" tab.
Source type – choose the source type: SDI, NDI, MPEG-TS, File, Shared RAM or Web Cam.

Further settings depend on the selected source type.

MPEG-TS Source

When the MPEG-TS source is selected, the following properties can be configured:

Video format – choose the necessary video format from the drop-down list.
URL – define the RTP, UDP, or SRT URL for this stream via the keyboard or press the button to select a video stream registered on the specified server by Cinegy Route Directory Service using the integrated Cinegy Route browser that appears:

Note
Only streams marked as "Visible" for current user are displayed here.

Note
Using of the integrated Cinegy Route browser is only available with Cinegy Route Browser v15 installed and available on the machine running the Cinegy Live configurator.

Select the required video stream and press "OK". It will be automatically converted to RTP/UDP/SRT URL:

Important
Refer to the RTP/UDP URL article for more information about the RTP and UDP URLs.

Important
The SRT Input Setup section below details the configuration of the SRT input.
IP listen – the IP address of the local network adapter to be used for getting the RTP/UDP/SRT stream. This option is useful in multicast mode, when you need to divide the multicasting subnet from the working subnet.

Note
Set the "IP listen" parameter to 0.0.0.0 to use all the adapters.
GPU Decoding - select the required video card from the drop-down list to be used for GPU acceleration or choose "No GPU decoding" to use only CPU resources for encoding and decoding.

SRT Input Setup

SRT (Secure, Reliable Transport) is an open source video transport protocol which operates as unicast UDP.

To set up SRT input, type in the "URL" field the required stream URL starting with srt://.

Cinegy Live supports encrypted SRT streams and will automatically decrypt them on input with an SRT passphrase specified in the input stream URL as follows:

srt://1.2.3.4:8888/?pass=AAAAABBBBB

srt://1.2.3.4:8888/?serviceId=2001&videoPid=2110&audioPids=2120&pass=AAAAABBBBB

Note	Please note that in accordance with SRT requirements, the passphrase length should be between 10 and 79 characters.

File Source

When the File source is selected, the following properties can be configured:

Path – use the button to select the media source file on your local disk or a network location or enter the path manually via the keyboard.
Start on Take – enable this option to force instant playback of the input source file after sending to output.
Rewind on Stop – select this option to rewind the paused video to the beginning.

SDI Source

When SDI source is selected, the following properties can be configured:

Video format – choose the necessary video format from the drop-down list.
Device – select the input device from the drop-down list.

Further settings depend on the input device chosen from the "Device" drop-down list:

DeckLink input;
DVS input;
AJA input;
Deltacast input.

DeckLink Input Settings

Define the board number using the up and down arrows buttons or entering the desired value via the keyboard in the "Board number" field:

DVS Input Settings

For DVS input device the following settings are available:

Define the board number using the up and down arrows buttons or entering the desired value via the keyboard. Specify channel mode using the corresponding drop-down list on the right.

AJA Input Settings

For AJA input device the following settings are available:

Board number – define the board number using the buttons or entering the desired value via the keyboard.
Video input – define the video input type selecting SDI, Analog or HDMI from the drop-down list. If the Analog video input is selected, it is also necessary to use the "Analog input format" drop-down list to define the desired format:
Audio input – define the audio input type selecting Embedded, AES, Analog or HDMI from the drop-down list.
Reference source – define the reference source for the AJA input device selecting Reference Input, Video Input or Free Run from the drop-down list.
Channel number - select corresponding channel number or Full board.

Deltacast Input Settings

For Deltacast input device the following settings are available:

Define the board number using the up and down arrows buttons or entering the desired value via the keyboard. Specify channel mode using the corresponding drop-down list on the right.

NDI Source

When NDI is selected as the input source, the following properties are to be configured:

Video format – choose the required video format from the drop-down list.
Stream name - define the NDI stream name in the respective field manually or press the button to select it from the list of available NDI sources:
Input mode - choose the required NDI streaming mode from the drop-down list: Video/Audio, Video only, Audio only according to your stream specification.

Shared RAM Source

For the "Shared RAM" source the following settings are available:

Video format – choose the required video format from the drop-down list.
Input name – define the name for your input Shared RAM device.
Global namespace – check this option to enable sharing between several users on the machine, or between applications and services.

Web Cam Source

To use a Web camera as an input source, you need to have a Web camera connected. Once the camera is found, the following parameters should be configured:

Video format – choose the required video format from the drop-down list.
Video device – choose the appropriate video device from the drop-down list.
Audio device – choose the appropriate audio device from the drop-down list.

Output Settings

The "Output" tab allows you to configure the output settings for the channels. There are five output modes in Cinegy Live:

MPEG-TS Output;
SDI Output;
Shared RAM Output;
PC Output;
NDI Output.

MPEG-TS Output Mode

Select the "MPEG-TS Output" option from the "Output mode" drop-down list:

Here configure the following settings:

Broadcast mode – choose the output transmission method (unicast or multicast).

Note
Changing the broadcast mode settings resets the defined channels configurations. You will be informed about that with the corresponding alert message.
Stream – choose the output stream protocol type (RTP, UDP or SRT).

Note
The SRT protocol is supported in unicast mode only. Refer to this paragraph for details on SRT protocol setup.
IP & port – in unicast mode, enter here the destination station address and port. In multicast mode, enter the IP and port of the multicast group that will be used for multicasting.
SRT Passphrase - if you want your SRT output stream to be encrypted, specify SRT passphrase in the correspondent field.

Further MPEG-TS output configuration is divided into several groups of settings.

Multicast Parameters

Primary source IP – enter the IP address of the local network adapter that will be used for multicast output.
Backup source IP – enter the IP address of the local network adapter that will be used for multicasting instead of the primary source IP.

Note
It is recommended to set up a static IP address for this adapter.
TTL – here define the number of routers (hops) that multicast traffic is permitted to pass through before expiring on the network.

Important
Refer to this documentation for more information on the TTL option.

SRT Output Setup

SRT (Secure, Reliable Transport) is an open source video transport protocol which operates as unicast UDP, that is the broadcast mode must be set to unicast. Then "SRT" should be selected from the "Stream" drop-down list.

SRT can act in two modes: as caller and as listener which differ by the IPv4 address within the URL.

In a caller mode, a source or destination device acts as the initiator of an SRT connection. The caller device must know the public IP address and port number of the listener. The URL of receiver in a caller mode should contain the specific address of the source of the SRT packets, for example:

srt://10.186.3.41:9000

In this case, the application receiving the stream will reach out to the specified address and request an SRT stream is sent to that calling application on UDP port 9000. Before the request, and in case when the request is terminated or connection is lost, no traffic will flow from the source to the receiver (unlike with a static unicast configuration where the sender continuously streams packets regardless of any receiver state). This is useful when defining and starting a new receiving operation without reconfiguration of a sender, for example a mobile device requesting the output of Cinegy Live over Wi-Fi or LTE for a short confidence check of that output.

In a listener mode, a device waits for a request to open an SRT connection. The listener device only needs to know that it should listen for SRT packets on a certain port. The URL of the receiver in a listener mode should not refer to any specific address as a source of SRT packets, for example:

srt://0.0.0.0:9000

In this case, the application receiving the stream will accept the first valid SRT streams sent to UDP port 9000. This allows a receiver to wait for a sending device to choose to send material to the input, allowing the receiver to wait in a configured state while a sender is set up or adjusted later. This is useful for defining a receiver that can retain a static configuration at runtime while senders are altered, for example allowing Cinegy Live to listen for incoming streams from a mobile device or uplinked studio.

Cinegy Live supports encrypted SRT streams so if you want your SRT output stream to be encrypted, specify SRT passphrase in the corresponding field:

srt://1.2.3.4:8888/?pass=AAAAABBBBB

srt://1.2.3.4:8888/?serviceId=2001&videoPid=2110&audioPids=2120&pass=AAAAABBBBB

Note	Please note that in accordance with SRT requirements, the passphrase length should be between 10 and 79 characters.

Video Format Options

Select the video format of the rendered output stream from the drop-down list:

Important

Refer to the System Recommendations document for the list of supported TV formats.

Video Compression Options

Video encoder – choose the video encoder from the pull-down list:

For the selected video stream you can also define its further parameters, such as bitrate, chroma subsampling type (4:2:0, 4:2:2), encoding method (frame or field), the length and type of the GOP sequence. For H.264 video stream the H.264 entropy coding mode setting is also available. The "Adaptive" option enabled allows GOP to be of variable length.

Note	The encoding method of 'frame' should be selected for progressive mode output, and 'field' for interlace. Please also note that when encoding with Cinegy Software H.264, I or IP encoding mode is recommended (B-frame encoding is not recommended).

Audio type – define the audio type with its associated bitrate for the selected video stream.
Channels – choose 1, 2 or 4 from the drop-down list to specify the number of channels.
FEC – the parity packets generated for any stream which can be used to correct missing data due to packet loss; check this option and define the rows and columns values in the corresponding fields.

Note
The "FEC" parameter affects the RTP mode only.
H.264 entropy coding mode – choose the entropy coding mode (CAVLC or CABAC) from the pull-down list.

Note
This option is available only for H.264 video encoder.

Output Registering

Note	The "Register output" parameter affects multicast mode only.

The "Register output" option allows user to register the output stream in the Cinegy Route Directory Service in order to be used by other Cinegy software components as an RTP/UDP input. To be used, enable the corresponding option and define the following parameters:

Output ID – define the output stream ID (any unique text string).

Note
No special symbols can be used for the stream ID; alphanumeric only and spaces are allowed.
Registration server – enter the Cinegy Route IP via keyboard or browse for the corresponding registration server via the browse button.

SDI Output Mode

The following common SDI Output settings should be configured for SDI output mode:

Video format – choose the required video format from the drop-down list.

Important
Refer to the System Recommendations document for the full list of the supported TV formats.
Audio channels – define the number of audio channels to be used from 1 to 8.
Output device – select the DeckLink, DVS, AJA or Deltacast output device from the drop-down list. Further settings depend on the selected device.

DeckLink Output Settings

For DeckLink output device the following settings are available:

Board number – define the board number using the buttons or entering the desired value via the keyboard.

DVS Output Settings

For DVS output device the following settings are available:

Board number– define the board number using the buttons or entering the desired value via the keyboard. Specify channel mode using the corresponding drop-down list on the right.

AJA Output Settings

For AJA output device the following settings are available:

Board number – define the board number using the buttons or entering the desired value via the keyboard.
Analog output format – choose the necessary analog output format from the drop-down list.
Reference source – define the reference source for the AJA input device selecting Reference Input, Video Input or Free Run from the drop-down list.

Deltacast Output Settings

For Deltacast output device the following settings are available:

Board number – define the board number using the buttons or entering the desired value via the keyboard.
Channel number – define the channel number using the buttons or entering the desired value via the keyboard.
Reference source – select the reference source for the Deltacast output device from the drop-down list.

Shared RAM Output Mode

Define the following parameters for the Shared RAM output device:

Output name – define the name for your output device.
Global namespace – check this option to enable sharing between several users on the machine, or between applications and services.
Video format – choose the required video format from the drop-down list.
Audio channels – define the number of output audio channels.

PC Output Mode

Define the following parameters for the PC output device:

Video format – choose the required video format from the drop-down list.
Full screen – activate this slider for the video to be put out in full-screen mode.
Monitor to use – choose the required monitor to be used from the drop-down list.

NDI Output Mode

Define the following parameters for the NDI output device:

Video format – choose the required video format from the drop-down list.
Output name – define the name of the output NDI stream.