Enterprise Platform Manual

Platform overview

Clevercast is a suite of SaaS applications for Live and Video on-Demand (VoD) streaming. Clevercast Enterprise is the common name for all solutions where you embed our video player in your website or in a third-party application, by copying our embed code or by using our Player API. This includes our solutions for Multilingual and Simulive streaming.

This manual describes how to use Clevercast Enterprise. If you need a fully hosted solution for single-language or multilingual events, see the manual for our Webinar Platform.

Clevercast is perfectly suited for global audiences. For the delivery of streams to your viewers, we use global CDNs with local edge servers all over the globe. This guarantees a fast connection to every viewer’s location.

All Clevercast plans share the same basic platform, user interface and menu structure. Depending on your plan, additional menus, pages and features may be available. Note that this manual contains information for all different types of enterprise plans. Some sections will only be relevant if the features are part of your plan.

This overview describes the top-level menus and briefly explains the terminology used in Clevercast.

The Dashboard page

The enterprise platform is only accessible to admin users with valid login credentials. After logging in, a user is directed to the dashboard. The contents the dashboard depend on your plan and permissions.

The dashboard panels contain links, allowing you to go directly to a specific menu and page. On top of the page are the top-level menus that are accessible to the user. They allow you to navigate through the platform.

The Media menus

The ‘Media’ menu has a number of submenus. Most of them serve to manage your Video on-Demand media (items, tags, playlists, workflow profiles). Additionally, the ‘player’ and ‘viewing profiles’ menus determine how the embedded Clevercast player is rendered (for both VoD items and live events).

Note that access to some of these sub-menus may depend on your plan:

• Items: this allows you to manage your account’s Video on-Demand items. Each media file (= video, audio or image) made available through Clevercast for on-demand viewing is called an item. Internally, each item refers to the file(s) on the CDN used for streaming. It also contains metadata concerning the item's content (e.g. title, description, tags), its rendering and accessibility (e.g. privacy, player, viewing profile) and the way it is processed (e.g. workflow profile).
• Tags are keywords which can be automatically or manually assigned to items. They let you order and filter items and do bulk actions on them.
• Players: a player profile determines the way the embedded player looks and behaves. Two built-in players are available when your account is created. The 'Default' player is assigned to every VoD item and playlist you create. The 'Default Live' player is assigned to every live event. Read our guide on how to embed and configure the player for more info.
• Viewing profiles: a viewing profile allows you to limit the accessibility of a VoD or live in the embedded player. See our guide on white- and blacklisting viewers for more info. By default, the built-in 'Public' viewing profile is used, which doesn't limit accessibility.
• Playlists: a playlist profile allows you to show multiple VoD items in a single embedded player, with a menu that allows viewers to jump to separate items in the playlist.
• Workflow profiles: a workflow profile defines the sequence of tasks and actions that are automatically executed after a new media VoD source is ingested. Note that workflow profiles are mainly intended for long-running plans with lots of videos. For most purposes, you can just use the default workflow profile that comes with your account.

The Upload menu

This allows you to upload source files for a VoD item. After a video source is uploaded, it is automatically transcoded to multiple resolutions for adaptive streaming and published on the Content Delivery Network (CDN). See the VoD Items section below for more info.

The Live menus

• Events: the Events menu lets you create and manage live streams. You can use the same event for consecutive live streams or create separate events, which has the advantage that you get separate analytics for each live stream. Unless specified otherwise in your plan, your account allows for one simultaneous live stream. This means that you cannot broadcast to two events at the same time.
• Recordings: all Clevercast plans include cloud recording of live streams. Depending on your plan, this lets you download the recordings and/or publish them as VoD items.
• T@H connection tests: this menu is only available if your plan includes Translate@Home. It allows you to test if an internet connection suffices for remote simultaneous interpretation.

The Analytics menus

This contains the following sub-menus:

• Active Livestreams: shows the viewers currently watching a live stream through Clevercast player
• Finished Livestreams: detailed statistics about live streams that are finished.
• Currently Watched VoD: shows the viewers currently watching a VoD item through Clevercast player
• Previously Watched VoD: detailed statistics about VoD items watched in the past.

For more info, see the analytics tutorial.

The Account menus

This contains the following sub-menus:

