Transcoding Broadcaster Input Streams

once you have created the transcoding profile, you can use it to transcode an input stream to transcode an input stream on the inputs page of zixi broadcaster, click the desired row of the input stream that you want to transcode note multiplex inputs can be transcoded, but the output will be only the first program transcoded click the actions (⚙️) button on the right end of the selected row and then click transcode the transcode \<input stream name> window with the settings of the selected input stream is displayed enter the unique stream id for the new transcoded input stream under stream parameters , in the video profile and audio profile fields, do one of the following select the desired video profile and/or audio profile that you have configured select keep original stream if you have not configured a video or audio profile, or do not want it transcoded, or you want to set specific transcoding parameters for the specific stream in this case, the video or audio input will not be transcoded select remove stream – you can use the transcoder to remove the video or audio track from the stream if you want to merge an html overlay into the video stream, insert the url for the html overlay into the dynamic overlay url field you can also select use html audio to merge audio from the html overlay into the video stream see the parameters table docid\ mc8lvokobd 91pdouu14e below for more details note these fields will appear only if you have the html overlay (cef) docid\ nlu62v8akjbsdcvni63yh plugin installed fill in additional fields (see table below for additional parameters) click ok the transcoded input stream is created and appears in an embedded window labeled transcoded sources under the original input stream from which it was created parameters table parameter description stream parameters force software decoding if the input video source comes in a 4 2 2 format, which is not supported by the nvidia gpu decoder, select this option so the decoding will be performed on the cpu (software decoding) and the encoding will be performed on the nvidia gpu video profile select an existing profile, select keep original stream if you do not wish to transcode the video stream, or select remove stream if you want to remove the video track audio profile select an existing profile, select keep original stream if you do not wish to transcode the audio stream, or select remove stream if you want to remove the audio track 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 note – cbr is recommended for downstream satellite workflows add rtp headers select this option to add rtp headers to the mpeg ts packets use hardware acceleration (if available) select this checkbox to use the hardware acceleration component (e g , nvidia) if it has been installed 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 an 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 captions, select this option to copy the cc to the encoded video streams; otherwise, it will be dropped this option is relevant for hevc, h 264, and mpgv sources captions will be copied to hevc and h 265 outputs, but not mpgv outputs dynamic overlay url the url of the html overlay feed this field will be displayed only if the cef software was installed the html overlay feature overlays a dynamic html page on the video stream during the transcoding process as part of this process, the images from the html page are “burned” into the video the process uses chromium embedded framework (cef) to render the html page, and then the image is passed on to the transcoder to overlay on top of the raw video frame, which is then encoded for more information, see html overlay installation guide docid 6snc7fcknryvmtgzr06kb use html audio this field will be displayed only if the html overlay (cef) software was installed select this option to merge audio from the html overlay into the video stream when this option is selected, an additional audio pid field will appear the pid number you should enter depends on your intention replace the program's audio with the overlay audio — set the audio pid to the same pid the original audio uses the overlay audio then occupies that slot in the pmt, so any downstream receiver locked to the original audio pid gets the overlay audio instead add the overlay audio as an extra audio track alongside the original — pick an unused pid that doesn't collide with the video pid, the pcr pid, the existing audio pid(s), or the pmt pid here, "arbitrary" is fine, as long as it's unique within the stream and a legal value to identify either the original audio pid or an unused pid, see identifying the audio pid and other used pids below docid\ mc8lvokobd 91pdouu14e smoothing buffer (ms) specify how much of the transcoded stream (in milliseconds) to store before transmitting it back to the server in order to prevent bursts if the transport stream bitrate \[kbps] field is empty, the smoothing buffer is disabled if the transport stream bitrate \[kbps] field is not empty, it is recommended to enter around 200ms, which should be enough to prevent bursts 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 billing codes billing codes are used to identify and differentiate traffic on a zixi broadcaster for billing purposes when a billing code is added to a source or target, zixi can track the traffic on that broadcaster input or output separately from other inputs and outputs on the same broadcaster billing codes are created by zixi personnel on the zixi customer portal for a particular organization billing code enter the billing code that corresponds to this stream the relevant billing can be obtained from the organization that received the billing code from zixi billing password enter the password that corresponds to this billing code enable time shift maximum delay \[hh\ mm\ ss] specify the time of the delayed transmission of this stream maximum 24 hours enable multicast 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 pull outputs) multicast only selecting this checkbox will force the transmission of this stream only in multicast fec parameters are taken from the global multicast pull outputs settings enable encryption select this checkbox to encrypt the input stream for more information, see encrypting an input stream in zixi broadcaster docid\ v3ryrbn08r4cojwl wvoq encryption type (for encryption enabled) specify the type of encryption (aes 128/192/256) encryption key (for encryption enabled) click generate to generate an encryption key the generated encryption key must be sent to the end user to decipher the received encoded stream 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 identifying the audio pid and other used pids unless you are managing the encoding of the original stream yourself and know how the pids are assigned, you can find them in broadcaster by turning on stream analysis docid\ g lstg1 zad2ehaplexy7 when you open the stream analysis, what you want to look at is the stream information on the left side there are two things to look at here programs unassociated pids when you expand the programs , you will usually find one program expand the program, and you will see the pmt and pcr pids, and also elementary pids now it depends on what you want to do case 1 replace the video's audio stream with audio from the overlay in this case, look at the elementary pids technically, the audio stream can be assigned to any pid, but in normal practice, it is usually assigned to the pid following the video pid in any case, expand them and look at the type for an audio type like aac or mpeg2 audio since you want to replace the video's audio, you will specify this pid number for the overlay audio case 2 add the overlay audio without replacing the video's audio in this case, you want to specify an unused pid, so you will want to choose a pid number that does not show up anywhere in the stream information in other words, avoid the number of any of the elementary pids , as well as the pmt and pcr pids , and the unassociated pids