Transcoding Broadcaster Templates

instead of manually selecting input streams to be transcoded, you can define templates with rules for automatic transcoding of input streams according to the settings of a pre defined transcoding template every time a new input stream, which matches the conditions of the template, is added, it will be automatically transcoded into the transcoded streams defined in the template's settings the input streams are identified by system according to naming patterns the transcoding profiles used in the transcoding templates have to be created in advance (for more information see creating new transcoding profiles docid\ uvfngua5ep5uzq1louxik ) to create a new transcoding template click the inputs tab at the top of the zixi broadcaster administrative screen in the menu bar, click the templates (📑) button the transcoding templates window is displayed next to input id patterns , click➕ to define a new template the following window is displayed in the input id pattern field, enter a pattern for the stream id of the input stream that will be automatically transcoded this pattern will be used to identify the input stream and can include variables that are marked with the "$" sign followed by a number (e g $1, $2, etc ) and/or with an asterisk " " wildcard the patterns should also include a part of the string that requires an exact match for example, the pattern "$1 stream $2kbps" will match an input stream "talk show stream 600kbps" click apply the new template is added to the list of transcoding templates however, the transcoding will not be active until you define transcoded stream rules select the newly created template and click the ➕ button, located at the right hand corner to define a transcoded stream rule the transcode \<template name> window opens enter the unique stream id for the transcoded stream in the max outputs field, define the maximum number of outputs that can be connected to the stream under stream parameters , select the desired video profile and/or audio profile that you have configured if you have not configured a video or audio profile you can select keep original stream in this case the video or audio input will not be transcoded you can also set specific transcoding parameters for the specific stream (see table below for more details) click ok the transcoded input stream rule is created and appears as follows if an input stream enters zixi broadcaster and matches the input id pattern , it will be transcoded according to all the transcoded input stream rules that were created parameter description force software decoding video profile select an existing profile or select keep original stream if you do not wish to transcode the video stream audio profile select an existing profile or select keep original stream if you do not wish to transcode the audio stream apply audio profile for all audio pids select this option if you want to re encode all audio tracks using the same audio profile, instead of just the first audio track that is detected output type select one of the following output types the outputs are configured as part of the transcoding process, so there is no need to create the output from the zixi broadcaster outputs screen mpeg ts – the output will be available as mpeg transport stream ndi – the output will be available as ndi when selecting ndi output, you can select the following video/audio profiles video profile – remove stream or a raw profile audio profile remove stream or a raw profile webrtc – the output will be available as webrtc when selecting ndi output, you can select the following video/audio profiles video profile – remove stream, keep original stream, raw video profile, or if the input stream is not webrtc compliant, a transcode to webrtc compliant profile (e g h 264 codec with baseline or main profile and no b frames) audio profile remove stream, keep original stream, raw audio profile, or if the input stream is non opus, transcode to opus transport stream bitrate (kbps) specify the bitrate of the transport stream this parameter is optional if you do not specify a ts bitrate, the stream will be vbr if you specify a bitrate, the stream will be cbr add rtp headers select this option to add rtp header to the mpeg ts packets pass all pids select this checkbox to pass through all non transcoded pids force i frames on scte 35 markers selecting this option will do the following if a scte35 marker is detected and it contains a specific video timestamp (pts), the encoder will generate an idr frame on the video frame with the closest or equal timestamp if there is no timestamp in the scte35 marker, the transcoder will generate an idr frame as soon as it can copy closed captions if the video source contains closed caption, select this option to copy the cc to the encoded video streams, otherwise it will be dropped this option is relevant for hevc and h264 sources and targets smoothing buffer \[ms] the smoothing feature uses a buffer to time packets according to the stream's clock this is useful when there are bursts in the rate in which the stream arrives the smoothing features creates a queue in the buffer, allowing smoother entry into the broadcaster the smoothing parameter defines the size of the buffer in milliseconds a larger the buffer enables smoother entry however, it may influence the latency rate gpu the gpu utilization threshold if this limit is exceeded, the gpu indicator at the top of the screen will appear in red, and an alarm will be generated in the event log default 0 crop parameters select this checkbox to set the cropping parameters cropping mode set the units used for defining the crop options are pixels or percentages note depending on the type of content, in some cases using different crop values for low resolution outputs might be appropriate for example, if the content includes both video content and textual content, the text would not be readable at lower resolutions and thus might be better to exclude another use case for using different crop values for each output would be to slice a 360 or vr input video left, top specify the left and top positions for the crop width x height specify the width and height values for the crop enable time shift select to enable delayed transmission maximum delay \[hh\ mm\ ss] specify the time of the delayed transmission of this stream maximum 24 hours enable multicast output on pull outputs selecting this checkbox enables the transmission of this stream’s outputs as multicast a zixi receiver that will pull the stream will receive it in multicast by default zixi broadcaster is configured to allow transparent fallback to unicast if it is out of the lan requires enabling multicast pull in the settings this setting requires enabling multicast pool (settings > multicast pool) multicast only selecting this checkbox will force the transmission of this stream only in multicast recording parameters select this checkbox to customize the recording parameters destination type select the radio button for the desired storage type and then fill in the relevant parameters · record to disk – the recording is saved on the local disk · record to s3 – the file is saved to your aws s3 bucket record to disk parameters file name template specify the file name pattern that zixi will use to generate when saving the recorded content a separate file will be generated for each recording up to the time specified in the max recorded file duration parameter (see above) after this duration a new file will be generated the file name pattern can include any string and up to five variables listed below only the %t=hh mm ss creation time is mandatory you can change the order of these variables and add text as long as you maintain the legitimate structure of the file in linux and windows · %s=stream id optional · %y=year optional · %m=month optional · %d=day optional · %t=hh mm ss creation time mandatory for example, the following pattern %y recording%t ts will generate the following file name 2017 recording15 32 35 ts max recorded file duration \[hours] specify the maximum time allotted for recording a video stream default 2 hours keep recorded files for \[hours] specify the maximum time for storing the recording default 0 hours custom path optionally specify a storage location for the recorded files that is relative to the root folder this location bypasses the location specified as the root folder in the settings > general screen record to s3 parameters file name template specify the file name pattern that zixi will use to generate when saving the recorded content a separate file will be generated for each recording up to the time specified in the max recorded file duration parameter (see above) after this duration a new file will be generated the file name pattern can include any string and up to five variables listed below only the %t=hh mm ss creation time is mandatory you can change the order of these variables and add text as long as you maintain the legitimate structure of the file in linux and windows %s=stream id optional %y=year optional %m=month optional %d=day optional %t=hh mm ss creation time mandatory for example, the following pattern %y recording%t ts will generate the following file name 2017 recording15 32 35 ts max recorded file duration \[hours] specify the maximum time allotted for recording a video stream default 2 hours url specify the url of the s3 bucket ignore tls certificate errors tls certificate for s3 bucket might be detected as faulty if bucket name contains dot\[s] when this option is selected, zixi broadcaster will ignore the tls certificate errors and transmit the stream to its destination access key the access key that is used for accessing the s3 bucket secret key the secret key that is used for accessing the s3 bucket