• Overview: contains information about your plan, the resources usage of your account (like live processing hours) and daily data traffic
• Settings: lets you determine the general behaviour of your account and allows creating FTP hotfolders
• Roles: roles consist of permissions which let you restrict user access to certain aspects of the application. Users with the default ‘Admin’ role have access to all menus and pages.
• Users: allows you to create and manage users and assign roles to them. Users log in with their email address and password. If the user's role includes the ‘Change Password’ permission, a user is allowed to change her own password.
• API: access to Clevercast’s browseable and self-documented REST API (if included in your plan).
• Include Files: lets you publish small files (eg. CSS files, images) on our CDN, so you can use them for other purposes (e.g. player or webinar styling).

Note for advanced purposes: a role's access to VoD items can also be limited based on workflow profiles. If a role doesn't have access to a certain profile, it also doesn't have access to any item with that workflow profile.

Clevercast Player

Use of Clevercast Player is included in all plans. It is based on popular open source projects Video.js and Hls.js. Clevercast player can be used to deliver (live) video and audio, embedded in a site or third-party platform. It ensures an optimal experience on all screens and devices.

Clevercast player can be embedded by using an iframe (inline frame). To display a VoD item, playlist or live event on your website, just copy its embed code from the page in Clevercast. The player profile determines the way the embedded player looks and behaves. You can also use the Player API to instantiate the player and/or modify its behavior.

For more info, see our guide on embedding and configuring the player. Clevercast can be used with an ad server that supports HTTPS delivery.

Adaptive Streaming

Live and on-demand video is delivered using the HTTP Live Streaming (HLS) protocol, in order to display the most suitable video stream on any device at any time. When rendering the video, the player is able to switch dynamically between streams with a different resolution and choose the most suitable one for the playback device (depending on screen size and available bandwidth, memory, available CPU and GPU resources).

The player supports High Definition (HD) video, both live and on-demand. The use of adaptive bitrate streaming allows viewers with non-HD compliant devices or insufficient bandwidth to watch videos in a lower resolution. For further explanations, see our website.

Video on-Demand Items

Source file ingest

VoD items are created by processing a source file, which can be ingested in a number of ways:

• HTTPS upload via the upload menu) in Clevercast
• FTP Upload through hotfolders (see below)
• Conversion of the cloud recording of a live stream (if part of your plan)
• Upload via the API (if part of your plan)

In each of these cases, the video or audio source is automatically transcoded by Clevercast to multiple resolutions for adaptive streaming (using the settings in your workflow profile) and published on the Content Delivery Network (CDN). This may take some time, depending on the resolution and duration of your source file.

Clevercast supports ingest of most modern video source formats. In general, we recommend the following format for 1080p video sources:

• Container: MP4
• Resolution: 1920x1080 px
• Codec: H.264 Main or High profile
• Frame Rate: 25 fps
• Video Bitrate: 8-10 Mbps (or lower, depending on your video quality)
• Keyframe: 2 Seconds
• Audio Bitrate: 128 Kbps / 48 kHz
• Audio Format: stereo
• Audio Codec: AAC

HTTP uploads

The Upload menu allows you to upload source files for a VoD item over HTTP. HTTP uploads are limited to files up to 200 GB. For larger files, you should use FTP instead.

For multilingual accounts, select the correct audio language in the upload form.

FTP uploads through Hotfolders

The Account > Settings page allows you to create and configure hotfolders, for the upload of media files via FTP(S). Each hotfolder comes with a set of FTP(S) credentials (username/password) and a workflow profile, which will be used for processing the uploaded files.

Note that the name of files uploaded to hotfolders may only contain alphanumeric characters, dots (.), hyphens (-) and underscores (_). Files that do not comply with these rules will be renamed automatically by our FTP server (all conflicting characters will be replaced by an underscore).

To create an FTP hotfolder, select Account > Settings in the top-level menu. On the ‘Settings’ page, click open the ‘Hotfolders’ panel and press the ‘Create New Hotfolder’ button. Clevercast will display the domain name of the FTP server and the username and password for FTP authentication.

Once a file is completely uploaded to the hotfolder, Clevercast will move the file (so it will no longer be visible by your FTP client) and turn it into a VoD item.

The Items list

When a source file has been uploaded (or you start converting a recording), Clevercast creates an Item that lets you see the transcoding status, preview the transcoded video and manage its metadata.

The new item is automatically added to the items list. The items list allows you to search or filter existing items and to execute batch actions on selected items (e.g. add or remove tags, update privacy, viewing profile, player settings).

The Item page

Item management

Every item has a detail page, where you can update the item properties, copy the embed code, set the snapshot (poster image), add chapters, see metadata, etc.

When the item has been transcoded and published on the CDN, you can play the video in the preview player.

Customizing an item

Using the Snapshot menu, you can upload an image or select a frame from the video (select the frame and click on 'Take snapshot'). After submitting the image, the player will automatically use it as its poster image.

Using the Chapters menu, you can add chapters to a video. You can choose to upload an image or select a frame from the video. Fill out the information for title and description and click on Submit.

The Duplicate Item panel lets you make a copy of the item with a different start and/or end point (note that this will take a new VoD transcoding).

Creating an item with multiple audio languages

First make sure your VoD item has the correct language. This depends on your selection when uploading the file to Clevercast. To verify or change it, select the ‘Audio Languages’ panel and use the ‘Default Language‘ control to select the language spoken in the uploaded video. If the video contains multiple languages, you can select ‘Original’.

After you have set the item’s default language, press Actions > Create Multilingual Video in the menu on the left. This will direct you to a page where you can upload the MP3 files for the audio translations. Under the ‘Upload new audio file‘ panel, select a language and an MP3 file on your computer and press Submit. Do this until you have uploaded all translations.

Note that the uploaded MP3 files must have the same duration as the video. We recommend an audio bitrate of 128-256 Kbps and an audio sample rate of 48 kHZ.

When all MP3 files have been uploaded, press the ‘Create Multilingual Item‘ button: Clevercast will create a new multilingual item and transcode it for adaptive streaming. By going back to the Media > Items menu, you can see this item and select its detail page.

If your plan includes simulive streaming, you can use a multilingual item as the source of a simulive stream with multilingual audio.

Adding closed captions

To add closed captions, select the Actions > Add Closed Caption menu on the left of the item page. This will display a popup dialog that lets you upload the WebVTT file for a given language.

After the WebVTT file has been uploaded, Clevercast player will automatically contain a CC menu that lets you select closed captions.

The uploaded WebVTT files must be valid (e.g. see this online WebVTT validator).

If your plan includes simulive streaming, make sure that the captions take into account the duration of the intro. If the intro is added afterwards, make sure to time shift the WebVTT file before uploading it.

Using Items on your website

Items can be used outside of Clevercast by copying the embed code (on the Item detail page) and using it on your website or third-party application. Alternatively, the embed code can be retrieved using the item API.

External viewing in Clevercast player is only possible if the item's privacy property is set to 'public' or 'unlisted' and the conditions in the item's viewing profile are met.

Changes made to an item after the embed code is copied (eg. changing the item’s privacy setting, setting a different poster image) will automatically be reflected in Clevercast player.

Live Events

Before you start

A live event always has a certain status, which determines:

• if you can start broadcasting
• what your viewers can see in the embedded player
• if language rooms are available to interpreters, transcribers and correctors
• when a cloud recording is made

We strongly recommend to first read our guide on how to manage a live event about the status of an event and when to update it.

Creating a live event

To create a new live event, use the 'Live > Events' menu to go to the events overview page. Press one of the Create Event buttons on the left side of the screen. A popup dialog is displayed, allowing you to select:

• Name: a name for your live stream, for your own information.
• Broadcast Protocol: this determines the way your broadcast will be processed by Clevercast. See our guide on which broadcast protocol to choose.
• Broadcast Origin: the continent from which the broadcast (or stream relay) originates. This is used to verify if the broadcast protocol is suitable.
• Streaming Resolutions: Clevercast does cloud transcoding to deliver your stream through adaptive streaming in multiple video resolutions. Make sure the highest resolution doesn’t exceed your broadcast resolution, to avoid unnecessary data traffic consumption.

For events with multiple audio languages, you also need to select:

• Default Language: this is the floor audio language of your live stream. It will be the audio language selected by default in the video player when a user initially presses the play button. If the floor audio contains multiple languages, you can select Original instead of a language.
• Additional Audio Languages: the extra audio languages that you want to make available to your viewers. These can be changed after you've created the event.
• Latency: you can choose between default latency and low latency. Select the Low Latency option only if your primary goal is to maximize audience engagement. It will result in a reduced read-ahead buffer in the video player, potentially leading to increased buffering for your viewers.

When you press the Submit button, Clevercast creates the new event and redirects you to its detail page for further configuration.

The Event page

The event page consists of a number of tabs, which allow you to manage the different aspect of a live stream. Which tabs and settings are available depends on the broadcast protocol and the features of your plan.

All tabs display the current event status and the main and backup broadcast statuses. When a broadcast is being received by Clevercast, this is set to Started.

Management

The Management tab lets you change the event status, watch the video stream, show messages in the player during the live stream and copy the embed code.

• The Set to preview, Start event and Change Event Status buttons allow you to change the status of the event. Be aware that a status change may take some time.
• The Preview player lets you see the live stream when a broadcast is received by Clevercast and the event is not yet Started. Note that most broadcast protocols require the event status to be set to Preview before a broadcast can be received by Clevercast.
• The Public player behaves in the same way as the embedded player as shown to your viewers. This player automatically detects the status changes of your event and acts accordingly.
• The Service Message can be used to show text messages in the embedded player while the event status is Started. You decide how long the message is displayed in the player.
• The Embed code can be copied to your website or third-party platform. The embedded player will behave in the same way as the public player, including status changes and failover to the backup broadcast. For more info, see our guide on embedding and configuring the player.

In enterprise mode it also allows you to update the Name, Description, Resolutions and Is Permanent Event settings.

• Name and Description: the name and description of your live stream, for your own information.
• Resolutions: The resolutions in which your broadcast will be transcoded in the cloud and therefore will be used for adaptive bitrate streaming.

Broadcast

The Broadcast tab contains the settings for your encoder or application to configure the broadcast to Clevercast.

For most broadcast protocols, Clevercast supports a fully redundant setup, which allows you to broadcast to a main and backup server on different geographical locations. Use the settings in the Backup Broadcast panel to send the same broadcast to both servers simultaneously. Clevercast player will detect if one of the streams is down and automatically failover to the backup stream, without your viewers having to refresh the page. This is also the case for the remote interpretation and captioning rooms.

For more info, see our guide on configuring your encoder or relay app.

Audio languages

The default language refers to floor audio language(s) in your broadcast. When the player is rendered for the first time, this language is selected by default (unless you specify a different language in the embed code or via the API). Afterwards, the player remembers a viewer's selection. If the floor audio contains multiple languages, you can select Original as default language.

Depending on your plan and on the event's broadcast protocol there may be an additional languages panel. This allows you to make extra audio languages available in the embedded player (note that they can be changed after the player is embedded).

T@H languages

If your broadcast protocol supports Translate@Home, you can add as many extra audio languages as allowed by your plan (keep in mind that floor audio also counts as a language).

For each T@H language, Clevercast creates an interpreter room for remote simultaneous interpretation, protected by a secret key in the URL. Interpreters use this room to watch and listen to the incoming video stream, while simultaneously translating it. Use the 'Open room' link to go to the interpreter room, and 'Copy' to send the URL to your interpreter(s). If an interpreter needs to translate two languages during the same event, add the second language using 'Add 2nd language'.

Clevercast allows you to test the internet connection of interpreters in advance, via the Live > T@H Connection Tests menu. This should already give you an indication of whether an interpreter’s connection is suitable.

The Realtime Management button gives you access to the Realtime Management room, allowing you to monitor the event.

If your plan has support for speakers or other people following the event without any latency through Clevercast - either from home or from the event location - the page will also contain Realtime Participant Links.

More info:

• For more info about setting up bilingual interpreter rooms, T@H connection tests, and support for real-time participants, see the Advanced T@H Features section below.
• For more info about using an interpreter room for remote simultaneous interpretation, see our interpreter manual.

Broadcasted languages

If the selected broadcast protocol involves sending multiple audio tracks or channels along with the video, the tab will contain an Additional Broadcast Languages panel. This allows you to choose the names of the broadcasted languages and order them. The order of the languages will correspond to the options in the player menu.

The number of languages should match the broadcast protocol and settings (see Multilingual Broadcasts and the encoder configuration guides).

Caption languages

The closed captions tab allows you to add closed captions to your live stream, depending on your plan and on the event's broadcast protocol.

If you are a first time user, we recommend that you first read our introduction to closed captions in Clevercast which explains the difference between:

• Automatic captions through speech-to-text conversion (AI), with optional real-time correction
• Automatic multilingual captions through machine translation (AI)
• Transcription in real time

Managing an event with closed captions via transcription (with or without machine translation) is the same as for any other (multilingual) live stream. You have to take into account the normal HLS latency. For closed captions via speech-to-text the latency will be slightly higher.

If you use AI captioning, you can set an AI vocabulary. In this vocabulary you can add terms (names, acronyms, industry jargon, technical phrases ...) that may appear in the live stream, so they will be correctly displayed in the captions. You can also add custom translations for the caption languages that are automatically translated. Your account settings also contain options to filter profanity and disfluency.

Note that an event with closed captions currently has a maximum duration of 24 consecutive hours. If your event spans multiple days, set the event to Inactive or Ended during breaks and reset it again.

Real-time management page

The caption languages page contains a 'Realtime Management' button. This gives you access to the Real-time Management room, which can be used to:

• watch the incoming stream without delay. Unfortunately, it is not yet possible to see closed captions in this real-time player. To see your captions, you have to resort to the Preview player on the event page, in which the live stream has a delay of about one minute (depending on your configuration).
• if you use AI captioning, the 'Pause AI Captioning' button allows you to temporarily stop the AI captioning while you are broadcasting. Find more information about pausing captions here.
• if you use correctors or transcribers, this page lets you see if they are online and communicate with them through text chat.

Speech-to-text language

Clevercast currently supports a single speech-to-text language. This means that an AI engine will automatically generate captions in that language. In most cases, this is the same language as the default language of your event (= the floor audio language). You can change it via the Audio Languages tab.

After you press ‘Add speech-to-text language’ a popup dialog is shown, letting you choose or confirm the language spoken in the live stream.

If you have a live stream in which multiple languages are spoken, you can do the following.

• Select 'Original' as the default language of your event (on the 'Audio Languages' tab).
• In the 'Add speech-to-text language' dialog, select the language that will be spoken most often in the live stream, and check the 'Floor audio contains multiple languages' checkbox.
• Add auto-translation captions for the other languages spoken in the live stream

Important: only check "Floor audio contains multiple languages" if multiple languages are spoken in the live stream. In that case, the accuracy of the captions will be lower. Therefore, we strongly recommend applying real-time correction to captions in case of mixed floor audio.

In the settings panel at the top of the tab, you can choose whether to use real-time correction. If you select it, you will see a link to the Correction Room behind the speech-to-text language. The correction room lets you edit the closed captions in real-time, just before they are shown in the live stream. Note: a live stream with real-time correction has a slightly higher latency, due to the extra time required for correction.

Text-to-text translation languages

After a speech-to-text or transcription language has been set, you can add multiple machine translated caption languages (the total number of languages depends on your plan). You can change the order in which the languages appear in the player by dragging the languages into the desirable order and clicking 'Update Order'.

After you add the languages, you can set custom translation through the event vocabulary. This allows you to set a specific translation for certain words and phrases. For example, you can prevent certain words from being translated (e.g. the name of a product).

Transcription languages

You can add a Transcription Room for each language that should have manual transcription. Click on the Caption Languages tab in the left-hand menu. Then, click 'Add transcription language'. A popup dialog will appear that allows you to choose the transcription language.

Once created, the language will appear in the list of transcription languages. The Open Transcription room is a direct link to the Transcription Room interface, which you can copy and distribute to your transcribers.

Manual transcription can be corrected as well, just like AI captions. When clicking Correct Transcription you will be redirected to the Corrector Room interface. Here, you can make adjustments to the transcription before it is sent to the viewers.

Manual transcription adds 30-40 seconds of delay to the delivery, and correction an additional 20 seconds.

Caption widget

Closed captions can also be shown in a customizable separate iframe. If your plan supports it, you can enable the caption widget using the Player API. Go to Caption Languages and set Enable Captiong Widget to Yes.

The captions can be shown anywhere on the same page as the player.

The current caption will be highlighted and new captions will appear automatically.

Simulcasting

The Simulcasting tab lets you simulcast a live stream via RTMP to social media channels and other RTMP endpoints (e.g. Periscope, Twitch, a custom CDN...). Simulcasting is an optional feature in Clevercast, so you will only see this tab if it's part of your plan.

The interface and functionality of the Simulcasting tab depends on whether the event is single-language or multilingual. In the latter case, per-language simulcast(s) will be sent (consisting of the live stream and one of the audio languages).

Single-language

Five simulcast targets can be set up for a single-language broadcast protocol, named Facebook Live, YouTube live and 3 other targets.

There is only a slight difference between the (backup) configuration of 'Facebook Live' and the other four targets. While most (redundant) RTMP endpoints provide a main and a backup RTMP URL with a single stream key, 'Facebook live' provides a single RTMP URL with two stream keys (main and backup).

Apart from that, you can use any of the targets for any RTMP endpoint (e.g. 'YouTube live' target for simulcast to Twitch, or 'Other' target for simulcast to YouTube or Facebook).

To enable a simulcast target, at least one of the Server URL (primary or backup) and Stream Key properties must be set. A simulcast target can still be (re)configured after the live stream has started.

Clevercast lets you choose between the broadcasted stream or a certain resolution after cloud transcoding (we recommend the latter). Some RTMP endpoints require a specific resolution, so always check the documentation of the platform you are simulcasting to. Note: for single-language simulive streams, these extra options aren't available.

Multilingual

For multilingual events, you can simulcast the video stream with a selected language to any RTMP endpoint (e.g. Facebook Live, YouTube live, Periscope, Twitch, a custom CDN...).

Any combination of an RTMP URL and key is considered a simulcast target. The maximum number of simulcast targets is determined by your plan (any number is possible). For example, to send the live stream with English translation to both the main and backup URL of a YouTube account, you'll need 2 simulcast targets. If you want to do the same for the live stream with French translation, you'll need 2 more simulcast targets.

You can add a new simulcast target for any language by filling in the form.

For each simulcast target, you need to provide the following settings:

• Name of the Simulcast target : this is only for informational purposes
• Simulcast Server URL : the RTMP URL to which the stream must be broadcasted
• Simulcast Stream Key : the stream key (aka stream name) to which the stream must be broadcasted
• Simulcast from Clevercast main or backup origin : the Clevercast streaming server from which to broadcast. In most cases this should be set to ‘Main’, unless you are also broadcasting to our 'Backup' server (this is currently NOT recommended if you are using Translate@Home).

Clevercast will automatically start broadcasting to a simulcast target when you can see the video stream in the 'Preview player' on the Management tab. This requires that the event status is set to Preview, Started or Paused and your incoming broadcast is being processed.

Simulcast targets can be added or updated at any time, also after the live stream has started. When your event status is set to Ended or Inactive the similcast automatically stops. This also happens if your broadcast to Clevercast is interrupted. However, in the latter case, it should automatically restart when Clevercast receives your broadcast again.

Note: always check the requirements of the platform you are simulcasting to:

• Clevercast always broadcasts your event’s highest resolution to all simulcast targets (usually 1080p or 720p, see the Management tab). Note that some platforms don’t accept 1080p.
• Clevercast currently transmuxes all multilingual streams to a frame rate of 25 frames per second and a keyframe interval of 2 seconds. Therefore, the simulcast will also have 25 frames per second.

Appearance

The Appearance settings determine the look and feel, accessibility and behavior of the embedded Clevercast player:

• Player: determines which Player profile will be used by the embedded player. By default, this is the Live Player which is initially created with no pause button and autoplay and muted turned on.
• Viewing Profile: determines the accessibility of the live stream in the embedded player. See our guide on white and blacklisting viewers
• Player Countdown: if set, the player will display a countdown timer, either until your event status is set to Started, or until the countdown is complete.
• Images: images displayed in the embedded player when the event status is not Started. You can set a separate image per status and/or a general image that will be displayed for each status without an image.
• Messages: messages displayed in the embedded player when the event status is not Started. A message will only be displayed if no image is available. If no image or message is set, Clevercast will display its default message for the status.

Health

The Health settings give you feedback regarding the broadcast you are sending. The information on this page indicates when Clevercast receives your broadcast, includes warning concerning the configuration of your encoder, an incorrect bitrate or frame rate, a choppy stream....

The messages on the health page can have three different levels:

• Info: these are messages for informational purposes. For example to indicate that an incoming stream is detected.
• Warning: these messages are displayed if your broadcast is not in line with our recommendations or best practices. By itself, these are not major isssues, but they may be a reason for lower quality or give rise to other problems (e.g. a frame rate that is too high may cause not all frames to arrive in a timely manner).
• Error: these are issues that will give rise to a failing or faltering stream. They require you to take action.

Errors and warnings are also shown at the top of all other event tabs.

Recordings

This tab lists the cloud recordings (see below) for this event. The list of cloud recordings for all events is available via the Live > Recordings menu.

Cloud recording

A Cloud Recording is created every time an event is started. The recording can be downloaded or published after the event is ended or paused.

In case of a multilingual live stream, the live stream is recorded as a single mp4 file containing the video stream and all audio streams (= languages). Clevercast records the outgoing audio streams: so any background volume that is part of the live stream, will also be part of the recording (it isn’t possible to remove this afterwards).

If your plan includes VoD support, recordings can be published to VoD (including audio translations and closed captions).

If your plan doesn’t include VoD support, you can download the mp4 file from the recording page. In case of a multilingual video, the downloaded MP4 file contains a single video stream with all additional languages as separate audio streams. To be able to hear them, you need a video player that supports switching the Audio Tracks (e.g. VLC player).

Notes:

• the maximum duration of a recording is 24 hours! Clevercast automatically ends a recording 24 hours after you’ve started your event.
• recordings are deleted automatically after 30 days. You should publish or download them before that happens.
• we strongly recommend to always make a local recording of your stream! An online recording can be interrupted by a temporary lack of upload bandwidth or network issues, which may result in an imperfect or incomplete recording.

Events with closed captions

If your event has closed captions, Clevercast will also record them as WebVTT files. For the recorded .vtt files to have a correct timing, it is necessary that you first set the event status to Preview and start broadcasting, before starting the event. If you start the event without setting it to Preview or without a broadcast already running, the timing of the recorded VTT files will not be correct. In that case, the closed captions of the Video on-Demand will also be out of sync.

Clevercast currently doesn’t offer a way to change the timing of the VTT files for Video on-Demand. You can, however, download the VTT files, change the timing by using a local or online tool, and upload the modified VTT file to the on-demand video item. Future releases of Clevercast will also include tools for this.

Partial & stitched recordings

When your broadcast to Clevercast is interrupted, Clevercast may start a new recording to avoid the recorded file becoming corrupted. This may result in two or more recordings after a live session.

In such case, Clevercast allows you to stitch the different recordings back into one single continuous recording. Note: if the broadcast interruptions were so short that they were not visible in the live stream, they will also not be visible in the stitched recording.

The easiest way to stitch a recording is to go to the detail page of a recording that has been interrupted. Apart from the recording itself, the page will show the list of partial recordings from the save live sessions. To stitch all partial recordings, press the ‘Stitch All Recordings’ button below the list. This will result in a new continuous recording that spans all partial recordings.

Publish recording to Video on-Demand item

If your plan supports VoD, the recording page also lets you trim the start/end of the recorded video and publish it as a VoD item. Press the ‘Trim Video‘ button to select the start and end point of the VoD item you want to publish. Click on the Submit button: the start and end offset will be set on the recording page.

Continue to fill in the other form fields and press the ‘Convert to Item‘ button. The video will be transcoded for adaptive streaming and exported to the Clevercast CDN (this may take some time).

If the recording includes extra audio languages and/or closed captions, the VoD player will also contains the same menus with the same languages. You can copy the VoD embed code to your website, in the same way as the live stream.

Convert multilingual recording to single-language video(s)

If your recording contains multiple audio languages and you need (to download) video(s) with a single audio language, you can convert the recording to single-language VoD item(s). To do this, make sure that:

• 'Create item with single language (top resolution only)' is checked
• The preferred audio language is selected in the dropdown: 'Select single language (only this language will be part of the video)'

After pressing the ‘Convert to Item‘ button, the conversion to a (single-language) VoD item will start. This may take some time. After the conversion has finished, you can go to the Item page and select Actions > Download in the left-hand menu. A dialog will appear: download the single-language MP4 file by right-clicking on the link under Video file(s).

Advanced T@H Features

T@H Connection Tests

Clevercast offers a way to test the internet connection of potential interpreters in advance.

As a Clevercast administrator, you can see all test results on the ‘T@H Connection Tests’ page (available under the ‘Live’ > ‘T@H Connection Tests’ menu). On this page, you can also copy the link to the test page and send it to your interpreters.

Doing the test is simple. Interpreters just have to paste the test link in the address bar of their Firefox browser, enter their name, email and location and press the Start button. The browser will establish a connection with Clevercast and start sending data packets. After 30 seconds, the result is available.

Before doing the test, interpreters should make sure to:

• Use the same computer and internet connection as during the live stream
• Use an ethernet cable (no wireless connection!)
• Close all unnecessary applications on the computer, in the same way as during the live stream

The test measures:

• Average ping time in milliseconds. Ping (or latency) measures the time it takes for a small data set to be transmitted from the interpreter’s computer to Clevercast and back to the interpreter’s computer again. Ideally it should be under 250ms, but a higher value doesn't necessarily result in poor audio quality. Even a ping time above 750 ms doesn’t have to be a problem in itself, but could lead to other issues like jitter and packet loss.
• Average jitter in milliseconds. Jitter is the amount of variation in packet delay (packets are usually sent at regular intervals and take a set amount of time). The bigger the differences in delay between packet arrivals, the more jitter. This is often caused by network congestion and sometimes route changes. Ideally it should be under 30ms, but a value under 100ms may still be acceptable.
• Percentage of packet loss. A bad connection leads to packets not arriving in time, and thus being lost. The audio codec needs to correct this, leading to lower audio quality. Ideally no packets should be lost, but less than 15% packet loss may still be acceptable (depending on the expected audio quality). If there is packet loss, the audio codec needs to make corrections, leading to lower audio quality.

Ideally you should see average ping times under 250ms, jitter under 30ms and zero packet loss. But if this isn’t the case, it doesn’t necessarily mean that the connection cannot be used.

Clevercast distinguishes three possible test results:

• Good: the connection is expected to be suitable for simultaneous interpretation.
• Average: the connection may be suitable for simultaneous interpretation, depending on the audio quality during auditory tests (and your requirements).
• Bad: if possible, use a different connection. If you must use this connection, test sufficiently in advance to ensure that the audio quality is sufficient for your purposes.

Please note that this result is a rough indication of the connection at the time of testing. A good test does not guarantee the best possible audio quality during the live stream, just as an average test does not mean that the connection is unusable (e.g. it could be due to temporary network congestion).

We strongly recommend always performing an auditory test to judge the actual audio quality of an interpreter. Keep in mind that other things such as the computer, headset, location and experience of an interpreter also determine the audio quality.

Note: avoid opening interpreter rooms (or language management rooms) in multiple browser tabs! This can cause all kinds of problems with your connection, audio quality...

Bilingual interpreter rooms

Translate@Home allows event managers to add a second language to an interpreter room. This will allow interpreters to switch between the two languages in the interpreter room. This way, they can translate the floor audio into two different languages, without having to leave the interpreter room.

This allows, for example, for a bilingual event translated by a single interpreter. When the language in the floor audio changes, the interpreter can continue to translate. She only has to press the button to switch to the other interpreter room.

In the image above, the translator can choose to translate the floor audio into French or Spanish. When she is not muted, her translation is automatically sent to the language that is currently selected. For more info on how to use bilingual interpreter rooms, see the T@H interpreter manual.

A bilingual interpreter room is created when an event manager adds a second language to an already existing interpreter room. For a language to be selected as a second language, it must also have its own interpreter room for the same event.

Realtime participants

Clevercast T@H also supports hybrid events, where a number of realtime participants need to listen to the translated audio (and optionally also watch the video) in realtime.

Realtime participants may be:

• present at the event location and in need of audio translation in realtime
• speaking from home and in need of realtime video and audio (translation)

Realtime participants are an optional feature, which must be included in your plan.

If this option is enabled for your plan, the Audio Languages’ tab of an event contains a 'Realtime Participants Links' panel. For each language there will be a secure link for realtime video with audio and for realtime audio only. As an event manager, you are responsible to distribute these links to the relevant participants.

When the event starts, participants only need to open these links in a browser with sufficient support for WebRTC (Chrome, Firefox, Safari, Edge) and press the play button. Participants will automatically hear the event in the correct language, either with or without video. Note that the number of realtime participants is limited and their maximum number is determined by your plan.

A video + audio player is ideal for participants at home, for example speakers being added to a live stream via production software like vMix or an in-browser studio like Streamyard. This allows them to see the event video in realtime, while listening to the simultaneous translation in their own language.

Note: if a participant is already receiving the video feed in realtime (e.g. via Microsoft Teams), it may be a better solution to send her the audio-only player instead. Since the audio-only player only contains the simultaneous interpretation, the participant won’t hear herself speak. See below for more info.

An audio-only player is ideal for participants at the event location. When the event starts, they just use their smartphones to click on the link, press the start button and listen to the translation (e.g. using headphones with a mini jack).

Behaviour of the realtime players

Since the video and audio-only players have different purposes, their behaviour is slightly different.

The realtime video player allows participants to hear the translations in their own language. When the interpreter is muted - which means that the current speaker is speaking their own language - they hear the floor audio instead. This means that they will also hear themselves speak. So they will either have to use a headset or mute the player when they are speaking.

The realtime audio-only player also allows participants to hear the translations in their own language. But when the interpreter is muted - which means that the current speaker is speaking their own language - they will hear nothing. Since they don't hear the floor audio, they will not hear themselves speak.

The audio-only player can therefore also be useful in a remote setup where a participant already receives video and floor audio from the production (eg. through WebRTC or MS Teams). Via our audio-only player, the participant can listen to realtime translations of other speakers. Note that, in this scenario, the participant has two audio sources and may have to reduce the floor audio when she wants to listen to the translation.