Kaltura Management Console (KMC) KMC User Manual
KMC_User_Manual
KMC_User_Manual
KMC_User_Manual
KMC_User_Manual
KMC_User_Manual
User Manual: Pdf
Open the PDF directly: View PDF 
.
Page Count: 249
| Download | |
| Open PDF In Browser | View PDF |
Kaltura Management Console (KMC)
User Manual
Version: Hercules
Kaltura Business Headquarters
5 Union Square West, Suite 602, New York, NY, 10003, USA
Tel.: +1 800 871 5224
Copyright © 2013 Kaltura Inc. All Rights Reserved. Designated trademarks and brands are the property of their respective owners.
Use of this document constitutes acceptance of the Kaltura Terms of Use and Privacy Policy.
Contents
Preface ........................................................................................................................................................ 11
About this Manual ................................................................................................................................. 11
Audience ............................................................................................................................................... 11
Document Conventions......................................................................................................................... 12
Related Documentation ........................................................................................................................ 12
Chapter 1 KMC Overview ........................................................................................................................... 13
What Can I Do with the KMC? .............................................................................................................. 13
Media Management and Workflow ....................................................................................................... 13
Widget and Application Studio .............................................................................................................. 14
Getting Started ...................................................................................................................................... 14
Chapter 2 Uploading and Ingestion ............................................................................................................ 16
What is a Kaltura Entry? ....................................................................................................................... 16
Browser-based Ingestion ...................................................................................................................... 16
The Kaltura Uploader ............................................................................................................................ 16
The Upload Tab .................................................................................................................................... 16
Upload Media ........................................................................................................................................ 17
High-Speed Upload ........................................................................................................................ 17
Upload from Desktop ...................................................................................................................... 17
Record from a Webcam .................................................................................................................. 18
Import from Web ................................................................................................................................... 19
Ingestion for Webex Recording Files .................................................................................................... 19
Prepare Entry ........................................................................................................................................ 19
Prepare Video/Audio Entry ............................................................................................................. 20
Prepare Live Stream Entry ............................................................................................................. 20
Creating Draft Entries ........................................................................................................................... 20
Key Benefits and Functionality of Draft Entries .............................................................................. 21
Hosting Videos at your Preferred Location and Linking to Kaltura ................................................. 22
Replacing Video Assets for a Kaltura Entry .......................................................................................... 22
Uploading and Modifying Related Files ................................................................................................ 22
Bulk Upload and FTP Upload ............................................................................................................... 23
What is Bulk Upload? ..................................................................................................................... 24
Entries XML Bulk Upload ................................................................................................................ 24
Submit Bulk Options ....................................................................................................................... 25
Downloading Bulk File Samples ..................................................................................................... 26
Automated Content Ingestion via a Drop Folder................................................................................... 26
Drop Folder Control Panel .............................................................................................................. 26
The Dashboard Tab .............................................................................................................................. 28
Kaltura Management Console (KMC) User Manual
3
Contents
Uploading Content Using the Content Tab ........................................................................................... 28
Tracking Your Uploads ......................................................................................................................... 28
Your Uploads .................................................................................................................................. 28
Bulk Upload Log.............................................................................................................................. 29
Chapter 3 Transcoding and Processing...................................................................................................... 31
Converting Videos into Multiple Flavors (Optimized Output Files) ................................................. 31
Editing and Creating Transcoding Profiles ..................................................................................... 32
Adding a Transcoding Profile ................................................................................................................ 34
Quick Publishing ............................................................................................................................. 35
Editing Options for Flavors in a Transcoding Profile............................................................................. 36
Assigning a Transcoding Profile to a Bulk Upload ................................................................................ 37
Useful Tips for Working with Transcoding Profiles ............................................................................... 37
The Flavors Tab .................................................................................................................................... 38
Add Video/Audio ............................................................................................................................. 39
Upload Files .................................................................................................................................... 39
Import Files ..................................................................................................................................... 40
Link to Remote Storage .................................................................................................................. 41
Match Files from Drop Folder ......................................................................................................... 42
Replacing Media ............................................................................................................................. 42
Supported Source Formats ................................................................................................................... 44
Supported Source Codecs.............................................................................................................. 44
Target Formats/Codecs .................................................................................................................. 45
Chapter 4 Creating and Customizing Playlists and Players ....................................................................... 46
What is a Playlist? ................................................................................................................................. 46
Playlists Tab .......................................................................................................................................... 46
Creating a Manual Playlist .................................................................................................................... 46
Creating a Rule Based Playlist ............................................................................................................. 48
Defining a Rule ............................................................................................................................... 48
Multiple Rules Based Playlist - Advanced Mode ............................................................................ 50
Additional Playlist Configuration ........................................................................................................... 52
Creating a Player with Multi-tab Playlists ....................................................................................... 52
Deleting a Playlist ........................................................................................................................... 53
Removing Videos from a Playlist .................................................................................................... 53
Customizing Additional Features for Playlists ................................................................................ 53
Designing and Configuring a Player ..................................................................................................... 54
Player List ....................................................................................................................................... 54
Select the Type of Player ...................................................................................................................... 55
Configuring the Player Basics Settings ................................................................................................. 55
Editing a Player ............................................................................................................................... 55
Adding Content to a Player ............................................................................................................. 56
Duplicating a Player ........................................................................................................................ 56
Kaltura Management Console (KMC) User Manual
4
Contents
Deleting a Player............................................................................................................................. 57
508-Compliant Video Player ................................................................................................................. 57
Configuring the Player Advertising Settings ......................................................................................... 58
Configuring the Player Features ........................................................................................................... 58
Features List ................................................................................................................................... 59
Configuring the Player Style ................................................................................................................. 67
Chapter 5 Managing Metadata ................................................................................................................... 69
Entry Metadata ...................................................................................................................................... 69
Types of Metadata .......................................................................................................................... 69
Metadata Actions ............................................................................................................................ 70
Uploading Content and Setting Metadata ............................................................................................. 70
Upload a Media File and Set Its Metadata ..................................................................................... 70
Ingest a Media File Bundled with Metadata (CSV, XML, API) ....................................................... 70
Prepare a Metadata-only "Draft" Entry for Future Ingestion of Media Files ................................... 71
Metadata and Related Files .................................................................................................................. 71
Kaltura Custom Metadata Functionality .......................................................................................... 72
Managing Schemas .............................................................................................................................. 73
Adding a Schema............................................................................................................................ 73
Adding Custom Data Fields ............................................................................................................ 74
Setting Values for Custom Metadata Fields - Per Entry ................................................................. 76
Setting Values for Metadata Fields - Per Category ........................................................................ 78
Chapter 6 Locating Content in the KMC ..................................................................................................... 80
Searching Through Entries ................................................................................................................... 80
Entries Search Rules ...................................................................................................................... 80
Filtering Content in the Entries Table ................................................................................................... 81
Using Categories as Filters............................................................................................................. 81
Using Additional Filters ................................................................................................................... 82
Performing a Search Based on Metadata Fields ............................................................................ 83
Entries Table Filter Indications ....................................................................................................... 83
Searching Through Categories ............................................................................................................. 84
Filtering Categories in the Categories Table ........................................................................................ 84
Using Categories as Filters............................................................................................................. 85
Using Additional Filters ................................................................................................................... 86
Categories Table Filter Indications ................................................................................................. 86
Searching Playlists ................................................................................................................................ 87
Chapter 7 Managing Access Control Profiles ............................................................................................. 88
Access Control Profiles ......................................................................................................................... 88
Creating an Access Profile.................................................................................................................... 89
Editing an Access Profile ...................................................................................................................... 90
Restricting Domains ........................................................................................................................ 91
Restricting Countries for Viewing.................................................................................................... 92
Kaltura Management Console (KMC) User Manual
5
Contents
Restricting Views by IP Address ..................................................................................................... 93
Restricting Access for Specific Flavors .......................................................................................... 94
Restricting Views with a Kaltura Session .............................................................................................. 96
Pay-Per-View .................................................................................................................................. 96
Assigning an Access Control Profile to an Entry .................................................................................. 97
Assigning an Access Profile to a Bulk Upload ................................................................................ 97
Content Scheduling ............................................................................................................................... 97
Chapter 8 Managing Content Entitlement ................................................................................................... 99
Kaltura’s Entitlement Model .................................................................................................................. 99
Category’s Entitlements Tab ................................................................................................................. 99
Setting the Entitlement Settings.................................................................................................... 100
Content Privacy............................................................................................................................. 101
Visibility of Content Associated with Multiple Categories ............................................................. 102
Visibility of Content in Outside of the Application ......................................................................... 102
Category Listing ............................................................................................................................ 103
Contribution Policy ........................................................................................................................ 103
Specific End-User Permissions .................................................................................................... 103
Managing Categories’ Specific End-User Permissions ................................................................ 104
Bulk Actions for Managing Categories Specific End-User Permissions ....................................... 106
Additional Category Entitlement Settings ..................................................................................... 106
Chapter 9 Managing Categories ............................................................................................................... 108
Defining and Assigning Entry Categories ........................................................................................... 108
Categories Table ................................................................................................................................. 108
Adding/Editing a Specific Category .............................................................................................. 108
Adding Metadata to a Category .................................................................................................... 110
Editing the Entitlement Settings of a Category ............................................................................. 111
Reordering Sub Categories .......................................................................................................... 112
Editing Multiple Categories in Bulk ............................................................................................... 113
Add Tags to Categories ................................................................................................................ 114
Remove Tags from Categories ..................................................................................................... 115
Move Categories ........................................................................................................................... 115
Change Content Privacy ............................................................................................................... 116
Change Contribution Policy .......................................................................................................... 117
Change Category Listing .............................................................................................................. 118
Change Category Owner .............................................................................................................. 118
Delete Categories ......................................................................................................................... 119
Updating Categories’ State ........................................................................................................... 119
Chapter 10 KMC Users and Roles ............................................................................................................ 121
Roles and Permissions ....................................................................................................................... 121
Adding a User ............................................................................................................................... 121
Editing a User ............................................................................................................................... 122
Kaltura Management Console (KMC) User Manual
6
Contents
Deleting and Blocking Users......................................................................................................... 123
Purchasing a License for Additional Users ................................................................................... 123
Creating Custom Roles ................................................................................................................. 123
Role Management ........................................................................................................................ 124
Chapter 11 Moderation and Editorial Workflows....................................................................................... 126
Content Moderation Workflows ........................................................................................................... 126
The Moderation Tab ............................................................................................................................ 126
Previewing Content using the Moderation Tab............................................................................. 127
Rejecting Content Using the Moderation Tab............................................................................... 127
Approving Content Using the Moderation tab ..................................................................................... 127
Banning Users Using the Moderation tab ........................................................................................... 127
Chapter 12 Using Subtitles and Captions ................................................................................................. 129
Caption File Types .............................................................................................................................. 129
Searching within Captions ............................................................................................................ 129
Subtitles and Captions Terminology ................................................................................................... 129
Adding Captions to an Entry ............................................................................................................... 130
Editing a Captions File .................................................................................................................. 131
Setting Up Captions for Display .......................................................................................................... 131
Viewing an Entry with Captions in a Player .................................................................................. 132
Captions Options .......................................................................................................................... 133
Adding an Audio Description File to an Entry ..................................................................................... 134
Playback the Audio Track in a 508 Player .................................................................................... 134
To playback the audio file ............................................................................................................. 135
Chapter 13 Live Streaming ....................................................................................................................... 136
Live Streaming Using the KMC ........................................................................................................... 136
Digital Video Recorder (DVR) ....................................................................................................... 136
Workflow for Setting up Live Streaming .............................................................................................. 136
Setting up the Hardware and Software ......................................................................................... 137
Creating a Live Streaming Entry in the KMC ................................................................................ 137
Multiple Bitrate Encoding .................................................................................................................... 140
Configuring the Live Stream Parameters in the KMC................................................................... 140
Setting up the Broadcasting Computer ......................................................................................... 142
Viewing the Broadcasting Setup (Optional) .................................................................................. 143
Advanced Live Streaming Configuration Options ......................................................................... 143
Chapter 14 Content Authoring Tools ........................................................................................................ 145
The Content Tab ................................................................................................................................. 145
Entries Tab .......................................................................................................................................... 145
Entries Table ....................................................................................................................................... 145
Set Scheduling .............................................................................................................................. 146
Set Access Control ....................................................................................................................... 147
Edit - Add Tags to and Entry......................................................................................................... 148
Kaltura Management Console (KMC) User Manual
7
Contents
Edit - Remove Tags from an Entry ............................................................................................... 148
Edit - Add Categories .................................................................................................................... 149
Edit - Remove Categories ............................................................................................................. 150
Add to New Category .................................................................................................................... 151
Add to New Playlist ....................................................................................................................... 151
Change Entry Owner .................................................................................................................... 151
Download Files ............................................................................................................................. 152
Delete Multiple Entries .................................................................................................................. 152
Preview and Embed ...................................................................................................................... 153
Editing Entries ..................................................................................................................................... 153
Edit Entry Tabs ............................................................................................................................. 154
Clipping and Trimming Media Files .............................................................................................. 155
Troubleshooting Trimming and Clipping ....................................................................................... 157
Users Tab ..................................................................................................................................... 157
Choosing a Thumbnail for your Video ................................................................................................ 158
Chapter 15 Publishing to Your Site ........................................................................................................... 160
Embedding a Player with a Single Entry on your Site ........................................................................ 160
Embedding a Player with a Playlist on your Site ................................................................................ 161
Video Delivery Settings ....................................................................................................................... 162
Kaltura Auto .................................................................................................................................. 163
HTTP Progressive Download Delivery ......................................................................................... 163
HTTP Streaming (Based on Akamai’s Technology) .................................................................... 163
HTTP Dynamic Streaming (HDS) Based on Adobe ..................................................................... 163
RTMP Streaming (Legacy) ........................................................................................................... 163
Secure Transport RTMPE (Legacy) ............................................................................................. 164
Embed Code Types ............................................................................................................................ 164
Search Engine Optimization ............................................................................................................... 165
Support for HTTPS Embed Code ....................................................................................................... 165
Adding the Flavor Selector Module ..................................................................................................... 165
Mobile and HTML5 Support .......................................................................................................... 166
Chapter 16 Distribution and Syndication................................................................................................... 167
Kaltura Distribution Module ................................................................................................................. 167
Key Benefits: ................................................................................................................................. 167
How Does Distribution Work? ............................................................................................................. 168
Adding a Distributor to an Entry .................................................................................................... 169
Scheduling a Video Package .............................................................................................................. 170
Validating a Video Package .......................................................................................................... 172
Removing a Distributor from a Video Package............................................................................. 175
Managing Distributor Details......................................................................................................... 176
Content Syndication ............................................................................................................................ 176
How Does Syndication Work? ............................................................................................................ 177
Kaltura Management Console (KMC) User Manual
8
Contents
Syndicating to a Standard MRSS Feed (Yahoo) .......................................................................... 177
Search Engine Optimization (SEO) .............................................................................................. 177
Key Benefits .................................................................................................................................. 178
Setting up Syndication ........................................................................................................................ 178
Syndicating to Google ................................................................................................................... 179
Create a Landing Page ................................................................................................................. 180
Google Webmaster Tasks ............................................................................................................ 180
KMC Publisher Tasks for Google Syndication.............................................................................. 180
Syndicating to TubeMogul ............................................................................................................ 182
KMC Publisher Tasks for TubeMogul Syndication ....................................................................... 182
TubeMogul Webmaster Tasks ...................................................................................................... 184
Syndicating to iTunes ................................................................................................................... 184
KMC Publisher Tasks for iTunes Syndication .............................................................................. 184
Syndicating to Yahoo .................................................................................................................... 186
KMC Publisher Tasks for Yahoo Syndication ............................................................................... 187
Yahoo Webmaster Tasks ............................................................................................................. 187
Flexible Feed Format .................................................................................................................... 189
Chapter 17 Advertising and Ad Networks ................................................................................................. 190
Overview of Advertising with Kaltura .................................................................................................. 190
Player Branding ............................................................................................................................ 190
Connecting with an Ad Server ............................................................................................................ 190
Kaltura Player and Ad Plugins ...................................................................................................... 191
Supported Ad Servers .................................................................................................................. 191
Ad Terminology ............................................................................................................................. 191
Creating Kaltura Video Ads................................................................................................................. 191
Adding the VAST Ad Server ............................................................................................................... 192
Configuring VAST Ads ........................................................................................................................ 192
Configuring VAST Pre-roll Ads ..................................................................................................... 192
Configuring VAST Post Rolls ........................................................................................................ 193
Adding a Midroll ............................................................................................................................ 194
Adding an Overlay ........................................................................................................................ 196
Creating Bumper Ads .......................................................................................................................... 197
Configuring Third Party Ad Plugins ..................................................................................................... 198
Tremor Media................................................................................................................................ 199
AdapTV ......................................................................................................................................... 201
DoubleClick ................................................................................................................................... 202
Configuring Companion Ads ............................................................................................................... 203
Companion Ads in HTML.............................................................................................................. 204
Companion Ads in Flash ............................................................................................................... 205
Targeting with an Ad Server ......................................................................................................... 208
Targeting per Viewer .................................................................................................................... 210
Kaltura Management Console (KMC) User Manual
9
Contents
Ad Targeting via ad plugin ............................................................................................................ 210
Ad Targeting with Tremor ............................................................................................................. 211
Advertising for Mobile Devices ..................................................................................................... 211
How to Locate the AdTag URL ........................................................................................................... 212
DoubleClick - Dart For Publisher (DFP) ....................................................................................... 212
OpenX ........................................................................................................................................... 212
AdapTV (via VAST) ...................................................................................................................... 213
Connecting with Ad Servers and Networks via adap.tv ................................................................ 213
Connecting with Tremor Media ..................................................................................................... 215
Different Types of Ad Servers....................................................................................................... 216
Troubleshooting .................................................................................................................................. 216
Chapter 18 Creating and Tracking Analytics ............................................................................................ 218
Content Reports .................................................................................................................................. 218
Top Content Reports .................................................................................................................... 218
Specific Entry Report .................................................................................................................... 219
Content Drop-off Reports.............................................................................................................. 221
Specific Entry Content Drop-off Reports ...................................................................................... 222
Content Interactions Reports ........................................................................................................ 224
Specific Content Interactions Report ............................................................................................ 225
Content Contributions Report ....................................................................................................... 226
Specific Entry Media Source Contributions Report ...................................................................... 227
User and Community Reports............................................................................................................. 228
Top Contributors Report ............................................................................................................... 228
Geographic Distribution Reports................................................................................................... 229
Top Syndications .......................................................................................................................... 231
Specific Syndicator Reports.......................................................................................................... 232
User Engagement Reports ........................................................................................................... 232
Specific User Engagement Report ............................................................................................... 234
Bandwidth Usage Reports .................................................................................................................. 234
Publisher Bandwidth and Storage Report .................................................................................... 234
End Users Storage Report............................................................................................................ 235
Storage Report for a Specific User ............................................................................................... 236
Date Ranges for Analytical Reports.............................................................................................. 237
System Reports................................................................................................................................... 238
Platform Reports ................................................................................................................................. 238
Analytics Data Types .................................................................................................................... 239
Platform’s Drill Down Reports ....................................................................................................... 239
Operating Systems Report.................................................................................................................. 240
Browsers’ Report ................................................................................................................................ 240
Exporting Analytics to a CSV File ................................................................................................. 241
Sending Analytics Events to Third Parties .................................................................................... 242
Kaltura Management Console (KMC) User Manual
10
Preface
Kaltura Player Supported Plug-ins................................................................................................ 242
Chapter 19 Account Information ............................................................................................................... 243
Account Settings ................................................................................................................................. 243
Integration Settings ............................................................................................................................. 244
Account Info .................................................................................................................................. 244
Entitlement Settings ...................................................................................................................... 245
Notifications .................................................................................................................................. 247
Access Control .................................................................................................................................... 248
Transcoding Settings .......................................................................................................................... 248
Custom Data ....................................................................................................................................... 248
My User Settings ................................................................................................................................. 249
Account Upgrade ................................................................................................................................ 249
Preface
This preface contains the following topics:
About this Manual
Audience
Document Conventions
Related Documentation
About this Manual
This document provides an in-depth description of the KMC basic concepts and usage.
NOTE: Please refer to the official and latest product release notes for last-minute updates
Technical support may be obtained directly from: Kaltura Customer Care.
Contact Us:
Please send your documentation-related comments and feedback or report mistakes to the Knowledge
Management Feedback group.
We are committed to improving our documentation and your feedback is important to us.
Audience
This guide is primarily intended for content managers and Kaltura Management Console users and also
contains useful information for developers, integrators, and operations and site administrators using the
Kaltura Management Console (KMC) User Manual
11
Preface
Kaltura platform.
Document Conventions
Kaltura uses the following admonitions:
Note
Workflow
NOTE:
Workflow: Provides workflow information
Related Documentation
In addition to this guide, product documentation is available on the Kaltura Knowledge Center.
Kaltura Management Console (KMC) User Manual
12
KMC Overview
CHAPTER 1
KMC Overview
The Kaltura Management Console (KMC) is a media asset management front-end application to the
Kaltura Platform. The KMC provides publishers all the tools necessary to manage and publish their media
assets, in one intuitive interface.
What Can I Do with the KMC?
You can:
Upload content and perform bulk ingestion
Transcode and manipulate media assets
Manage metadata profiles and high-precision temporal-metadata
Design and customize branded media players
Control and manage end-user entitlements to content in applications such as Kaltura
MediaSpace
Create static and dynamic rule-based playlists
View analytics and gain insights about how well your content is performing
Configure live streaming web broadcasts
Syndicate and distribute content across the web
Configure ads and leverage ad networks
Manage access control profiles and limit access to published media
Manage your Kaltura account settings
Create Kaltura users, roles and assign permissions
and more…
Media Management and Workflow
The KMC provides full media management so that you can organize and track your online video system,
functions and rich-media content. The following presents a simple workflow to manage content.
Uploading and Ingestion - upload and ingest video, audio, images and docs, bulk or individual file
uploads, via browser, desktop applications, email or mobile.
Transcoding and Processing – convert videos into multiple flavors (optimized output files) and
create transcoding profiles to ensure optimal viewing experience on all devices.
Creating and Customizing Players and Playlists - control player size, color, fonts and branding.
Add or remove buttons, enable subtitles, sharing, and more. Create manually or dynamically
generated playlists.
Managing Metadata and Categories - leverage metadata fields to tag, manage, search and
expose content. Populate out-of-the-box fields, or create your own custom metadata schema.
Create content packages, including a set of video transcodes, multiple thumbnails in different
Kaltura Management Console (KMC) User Manual
13
KMC Overview
sizes, metadata, subtitles, scheduling data, and more.
Locating Content in the KMC - use categories, tags, and any of your custom metadata fields to
locate any file, or search caption files for phrases within the video.
Managing Access Control Profiles - control exactly when and where your content is published;
decide who can do what within the KMC.
Configuring KMC Users and Roles - use out-of-the-box roles and permissions or create your own
custom roles with granular permissions.
Managing Content Entitlement - -control and manage end-user entitlements to content in
applications such as Kaltura MediaSpace.
Managing Categories - provide a logical structure for your site and assist with content
management.
Moderation and Editorial Workflows - review content to eliminate spam and abusive content in
UGC portals. Implement complex editorial workflows for your various team roles.
Using Subtitles and Captions - upload multiple caption files (SRT, XML) and transcripts (TXT), or
reference an external link. Viewers can toggle between different language captions.
Live Streaming - schedule and broadcast live events. Includes all the features of on-demand
video.
Content Authoring Tools - trim videos, string videos or clips together, add subtitles and cue
points.
Publishing to your Site - manage content, create playlists, preview and embed to your sites.
Provide the optimal viewing experience across all devices with seamless mobile and tablet
support.
Distribution and Syndication - distribute content to your channels on partner sites such as
YouTube, Hulu, and DailyMotion, or create video feeds for third-party platforms such as Google,
Yahoo! and iTunes.
Advertising and Ad Networks - advertise, integrate with ad networks, and enable payment
models.
Creating and Tracking Analytics - get the insight you need on viewer behavior with built-in
reports.
Account Information- modify user information, integration settings and registration information
Widget and Application Studio
Kaltura’s application studio enables you to configure your player instances. The application studio is
accessed through the KMC Studio tab.
Player designs - design your player skin - select the size, color, fonts, etc.
Player branding - include your logo on the player as a watermark.
Player functionality and added features - decide what buttons to display on the player, create
your own custom buttons, and decide what features to enable as part of playback (for example,
subtitles, sharing, etc.)
Player templates - select pre-defined player templates, or create your own.
Getting Started
To login to the KMC
Go to the Kaltura Management Console (KMC) at: http://www.kaltura.com/index.php/kmc.
Kaltura Management Console (KMC) User Manual
14
KMC Overview
Log-in with the credentials you received in the “Kaltura Registration Confirmation” email.
The KMC Dashboard is displayed.
Kaltura Management Console (KMC) User Manual
15
Uploading and Ingestion
CHAPTER 2
Uploading and Ingestion
This section describes the options for uploading content to Kaltura.
What is a Kaltura Entry?
A Kaltura entry is a logical reference to your media asset. An entry encapsulates all physical media files
generated during ingestion (source, “flavors” and thumbnails), standard and custom metadata, captions,
scheduling settings, advertising cue points, specific access control settings and all other components
relating to the content. An entry is generated immediately, and your source media file starts uploading
and transcoding begins. For more information, see the Entries Table.
Browser-based Ingestion
You can upload files from your computer, record a video with your webcam, or import from a selection of
online repositories, or submit a bulk upload request via Kaltura formatted CSV/XML all from within the
Kaltura Management Console. See The Upload Tab.
The Kaltura Uploader
You can use the Kaltura Uploader, also known as the Kaltura Contributor Wizard (KCW) to upload any
type of rich-media file, from any location (computer, websites, record from webcam).
You can upload content through the:
Upload Tab
Dashboard
Content Tab
The Upload Tab
The Upload tab presents a list of ingestion options and capabilities to choose from and is used to upload
content to Kaltura. The Upload tab opens over any page within the KMC.
You can upload content using the following options:
Upload Media
Prepare Entry
Submit Bulk
Kaltura Management Console (KMC) User Manual
16
Uploading and Ingestion
Upload Media
High-Speed Upload: Uses Kaltura’s High-Speed Upload option powered by Aspera™.
Upload from Desktop: Opens a file browser and allows you to select multiple files.
Record from a Webcam: Allows you to capture video content from a webcam connected to your
computer.
Import from Web: Allows you to search for videos to ingest from video repositories such as
Metacafe and others, depending on the feature set enabled in your account.
High-Speed Upload
Kaltura’s High-Speed Upload option powered by Aspera™ is targeted at content administrators (KMC
users) that upload media to their KMC account. The High-Speed Upload option is particularly useful for
content administrators uploading large source files or time sensitive content on a regular basis.
Aspera’s patented FASP™ Transport Technology is a proven standard for the high-speed movement of
large files over IP Networks. It achieves speeds that are significantly faster than FTP and HTTP. Please
refer to Aspera’s FASP Benchmark information to learn more.
The High-Speed Upload option is activated by Kaltura when the High-Speed Upload option is included or
added to your service agreement. For more information, see the Kaltura High-Speed Upload User Guide.
Upload from Desktop
Kaltura Management Console (KMC) User Manual
17
Uploading and Ingestion
Use this option to quickly upload files. You can continue working on other tasks while files are uploading,
and resume the file upload in case of connection failure.
To upload media files from your desktop
Select the Upload tab.
Click Upload from Desktop (or click Upload from Desktop in the Dashboard.)
Select one or more media files. Use the Ctrl key to select multiple files. The default detection of
the entry type (video/audio/image) is kept as is.
The Upload Settings window is displayed.
Select the Transcoding Profile. See Transcoding and Processing.
Modify the Media Type if needed. The media type is automatically detected from file name
extension. The media types allowed are: video, audio or image.
Click Add Files. (Optional).
Click Upload.
Record from a Webcam
You can upload media that you record from your webcam via the easy-to-use Kaltura Uploader.
To upload media files recorded from a webcam
Select the Upload tab.
Click Record from Webcam.
Select the Transcoding Profile and click Next. See Transcoding and Processing.
Select a webcam from the dropdown list and click Allow.
Press Record to record your media file.
When done, click Next.
Enter a Name and all other relevant information for the webcam recording and click Next.
The recording is processed and added to the Entries table.
Kaltura Management Console (KMC) User Manual
18
Uploading and Ingestion
Import from Web
You can import video, audio and photos from common online media websites and applications. The
Metacafe option for importing videos, may address your needs if you are searching for specific content
quickly and easily assuming you want to import videos that are hosted in Metacafe. The video’s
properties (description, running time, brief summary, etc.) can be revealed by mousing over the
thumbnail.
The audio options are Jamendo and CCMixter; the photo options are Flikr and NYPL.
To import content from the web
Select the Upload tab.
Click Import from Web in the Upload tab.
Select the Transcoding Profile and click Next. See Transcoding and Processing.
Click Search to search through videos on Metacafe, or select the Audio or Photo tab and search
through your data.
Select the content to upload and click Next.
Enter or modify the descriptive information and click Next.
Ingestion for Webex Recording Files
The KMC allows for ingestion of Webex’s proprietary ARF files, and converts them to a customer’s flavor
set with the ability for multi-platform playback.
The workflow supports:
Import directly from Webex server
Upload from desktop
Bulk upload (CSV, XML)
Prepare Entry
You can prepare a video entry without including the media content in advance. Creating a No Media
entry may be useful when metadata settings and media perpetrations are managed separately and
Kaltura Management Console (KMC) User Manual
19
Uploading and Ingestion
possibly by different operational teams This scenario is used for media that may be included at a later
stage, for example, in a drop folder. See Using a Drop Folder.
The following options are available:
Prepare Video Entry
Prepare Audio Entry
Prepare Live Stream Entry
Prepare Video/Audio Entry
Use this option to prepare metadata and publishing settings for a video/audio entry before its related files
are ready for upload. This option enables a flexible entry preparation workflow and is especially useful
when video files are:
Transcoded by a local transcoder
Processed while content editorial work is being done in the KMC
Processed after content editorial work is completed in the KMC
Preparing a Draft Entry Workflow:
Prepare a draft entry in the KMC and fill in its metadata and publishing settings. See
Prepare a Metadata-only "Draft" Entry for Future Ingestion of Media Files.
Add the media source file or the locally generated Transcoding Flavors to the entry. Use
the entry’s Flavors tab to add files or flavors. See The Flavors Tab.
The ingestion status of an entry that you create with the Prepare Video/Audio Entry option automatically
is set to No Media. The status remains No Media until one or more media files are added to the entry.
An entry that you create with the Prepare Video/Audio Entry option is saved as a Draft entry in the Kaltura
system until you add content.
A Draft entry remains available in the Content tab Entries table for further editing.
Prepare Live Stream Entry
Use the Live Stream Entry option to provision a live stream on the CDN. The live stream should be
configured with your encoder IP address.
After the live stream is provisioned, you can set the entry metadata and specific broadcasting settings in
the KMC's Content tab Entries tab.
For more information see Workflow for Setting up Live Streaming.
Creating Draft Entries
Draft entries are entries created without actual content, and are used as a container for adding content.
Note: You can add or attach content at a later time, by using the BaseEntry>addContent action and use one of the KalturaResource resources. See Kaltura API
documentation.
Kaltura Management Console (KMC) User Manual
20
Uploading and Ingestion
To create a Draft Entry
Select the Upload tab.
Select Video Entry or Audio Entry.
In the New Entry Window, provide:
Name (required).
Description
Tags
Categories – use the pencil icon to select a category from the existing category list.
If you have Custom Data for entries, you can edit the Custom Data fields for the entry. For
multiple schemas, use the drop down Jump To menu to select the schema for the entry. See
Managing Schemas for more information.
Click Save and Close.
The ingestion status for a Draft entry is No Media. The following is an example of a Draft entry in the
KMC.
Key Benefits and Functionality of Draft Entries
Kaltura Management Console (KMC) User Manual
21
Uploading and Ingestion
You can prepare a new media entry in the KMC and set its metadata and publishing information
beforehand, or in parallel, to the actual media processing and then add the media files to the existing
entry when ready.
This flexibility may be of value especially with large media operational teams, when the metadata
preparation effort is separated from the media preparation effort with different teams working on each
operation. Separating these tasks, may provide more efficiency to the company’s internal processes as
editing metadata can be done without dependency on the media preparation operation.
When you prepare a No Media entry in the KMC you can upload the media file/s to Kaltura at a later time
either by uploading the source for transcoding in Kaltura or uploading media assets/files that have already
been generated locally using your own transcoder.
Note that the option to use a local transcoder to ingest flavors is a feature that is not enabled by default.
Contact your Kaltura account manager to learn more about how this feature can simplify your workflow,
and to activate and configure this feature on your account.
Hosting Videos at your Preferred Location and Linking to Kaltura
This use case is typically combined with transcoding performed on the publisher’s side, after which the
output files are pushed directly to CDN hosting, or to a local intranet delivery source.
In this case, Kaltura essentially only manages the metadata while media files themselves are delivered
directly from the publisher through a CDN to the viewer.
Linking between the files and a Kaltura entry can be done through the KMC, API, or drop folder XML
ingestion. See Using a Drop Folder.
Replacing Video Assets for a Kaltura Entry
Publishers can replace media files of an existing media entry when needed.
This feature:
Is especially useful when media assets need to be re-edited by the publishers following
ingestion to Kaltura.
Enables seamless replacement of media even if media is already published/
syndicated/distributed – media is replaced in all published instances.
Replaces all multiple-bitrate media assets flavors in one transaction.
Allows review and approval of new media prior to the actual replacement.
Is an integral part of the entry life-cycle and content management workflow
For more information see Replacing Media.
Uploading and Modifying Related Files
You can attach files (documents, media) to your entries. Uploaded files will not create new entries but will
receive a unique Kaltura Asset ID. Use the Related Files tab to upload files associated to entries.
Related files are not stored with the entries on the Kaltura platform and are referenced using an Asset ID.
Kaltura Management Console (KMC) User Manual
22
Uploading and Ingestion
To upload related files
Select the Content tab and click on an entry.
Select the Related Files tab and click Add More Files.
Select a file and click Open.
Select the File Type from the drop down menu.
The related file will immediately begin uploading. After the upload is complete, you can edit the
file details (title, description), download the file, or remove it.
Click Save.
To edit related files
Select the Content tab and click on an entry.
Select the Related Files tab.
Select a File and select Edit, Download, or Remove.
Bulk Upload and FTP Upload
You can import multiple files per session via a simple comma separated file (CSV) or an XML file. With
these options, you can also ingest files from your own FTP server, or any publicly accessible file’s host.
Metadata fields can be populated from CSV/XML.
The CSV Bulk Upload file is a simple format. You can use the CSV format for simple content ingestion
based on imported source media files and their related metadata. Each entry is added from a single line
in the CSV file. Each line includes a path to a media file that will be uploaded and each uploaded media
file creates an entry. We recommend a maximum of 500 lines/uploaded media files included within one
CSV file.
The XML Bulk Upload file is based on Kaltura’s MRSS format schema for content ingestion. The XML
format enables bulk ingestion of complex video or audio packages.
Kaltura Management Console (KMC) User Manual
23
Uploading and Ingestion
Complex packages may include:
Multiple bit-rate Transcoding Flavors already transcoded by a local transcoder
Multiple thumbnails
Related metadata and publishing options
What is Bulk Upload?
Bulk Upload enables you to ingest multiple entries and files to the Kaltura server in a single action using a
single file. The greatest benefit for bulking uploads is:
Importing multiple files in one action thus automating the ingestion process.
Ingesting large files which you cannot upload from the desktop via the KMC (larger than 2GB).
Populating metadata fields with no need to enter them from the KMC.
Bulk upload streamlines publishing, providing the basis for automated bulk ingestion of files and metadata
and overcomes browser and client upload limitations allowing for larger file size ingestion.
There are two methods to upload bulk content: the simple method where you use
a CSV file (Comma Separated Value) and the advanced method where you use an XML file, which has
many extensive bulk upload features. You can customize the structure to the metadata and elements that
are part of your account specific workflow. Using the XML file bulk upload is the recommended method
due to its structured hierarchy, allowing for nested objects and metadata and is easily extended.
For information on how to download bulk file samples see Downloading Bulk File Samples.
Entries XML Bulk Upload
XML Bulk Upload supports full CRUD (Create, Read, Update, and Delete) operations, allowing for
ingestion of entries, updates to existing entries, and deletion of bulk entries using an XML format. XML
Bulk Upload is the recommended bulk upload option.
In addition, XML supports a hierarchical structure while CSV does not. You can define a complete content
package using the XML Bulk Upload feature that includes the video source file, its metadata, its custom
metadata profiles, distribution profiles, set of transcoding flavors ( for cases when you are using your own
transcoders), thumbnails and other additional relevant data.
The advantages of using XML Bulk Upload are:
Simplified integration with other systems (for example, migrating media files including their
complete metadata from one server to another).
A streamlined ingestion mechanism, by using XML it is easy to create automated processes to
ingest content.
More comprehensive ingestion models that allow you to manipulate all of the media entry object
attributes and their related objects (such as flavors, custom metadata, access control and
distribution profiles, etc.).
The full sets of features supported by the XML Bulk Upload are described in the XSD (the XML template).
An example XML file can be found here (or downloaded from the KMC Upload tab).
The bulk upload status is monitored through the Bulk Upload Log, see Tracking Your Uploads. A log file
and a copy of the CSV file are made available for troubleshooting or for historical records of uploaded
content.
Whether you are a medium sized video publisher or if you're a media giant, you should consider the Bulk
Upload option.
Kaltura Management Console (KMC) User Manual
24
Uploading and Ingestion
Submit Bulk Options
Kaltura provides bulk services and CSV formatted schemas for enabling automatic setup and on-going
updates for end-user’s details and content entitlement settings. Bulk services can be used to streamline
the setup and administration of Kaltura MediaSpace™ based media portals, and may also be used for
convenient submission of bulk operations on the following entities.
There are four types of CSV files available:
Entries CSV – use to upload multiple entries.
Categories CSV – use to create, update or delete a large amount of categories. See Categories
CSV for more information.
End Users CSV – use to upload multiple end-user account. See End Users CSV for more
information.
End-User Entitlements CSV – use to set, update or delete specific end-user permissions to
categories. End-user entitlements can be set to multiple categories through a single CSV file.
See End User Entitlements CSV for more information.
Although CSV bulk uploads are less structured and have fewer features than the XML bulk upload, CSV
bulk upload is easy to use for simply ingesting video files and their related metadata.
CSV files are easy to edit using Microsoft Excel, Google Docs or similar spread sheet applications.
To specify the fields and their order in the CSV file, the first line in the CSV file should start with an ‘*’
(asterisk sign) followed by the list of field names, separated by a commas. Lines with‘#’ (hash sign) will
not be processed, as these are essentially comment lines.
Each line after the fields definition line (which starts with an ‘*’ sign) represents an entry to be ingested
and should include the values of every field. Every line is a new entry. All entry fields are processed
according to the definition line and according to the order of the fields.
A full list of fields and example CSV file can be downloaded from the KMC Upload tab. See Downloading
Bulk File Samples.
To submit a CSV or XML file
Select the Upload tab.
Select the type of CSV/XML file from one of the following,
or click Download/Submit CSV/XML in the Dashboard.
Click Open.
A message stating that your import request has been submitted is displayed.
To track bulk uploads
See Tracking Your Uploads.
Kaltura Management Console (KMC) User Manual
25
Uploading and Ingestion
Downloading Bulk File Samples
To download a sample bulk file
Select the Dashboard tab.
In the Upload Content section click Submit CSV/XML Samples.
or
Select the Upload tab.
Click Select CSV/XML Samples.
The samples include specific format descriptions and guidelines.
Automated Content Ingestion via a Drop Folder
You can add your media and metadata to a drop folder (on-premise or on the Kaltura servers) and the
Kaltura system will activate an ingestion workflow tailored to your needs.
You can also upload metadata only and deliver media directly from your CDN, or on-premise storage.
Using a Drop Folder
The Kaltura Drop Folders are used to automate the ingestion of content into the Kaltura platform. The
Drop Folder service constantly watches each drop folder for new content, and activates automatic
ingestion of new content to the specific account.
Kaltura offers multiple configuration options for setting each drop folder to a specific workflow. To learn
more read about Drop Folders see Kaltura Drop Folder Service for Content Ingestion.
Drop Folder Control Panel
This section applies only after the Kaltura Drop Folder service is set up.
In the KMC Content tab, publisher administrators can use a control panel to monitor and troubleshoot
media files in drop folders. Access to the Drop Folders control panel can be granted to specific
administrators through the administrator's user role definition.
Kaltura Management Console (KMC) User Manual
26
Uploading and Ingestion
The Drop Folders control panel includes the status of each file in the drop folder, and an option to filter
the file display for a specific drop folder, status and creation date range.
An additional option to manually delete files from the drop folder can be granted separately only to
authorized administrators.
Drop Folders Table
The Drop Folders Files table in the Drop Folder Control page lists all media and/or XML files currently
available in the account’s drop folders. Current details of each file are available within the table. In the
filter bar on the left side of the page, you can filter the files by:
Search criteria
Drop folder
File creation date
Drop folder status
If you need to delete files from the drop folder, click Delete.
Drop Folder Statuses
The following statuses describe the different stages and possible error cases that may apply to a specific
file in the drop folder:
Parsed from XML – A reference to the media file was parsed from the XML. The media file is
expected but is not yet available in the drop folder.
Uploading – File is currently uploading to the drop folder.
Pending – File upload is completed - Waiting for drop folder processing to start.
Waiting for Related Files (Formerly “Matched”) –Processing of this file should continue when
all related files are available in the drop folder (for example, XML file, other media files
referenced in the same XML, or other flavors expected for the same entry).
Waiting for Matched Entry (Formerly “Not Matched”) – Processing of this file should continue
when a matched entry is found (applicable only in specific drop folder workflows settings)
Processing - Drop folder engine is currently processing this file.
Kaltura Management Console (KMC) User Manual
27
Uploading and Ingestion
Downloading - The file is currently importing from the drop folder to Kaltura.(applicable only in
drop folders hosted on-premise by customers)
Done – Drop folder processing was completed for this file.
Error – Drop folder engine processing failed.
Download Failed - Failed to import the file from the drop folder to Kaltura. .(applicable only in
drop folders hosted on-premise by customers)
Delete Failed - Failed to delete the file from the drop folder.
Commercial users, please contact your account manager to enable this feature in your account.
The Dashboard Tab
You can upload data, video, audio or photo files through the Dashboard.
To upload media files from your desktop
Click Upload from Desktop in the Dashboard.
Select the files to upload and click Open.
Select the Transcoding Profile. See Editing and Creating Transcoding Profiles.
Select the Media Type and click Upload.
Uploading Content Using the Content Tab
You can upload data through the Content tab. You can add video or audio media to an entry you
prepared (when the entry status is No Media, add new transcoding flavors, add metadata, or replace
content information. See The Flavors Tab.
Tracking Your Uploads
You can track the upload processing in the Content tab.
Your Uploads
The Your Uploads table lists all the in-progress and pending upload tasks. The list only shows media file
uploads from the desktop that you performed during the current KMC session.
For each uploaded file, you can view details such as:
File name
File size
ID of the Kaltura entry that this file is added to
You can use the table to:
Track the progress of each upload task.
Reorder upload tasks that are waiting to be processed.
Retry failed tasks.
Since file uploads are controlled by the KMC web application, closing or refreshing the browser page
terminates all upload tasks that currently are in progress.
Kaltura Management Console (KMC) User Manual
28
Uploading and Ingestion
To track the upload progress from your desktop
Click the Content tab.
The Upload Control feature, located on the upper right of the screen, indicates the number of
uploads in progress.
Click Upload Control...
The Your Uploads window displays the file uploads and additional information.
Bulk Upload Log
The Bulk Upload Log table shows the completed and in-progress bulk upload jobs for your KMC account.
You can:
View information related to each bulk upload job.
Download original bulk upload files.
Download a results log file of each bulk upload job.
To track the Bulk Upload progress from your desktop
You can display completed and in-progress bulk upload jobs. (optional)
Click the Content tab.
Click Bulk Upload Log.
The Bulk Upload Log is displayed.
Kaltura Management Console (KMC) User Manual
29
Uploading and Ingestion
You can track the bulk jobs as well as download bulk job related files (original CSV and log files).
To download bulk job related files
Click the Content tab and select the Entries tab.
The Upload Control feature, located on the upper right of the screen, indicates the number of
uploads in progress.
Click Upload Control to display the file uploads and to view additional information.
Click Bulk Upload Log.
In the Actions column select Download Log File or Download Original CSV/XML.
After the upload process is complete, media is managed through the Content tab.
Kaltura Management Console (KMC) User Manual
30
Transcoding and Processing
CHAPTER 3
Transcoding and Processing
When a video is uploaded to the KMC, the video is associated with a conversion profile, also known as a
Transcoding Profile. A Transcoding Profile may be comprised of a single flavor or multiple flavors. For
each upload session, you should select the Transcoding Profile. You can also set a default Transcoding
Profile.
A transcode is made from taking an encoded piece of video and converting it into one or more newly
compressed streams that can then be played in a player on a computer or mobile device depending on
the settings and methods used. The main purpose of the reconversion is to create a match for the
required target platforms and distribution methods,
Kaltura flavors represent the required renditions of the source file with distinct codecs, frame sizes and
bitrates. You can select to generate or add multiple flavors to an entry, including flavors geared towards
displaying media on mobile devices (low bandwidth, small screens, and/or HTML5 supporting devices).
An asset is a single output file with its specific file type, video/audio codecs, bit-rate, GOP size, that may
be used for playback, download or editing.
The Kaltura platform supports ingestion of all forms of rich media (including video, images, audio, PDF,
an others), and allows you to define different transcoding profiles, depending on your publishing needs.
Additional transcoding flavors can easily be added for publishing across different devices, network
bandwidths and screen sizes. Kaltura's transcoding decision layer engine supports more than 60 video
and image formats as well as 140 video and audio codecs.
When you upload content you determine what type of flavors you want to associate with your output.
There are three transcoding profiles that are automatically created for new accounts:
Default - the flavors included in the default transcoding profile of the account. These flavors
appear in the main Transcoding Settings page.
Source Only - uploads the source file, but does not transcode it; the source is the original file
uploaded as is. Other flavors will not be created.
All Flavors - transcodes uploaded files into all of the flavors defined in the main Transcoding
Settings page. See Transcoding Settings Page.
Converting Videos into Multiple Flavors (Optimized Output Files)
Kaltura’s player provides optimal playback by using adaptive bitrate technology that automatically selects
the most appropriate flavor asset for playback, based on the viewer’s specific connection and other
parameters.
Getting content onto the platform is the first step and transcoding processing is part of the upload
session. For a quick and simple upload, use the default flavors that are provided and that can be
enabled/disabled from the transcoding profile you want to use.
To display the default flavors for transcoding your content
Select the Settings tab and then select Transcoding Settings.
Kaltura Management Console (KMC) User Manual
31
Transcoding and Processing
The Default Transcoding Flavors window is displayed which contains the flavor selection of the Default
Transcoding profile.
Each file uploaded to the system is transcoded into the flavors that are checked.
Editing and Creating Transcoding Profiles
To edit a Transcoding Profile
Select the Settings tab and then select Transcoding Settings.
The Default Transcoding Flavors window is displayed showing the flavors you selected for the
Default Transcoding profile.
On the lower left corner, click Switch to Advanced Mode.
Kaltura Management Console (KMC) User Manual
32
Transcoding and Processing
The Transcoding Profiles window is displayed.
Click a Transcoding Profile (Name) to edit or click Delete to remove a transcoding profile.
Kaltura Management Console (KMC) User Manual
33
Transcoding and Processing
Use the checkbox to select flavors to add or remove.
Enter the Default Metadata Settings Entry ID (Optional). This feature is useful if you want to set
default metadata settings such as tags/categories to files you ingest. See Upload a Media File
and Set Its Metadata. If your account is used and configured to ingest content from Remote
Storage- select the remote storage name from the menu (Optional).
Click Save Changes.
Adding a Transcoding Profile
To create a Transcoding Profile
Select the Settings tab and then select Transcoding Settings.
On the lower left corner, click Switch to Advanced Mode.
Click Add Profile.
Kaltura Management Console (KMC) User Manual
34
Transcoding and Processing
The Add New Transcoding Profile window is displayed. You can view the available transcoding
flavors, or add new Transcoding Profiles and create profiles for different use cases.
Enter a Name and Description for the Transcoding Profile.
Select the flavors out of the available flavors on your account, to apply to the source video you
upload.
The flavors you select become active.
Edit the flavor’s options. (Optional). Click an active flavor name to open the flavor settings in this
Transcoding Profile.
For extra fast publishing, set the Impact On Entry Readiness field to Required, for the minimum
set of flavors and the rest of the flavors to Optional.(optional)
Use this option to publish your content even faster. See Quick Publishing .
Enter the Entry ID for the Default Metadata Settings. (optional) See Uploading Content and
Setting Metadata.
The entry’s metadata fields are added to the transcoding profile. Each new entry that is
transcoded using the profile will include those metadata fields. (You can create a “Metadata
template”.) You can use The Metadata entries as “metadata templates” for adding metadata to
multiple files. See Useful Tips for Working with Transcoding Profiles.
Select the Remote storage name, for linking new entries to media assets located on your CDN or
remote storage, if applicable, to your workflow. Otherwise this feature is disabled with a N/A
indication. See Link to Remote Storage.
Click Create New to create the profile or Save changes if you are editing the profile.
Quick Publishing
A popular requirement for news websites and video publishers is to publish videos as quickly as possible.
Kaltura allows you to control video asset readiness speed by allowing you to configure the ingestion
process to your needs.
By default, a video entry is not at the ‘Ready’ status (for publishing) until all of the required flavors (by
default the required set of flavors is the minimal set of flavors required for web playback) are created. If
many flavors are included in the transcoding profile, the conversion process may take many minutes,
Kaltura Management Console (KMC) User Manual
35
Transcoding and Processing
which is often not fast enough for breaking news videos.
You can configure whether a certain flavor’s readiness is required or not, so that you can publish your
content quickly.
For example, assuming the source flavor is a web-playable entry created using h264 for web and mobile.
You can configure h264 as the required flavor, while all other flavors are optional. The entry will receive
the “Ready” state for publishing immediately after the upload is complete. The other flavors will then be
processed and added to the entry in the background subsequently, after a short processing period.
Failure of a required flavor causes failure for the entire entry.
See http://blog.kaltura.org/extra-fast-publishing for more information.
NOTE: The same flavor may have different settings in a different transcoding profile, which
allows for greater publishing flexibility).
Editing Options for Flavors in a Transcoding Profile
The following options may be edited for each transcoding flavor selected in a Transcoding Profile:
Impact on Entry Readiness –Determines the impact of each specific transcoding flavor on
entry readiness for publishing. See Quick Publishing. The options are:
o
Required – The entry will not be set to a Ready state until the processing of the specific
transcoding flavor is complete. To expedite video readiness we recommend applying the
‘Required’ setting to a single flavor that is required for playback on each required
environment. For example, if the source file is an MOV that cannot be played on the web,
flagging only one lowest quality FLV or MP4 flavor as ‘Required’ will ensure the video will be
published as quickly as possible while the other flavors are being prepared.
o
Optional – The entry may be set to a Ready state before the processing of the specific
transcoding flavor is complete. When no other Transcoding Flavor within the Transcoding
Profile is set as required, completion of the processing of any Optional flavor sets the entry to
the Ready state. We recommend using this option for most flavors to increase speed of
readiness.
o
No Impact – Determining entry readiness is not affected by the presence of this transcoding
flavor. This is usually the default setting for the “Source” transcoding flavor.
Use Kaltura Transcoding – Determines whether to use the Kaltura transcoding engine for
generating each specific transcoding flavor. This option is enabled only when your account is set
to support the ingestion of multiple bit-rate transcoding flavors generated by your local
transcoder. If Kaltura performs transcoding of all flavors except the ‘source’ file, this option
should be set to Always. The options are:
o
Always – Kaltura’s transcoding engine always is used for generating the specific
Transcoding Flavor.
o
Never – The Kaltura transcoding engine will not generate the specific transcoding flavor. This
is a fixed setting for the “Source Flavor” which always is added to the entry with no additional
processing. This option should also be used when your account’s content ingestion workflow
relies on a local transcoding engine and when the ingestion of the previously transcoded
Flavor to Kaltura should always take place, bypassing Kaltura’s conversion processing.
o
As a Fall-back – The system expects to add this transcoding flavor from a local transcoding
engine, but will use Kaltura’s transcoding engine as a fall-back to convert to this flavor when
the flavor is not received as part of the ingestion request. This option adds flexibility when you
want to use your local transcoding engine while utilizing Kaltura’s transcoding engine as a
Kaltura Management Console (KMC) User Manual
36
Transcoding and Processing
fall-back option.
System Name (Optional) – The system name is used to identify the flavor in client-side
applications. For example, to mark a specific flavor as suitable for playback on iPad devices, the
system name was set to iPad.
Flavor Generation Policy – You can bypass Kaltura’s transcoding optimization, and force
specific flavors to be generated even when they are detected as redundant by the Kaltura
transcoding optimization module. The options are:
o
Use Kaltura’s Optimization - Kaltura’s optimization routine decides whether it is worth-while to
create a flavor (For example if the source video is of lesser quality than the flavor, the
optimization routine will not create the flavor).
o
Force Flavor generation –Select this option to override the Kaltura optimization routine and
create a flavor regardless of whether or not it is redundant quality wise (For example, when a
publisher has to distribute the video through a broadcast channel that requires specific flavor
specifications, the flavor must be created.)
Assigning a Transcoding Profile to a Bulk Upload
A default Transcoding profile is included with the KMC. After you create a Transcoding Profile, an ID is
created and listed in the Transcoding Profiles page.
To assign a transcoding profile other than the default profile, to a bulk
upload
Set the ID from the Transcoding Profiles to the conversionProfileId in your CSV.
Set the ID from the Transcoding Profiles List to the conversionProfileId in your XML file.
Useful Tips for Working with Transcoding Profiles
If you want to configure your KMC account to support automated content ingestion workflows, you can
optionally add default metadata settings from an existing entry. The default entry metadata setting
automatically will populate the new content when using each specific transcoding profile.
For example, you want to target two distinct audiences with your videos, the first is public facing videos
and the second is internal company videos.
You can create two transcoding profiles, one for each of your target audiences, even though you might
convert them to the same flavors you can use different “default metadata settings” so your public facing
videos will have their specific metadata values, while the internal company videos can have different
fields or data. All this is done automatically after you prepare one template entry for the process.
To use metadata settings with transcoding profiles
Create the template entry you want to use:
Create a “Draft” entry, using the Upload tab. See Creating Draft Entries.
Prepare the metadata. See Prepare a Metadata-only "Draft" Entry for Future Ingestion of Media
Files.
For example: Template Entry for Transcoding Profile X”.
Kaltura Management Console (KMC) User Manual
37
Transcoding and Processing
If you use custom metadata, edit the entry metadata fields. For example you can enter data that
reflects the template data for your company, such as your “company name” field since your
company name is unlikely to change.
If you do not use custom metadata, click here to learn more about it.
You next have to set the template entry on the transcoding profile.
Go to the Settings tab and select the Transcoding Profiles tab.
Select the flavors of your default transcoding profile.
Click Switch to Advanced Mode link at the bottom of the page.
Edit the transcoding profile you wish to create a template entry for, by clicking on it.
In the Edit Transcoding Profile window, enter the Entry ID you want to set as the template entry in
the Default Metadata Settings field.
The Flavors Tab
The Flavors tab in the Edit Entry window allows you to manage the flavors that are available as well as
replace media files and their transcoding flavors.
Kaltura Management Console (KMC) User Manual
38
Transcoding and Processing
Use the Flavors tab to:
Add video or audio media to a new entry you created (when the entry status is No Media).
Replace the media of an existing entry (when the entry status is Ready or Error).
View the list of flavors that the system created for an entry and apply the following actions:
o
Preview or delete a flavor.
o
Download the transcoded file to your desktop.
o
Upload a file from your desktop you that transcoded on your own, to serve as a flavor for an
entry.
o
Upload a file from a drop folder to set as the transcoding flavor
o
Import the flavor from a URL.
o
Convert or reconvert to transcode an entry to additional flavors.
After the transcoding process is complete, the new file replaces the old file and the original file is deleted.
When your KMC account supports direct ingestion of multiple bit-rate Transcoding Flavors, you can use
the Action menu to add or replace a single Transcoding Flavor in an entry.
Add Video/Audio
The Flavors tab displays several Add Video/Audio options when an entry is not yet associated with any
media that is, the entry status is No Media. See Prepare Entry. For more information see Replacing
Media.
Upload Files
Kaltura Management Console (KMC) User Manual
39
Transcoding and Processing
Use this option to add media to an existing entry by uploading one or more files from your desktop.
To upload content and flavors to a Draft entry
Click on the Draft Entry and then select the Flavors tab.
Click Upload File/s to open a standard desktop file selection window.
The uploaded file is treated as the source for generating the required Transcoding Flavors in
Kaltura. When your KMC account supports direct ingestion of multiple bit-rate Transcoding
Flavors, you can select multiple flavor files for the Transcoding Profile.
Select the files from your desktop, confirm your selection, and set the relevant Transcoding
Flavor that the uploaded file will be transcoding by.
The Transcoding Flavor options in the menu are set from the selected Transcoding Profile and its
flavor settings.
Click Upload to confirm your upload request.
The KMC immediately starts processing the file uploads. The uploaded file is added to the entry and
flavor conversion processing starts.
Import Files
Use this option to add media to an existing entry by importing a media file from your existing web host or
FTP server. The option is displayed when the entry status is No Media.
To import content and flavors to a Draft entry
Click on the Draft Entry and then select the Flavors tab.
Click Import Files to set your media file URL.
The imported media file is treated as the source for generating the required Transcoding Flavors
in Kaltura. When your KMC account supports direct ingestion of multiple bit-rate Transcoding
Flavors, you can set multiple URLs.
Set the relevant Transcoding Flavor that the imported file will be transcoded by. The Transcoding
Flavor options in the menu are set from the selected Transcoding Profile and its flavor settings.
Click Import to confirm your import request.
Kaltura Management Console (KMC) User Manual
40
Transcoding and Processing
An import request is submitted to the Kaltura server. The imported file will be added to the entry and
flavor conversion processing starts.
Link to Remote Storage
Kaltura’s Remote Storage and Delivery solution enables publishers to manage their video assets and
account settings on Kaltura’s hosted video platform while actually storing the content on their own remote
network storage location, and delivering the content from the same remote location. Kaltura’s remote
storage and delivery capabilities are fully integrated with the platform’s ingestion, transcoding and
publishing workflows, and provide system flexibility for addressing publishers’ specific storage and
delivery needs.
You can link content to remote storage from the KMC User Interface. The Link to Remote Storage option
is useful for partners that use their own transcoder and also host and deliver content on/from a remote
storage (e.g. CDN storage, internal organization storage). The partner’s transcoder generates the flavors.
After the files are uploaded directly to the remote storage it is only necessary to indicate which flavors to
link to an entry in Kaltura. The connection of the remote storage profile to the transcoding profile is used
for this purpose.
Kaltura Management Console (KMC) User Manual
41
Transcoding and Processing
Contact your Kaltura account manager to learn more about how this feature can simplify your workflow,
and to activate and configure remote storage on your account.
Match Files from Drop Folder
Use this option to match media to an existing entry from your account’s drop folder. This option is
displayed when your account is set with a drop folder configuration. For more information see Kaltura
Drop Folder Service for content Ingestion.
Replacing Media
You can replace media content when an entry is ready for publishing or when a media processing error
occurred. The entry itself, with its current metadata, entry ID, and analytics information, remains
unchanged.
All Transcoding Flavors are replaced as one unit to ensure that inconsistency errors do not occur
between old and new Transcoding Flavors at any given time.
You can review the Transcoding Flavors of the new media file in a temporary entry that is available for
this purpose only. After you approve media replacement, all of the entry’s existing Transcoding Flavors
are deleted and are replaced by the new ones.
To replace media
Select the Content tab and click on an entry.
Kaltura Management Console (KMC) User Manual
42
Transcoding and Processing
Select the Flavors tab and click on an entry.
Select the replacement method.
See Upload Files, Import Files, Link to Remote Storage or Match Files from Drop Folder.
After you trigger the action, a link to review the new Transcoding Flavors generated for the new
media becomes available on the Flavors tab.
Click on Processing - Click here to review to see the transcoding process.
Kaltura Management Console (KMC) User Manual
43
Transcoding and Processing
Click Approve Replacement. All current flavors are replaced when you approve the replacement
or click Cancel Replacement to cancel your actions.
When you trim an entry, you trigger a similar process that replaces existing flavors with the trimmed
version.
Supported Source Formats
The following source formats are supported out of the box and may be ingested by the Kaltura platform:
FLV/F4V, MOV/MP4/QT/M4V, AVI, 3GP, ASF/WMV, MPG/M1V/M2V, MKV, Ogg, RM, WEBM, ARF
Additional formats may be supported as well but have not been verified.
Supported Source Codecs
The following codecs are supported (Additional codecs may be supported as well but have not been
verified):
Input Video Codecs
Dvix (Div3/4/5)/DX50, DV, H263, H264/AVC, MPEG-4 Visual, MPEG-1/2, MJPG, MP42/3, IV40/50 (Indeo
codecs), RV30/40, RMVB, FLV1/4, VP3/5/6/7/8, SVQ1/3 (Sorenson), XVid, Theora, WMV1/2/3, VC1,
VP8, ProRes 422, ICOD, DVCPRO. PXLT, TCSS/TCS2, G2M3/4,
Input Audio Codecs
MP3, MP1/2, AC3, AAC, Vorbis, AMR, PCM, WMA7/8/9, WMSpeech, FLAC, QDM2, RA, Nellymoser,
Cook, GSM, SPEEX.
Kaltura Management Console (KMC) User Manual
44
Transcoding and Processing
Target Formats/Codecs
The following target formats and codecs are supported– i.e. formats and codecs that can be managed
and/or displayed using the Kaltura platform:
Target Formats
FLV, MP4, AVI, 3GP, OGG, MKV, WMV/WMA, Silverlight Smooth Streaming, Apple HTTP Live
Streaming (HLS), WEBM, MPEG, MPEG TS, WAV
Target Video Codecs
H264, H263/FLV1, Theora, MPEG-4 Visual, WMV1/2, VC1, VP6, VP8, MPEG-2
Target Audio Codecs
MP3, AAC, AAC HE, Vorbis, WMA/Pro, AMR NB, MPEG2, AC3, PCM
Delivery-specific Formats
Kaltura supports various streaming types. See Video Delivery Settings for more information about the
types of video delivery settings.
Kaltura Management Console (KMC) User Manual
45
Creating and Customizing Playlists and Players
CHAPTER 4
Creating and Customizing Playlists and
Players
This section describes how to create and customize playlists and players.
What is a Playlist?
A playlist is a list of media items (videos, audios, images) that can be embedded with a player in your
website. Playlists can serve as the basis for RSS feeds, content feeds to over the top devices or
integrations such as Roku, Boxee. See Content Syndication.
Playlists Tab
There are two types of playlists available in the KMC:
Manual
Rule Based
Manual playlists allow you to select a static list of items, while Rule based playlists are dynamic, and
automatically update based on what's currently available in your media library and what rules define the
playlist. After you've created your playlist, you can assign a playlist to a player. See Designing and
Configuring a Player.
A manual playlist can have a maximum of 150 entries. A rule based playlist may have a maximum of 50
entries, however, when the playlist is used in a syndication feed the limitation is 10,000 entries.
Creating a Manual Playlist
For a manual playlist, you select a group of videos manually to be played in the desired order. The order
in which videos are played can be changed in manual playlists at any time, by using the up down arrows
to set the video to the desired location within the playlist.
To create/add a manual playlist
Select the Content tab and then select the Playlists tab.
Select Add Manual Playlist.
Kaltura Management Console (KMC) User Manual
46
Creating and Customizing Playlists and Players
Enter an informative Name for your playlist.
Use the Filters to search for entries you want to include. See Locating Files – Content Search.
The results are displayed in the Entries Table.
Add entries to your playlist by moving the desired entries from the Entries Table to the Playlist
Entries. Use the horizontal arrows.
Set the order of the entries using the vertical arrows.
Highlight the entry and then use the up down arrows to place the entries in their appropriate
order. Clicking on the entry will open it for editing.
Click Save to complete the process.
Kaltura Management Console (KMC) User Manual
47
Creating and Customizing Playlists and Players
Creating a Rule Based Playlist
A rule based playlist is a dynamic playlist that is automatically updated when content is uploaded or
edited. To create a rule based playlist, you create a rule that selects the videos to include in the playlist.
The rules may be based on the tags assigned to the videos, or you can create rules for ordering the
videos and for the maximum number of videos to include. For example, you can create a “Most Viewed”
playlist, a “Most Recent” playlist, as well as a playlist based on single or multiple filters, such as “videos
tagged with “dogs” and created during January 2010”.
As you upload videos that match the rule, they are automatically added to the playlist.
Defining a Rule
You can define a rule that will result in your playlist content. You can use any number of filters: you can
define a list of clips that all have the same tag (for example, if you enter the term "dog" into the search
box and click search, a new rule-based playlist is created for all the clips that have the "dog" tag). This list
will dynamically change each time a clip is added or deleted to/from your account.
For example, you can define a rule-based playlist that consists of all the 0-4 minute video clips that were
created in the past week. In addition to filtering, at the bottom of the window, you can define a preferred
order for your playlist. You can order it by Most Viewed (overall, last week or last 24 hours) or Most
Recent (for example, most recently added to the KMC).
If, for example, you would like to create a dynamic playlist that at any given moment consists of the most
viewed clips in the last week, all you need to do is create a new filter and select the "Most Viewed 7 Days"
option from the "Order by" drop-down menu.
On the bottom of the playlist you can see the number of entries in the playlist and their total length. You
can automatically limit the number of entries that are included in the playlist by adjusting the counter
positioned to the right of the "Order by" drop-down menu.
Your playlist can be based on a single rule or multiple rules. If you want to apply more than one rule to
Kaltura Management Console (KMC) User Manual
48
Creating and Customizing Playlists and Players
your playlist, click the "Switch to Advanced Mode" link at the bottom of the window. Note that this will
clear all previous information that you have saved in your playlist.
To create/add a single rule playlist
Select the Content tab and then select the Playlists tab.
Select Add Rules Based Playlist.
Enter an informative Name for your playlist (required).
Using the Filters, search for the entries you would like to include.
The results are displayed in the Entries Table.
You can choose more than one type of filter (for instance, text search + date + media type), the
logical relationship between fields will be an "AND" relationship.
Select your preferred video order from the Order By drop-down menu.
The following options are available:
o
Most Played
o
Most Recent
o
Highest Rated
o
Entry Name
Select the total number of entries you would like to include in the playlist via the Limit Playlist
result box.
Click Save Changes to complete the process.
Kaltura Management Console (KMC) User Manual
49
Creating and Customizing Playlists and Players
Multiple Rules Based Playlist - Advanced Mode
Use the Advanced Mode to create playlists based on multiple rules.
To create/add a multiple rules based playlist
Select the Content tab and then select the Playlists tab.
Select Add Rules Based Playlist.
Click Switch to Advanced Mode.
Enter a Name for your playlist (required).
Click Add Rule to create a new playlist rule. (See Creating a Rules Based Playlist to learn about
creating rules.)
Kaltura Management Console (KMC) User Manual
50
Creating and Customizing Playlists and Players
Add additional rules.
Use the Remove Rule and Edit Rule buttons to make changes to your list of rules.
Kaltura Management Console (KMC) User Manual
51
Creating and Customizing Playlists and Players
Rules are applied to the playlist in the order they appear. Use the arrows to change the order of the rules.
Additional Playlist Configuration
Other actions that you may apply to playlists include:
Creating Multi-tab Playlists
Deleting a Playlist
Removing Videos from a Playlist
Customizing Additional Features for Playlists
Creating a Player with Multi-tab Playlists
A Multi-tab Playlist contains multiple tabs, each containing a different playlist.
To create a multi-tab playlist
Select the Studio Tab and then select New Player – Multiple Horizontal Playlist or Multiple
Vertical Playlist.
The Basics tab is displayed.
Design and configure your playlist. See Designing and Configuring a New Player or Playlist.
Select the Content tab and add pre-existing playlists to your new Multiple Playlist.
Kaltura Management Console (KMC) User Manual
52
Creating and Customizing Playlists and Players
Use the arrows to select from the list of All playlists and move them to the Playlist tabs list.
Save Changes to complete the process.
The players will appear in the Multiplayer List. Each playlist is displayed in a new tab.
Deleting a Playlist
To delete a playlist
Go to the Content tab and then select the Playlists tab.
Select the playlist in the workspace and click Delete.
Removing Videos from a Playlist
To remove videos from a manual playlist:
Go to the Content tab and then select the Playlists tab
Select the playlist.
Select one or more videos from the Playlist Entries and use the horizontal arrows to move them
to the Entries table.
Removing a video from a playlist does not delete it from your content library.
You cannot remove a video from a rules based playlist directly. Instead, you can:
Modify the tags of the video so that the video no longer has any of the rules based playlist's tags.
Modify the tags of the playlist so that they no longer include any of the video's tags.
Delete the video.
Customizing Additional Features for Playlists
When creating a player (either with one or multiple tabs) you will see additional configuration options
under the Playlist Items section. Various types of information for each of the playlist items, such as
number of plays, tags, rank etc. are displayed.
Use options in the Features section to customize the player's design.
Kaltura Management Console (KMC) User Manual
53
Creating and Customizing Playlists and Players
Designing and Configuring a Player
Use the Studio tab to create configurations and design players and playlists. You can add, remove and
adjust multiple buttons and features, and create a look to match your site. A playlist is a collection of
videos that are grouped together in a particular order for playback in the Kaltura Player. After you've
created your playlist, you can assign your playlist to a player.
Player List
The Studio tab displays the list of the players defined in the system. The default players that are included
within the system, as well as players defined and created by administrators via the KMC are displayed. A
default playlist is automatically created for a new player based on the most played entries for the Partner
ID.
The Studio contains the following templates of players:
A studio template is a collection of features of a specific Kaltura Player configuration. The template is
actually a collection of the player uiConf and another .xml file called features.xml. For more information,
see here.
Kaltura Management Console (KMC) User Manual
54
Creating and Customizing Playlists and Players
Workflow:
Select the Type of Player.
Configure the Player Basics Settings.
Configure the Player Features.
Configure the Player Style.
Select the Type of Player
To create a player
Select the Studio tab.
Select the type of player to create.
The Create New Player window is displayed.
Configuring the Player Basics Settings
To configure the player’s Basics settings
Select the Basics tab and enter an informative Player Name (required).
Set the Video Ratio – select to keep or stretch your media to fit the player when the media and
player aspect ratios are different.
Select Auto-play features.
Select the Playlist’s controls.
If you are creating a Player and a Playlist you will also see the Playlist Controls. Check Automatically
continue to the next entry, to play the playlist media consecutively.
For playlists with images, set the duration for images to be displayed during the continuous play of the
playlist.
Playlist controls do not apply to the 508 Player.
Editing a Player
The changes you make to an existing player will propagate to all sites where the player has been
embedded, including syndicated players on other sites.
To edit a player
Select the Studio tab.
Click on the relevant player in the Player List.
Players created manually through Kaltura's professional services cannot be edited in this area.
Select Edit from the Select Action drop down.
Kaltura Management Console (KMC) User Manual
55
Creating and Customizing Playlists and Players
The player configuration Features tab is displayed. See Player Control Options.
Check the control options for the player and then Save Changes.
Adding Content to a Player
To add content to a player
Select the Studio tab.
Highlight the relevant player in the Player List and select Select Content from the Select Action
drop down.
The Entries table from the Content tab is displayed.
Select an Entry. You can preview the entry using the player you started off with.
Click Preview and Embed and then grab the embed code and copy it to publish the player to your
site.
Click Save and Close.
Duplicating a Player
To duplicate a player
Select the Studio tab.
Click on the relevant player in the Player List.
Players created manually through Kaltura's professional services cannot be edited in this area.
Select Duplicate from the Select Action drop down.
The player configuration Features tab is displayed. See Player Control Options.
Check the control options for the player and then Save Changes.
Kaltura Management Console (KMC) User Manual
56
Creating and Customizing Playlists and Players
Deleting a Player
Deleting a player eliminates it from all the locations where the player has been previously embedded. For
example, if you have embedded a player using this design on your site or an external site, after you
delete it from the Player List, the player will no longer appear and a blank area is displayed on the
website.
To delete a player
Select the Studio tab.
Click on the relevant player in the Player List.
Select Delete from the Select Action drop down.
508-Compliant Video Player
The 508 compliant video player includes functionality and interface design that support federal
accessibility requirements as outlined in the Voluntary Product Accessibility Template. Please note that
the 508 compliant player has limited functionality.
To create the 508 player
Select the Studio tab.
Select 508 Single player Video,
Edit the player. In the Players List, select the player and then in the Actions column select Edit.
In the Basics tab:
a. Enter an informative Player Name (required).
b. Set the Video Ratio – select to keep or stretch your media to fit the player when the media
and player aspect ratios are different.
c. Select Auto-play features.
d. Save changes.
In the Features tab:
a. Select the Player Controls.
b. Select the Subtitles and Transcriptions Options. See Setting Up Captions for Display.
c. Save Changes.
Kaltura Management Console (KMC) User Manual
57
Creating and Customizing Playlists and Players
The player includes:
Support for captions file in timed text or SRT formats for the video/audio file
Support for an audio description in a standardized format for the video/audio file
Hidden text elements for every non-text element (for screen readers)
Tooltips
Keyboard tabbing and controls
No color coding information
High contrast controls
No draggable controls
Configuring the Player Advertising Settings
To configure the player advertising settings
Select the Studio tab and then select or create a player.
Select the Advertising tab.
Toggle on Yes to Request ads for this player. See Advertising and Ad Networks.
Fill in the fields that define how the player handles advertisements, and click Save Changes.
Configuring the Player Features
The Features tab is made up of different sections, controlling the various features of the player.
Use the options in this tab to select the features (buttons, layers and modules) to be included in your
player. The main screen is divided into the Features List on the left and the Preview Pane on the right. As
you select your features from the list, you can preview the changes in real time in the preview pane on the
Kaltura Management Console (KMC) User Manual
58
Creating and Customizing Playlists and Players
right.
Features List
The Features List contains the list of configurable features (buttons, layers and modules) available for this
player. Checking the box next to any feature allows you to preview it in the Preview Pane. Most of the
features have in-depth configuration options.
To view and customize the player different features
Select the Studio tab and then select a player.
Select the Features tab.
Click the options link next to each feature name.
Features are grouped by their type/usage:
Controls
The Controls area includes basic player features, such as title text, play, scrubber and more. You can
also access each of these features using the JavaScript API.
Distribution and User Interaction
The Distribution and User Interaction area includes features that assist in content distribution, such as the
download and share buttons. Note that the download button only supports downloads of single video files
and does not support mix downloads - contact Kaltura Professional Services to enable download of mix
content.
Kaltura Management Console (KMC) User Manual
59
Creating and Customizing Playlists and Players
Subtitles and Transcriptions
In the Subtitles and Transcriptions area, you can select the type of captions files to use. See Setting Up
Captions for Display.
You can also select whether to use an Audio Description file if you have configured a 508 compliant
player. See Adding an Audio Description File to an Entry.
Kaltura Management Console (KMC) User Manual
60
Creating and Customizing Playlists and Players
Security
In the Security area, you can select to enable DRM with Widevine. Adding the DRM-Widevine option
enables license protected playback of encrypted content in the player (Flash player only).This option is
applicable only when the DRM feature is enabled for your account. For more information see Kaltura’s
Digital Rights Management (DRM) Service with Widevine Setup and Workflow Guide.
Analytics
In this area you can select to enable Google or Akamai Media Analytics.
Click on the options to configure the Analytics parameters.
Akamai Analytics, supports sending player analytic event to Akamai. Google Analytics, supports sending
player analytic event to Google.
For a full implementation description, see Google Analytics for the Kaltura Player.
Kaltura Management Console (KMC) User Manual
61
Creating and Customizing Playlists and Players
Custom Buttons
The Custom Buttons area requires a higher level of expertise, and enables you to customize your player
via JavaScript. Buttons evoke pre-defined JavaScript functions.
Additional Parameters and Plugins
To simplify the management of many of the player features, Kaltura has implemented the “UIVars” to
override and configure player features.
Kaltura UIVars are an incredibly powerful feature of the Kaltura Players that h allows publishers to pre-set
or override the value of any FlashVar (object level parameters), show, hide and disable existing UI
element, add new plugins and UI elements to an existing player and modify attributes of all the player
elements. For more information see How to use the Kaltura Player Studio's Additional parameters and
plugins.
Playlist Items (For players with playlist)
The Playlist Items area allows you to select which information is presented for each item on the playlist
(for example, show thumbnail, rank, tags and more).
Preview Pane
The Preview Pane enables you to preview the selections you make in the Features List area as well as
define the player size and preview the player in different states (during play, pause, end, etc.).
Player Size
Set the player size by selecting the width. The player height will adjust accordingly based on the width
and the video screen ratio selected in the Template Tab.
Kaltura Management Console (KMC) User Manual
62
Creating and Customizing Playlists and Players
Auto Preview
In the Studio tab the player is automatically rendered every time you change a control. Uncheck Autopreview to discontinue this behavior.
Preview States Buttons
These buttons enable you to preview the player in different states: before play, during play, paused and
end screen. Alternatively you can simply play the demo content within the player, pause the video
manually, etc.
To configure the player’s features
Select the Features tab.
Expand the menus to configure your player.
Any changes you make will appear in the preview area. (Click the Preview button to see the
changes.)
Click Save Changes.
Examples
The following player displays an example of the default player design with a watermark display.
NOTE: This sample presents only one of many set-up scenarios. There are many configuration
options within this section.
Kaltura Management Console (KMC) User Manual
63
Creating and Customizing Playlists and Players
To change where the watermark is displayed in a player
Select Controls, see Player Control Options, check Your Watermark and then click Options.
In the Watermark Location on the video drop-down menu select the location position.
Click Preview and then Apply to confirm your choice.
To change the label of the Share button
Select Distribution and User Interaction; see Distribution and User Interaction.
Check the Share button and click Options.
In the Label field, enter new text (for example, Share Now!).
In the Preview area, click the Preview button to see the changes.
On the Share Button pane, click Apply to confirm your choice and return to the Features list.
Enter other relevant parameters for sharing to Twitter or AddThis.
Click Apply and Save Changes.
Kaltura Management Console (KMC) User Manual
64
Creating and Customizing Playlists and Players
To add a download button to the video area only
Select Distribution and User Interaction.
Check Download button feature and click Options.
Clear the Controls Area option.
Under Location & Playing States, check Video Area.
Under Video Area, check or clear playing states to determine when to display the download
button in the video area.
In the Preview area, click the Preview button to see the changes.
On the Download Button pane, click Apply to confirm your choice and return to the Features list.
Click Save Changes.
Kaltura Management Console (KMC) User Manual
65
Creating and Customizing Playlists and Players
To change a Full Screen button in the control area of a player to text button
In the Edit Player or Create New Player window, select the Features tab.
On the Controls menu, check Full Screen Button and then click Options.
On the Full Screen Button pane:
o
Check Controls Area.
o
In the Display in controls area drop-down menu, select Label.
o
(Optional) In the Button Label field, enter new text.
(Optional) In the Tooltip fields, enter new text.
In the Preview area, click the Preview button to see the changes.
On the Full Screen Button pane, click Apply to confirm your choice and return to the Features list.
Click Save Changes.
Kaltura Management Console (KMC) User Manual
66
Creating and Customizing Playlists and Players
Configuring the Player Style
Use the Style tab to select the theme, colors and fonts for your player.
To configure the player style
Select the Style Tab.
Under Style and Color, select Dark or Light in the Select theme drop-down menu.
Under Control bar buttons and On-video buttons, click the small colored square next to each
option to open a color picker.
For each option, select a color or enter a color value.
Under Font, select a font in the drop-down menu.
In the Preview area, click the Preview button to see the changes.
Click Save Changes.
After you define your player template, features and style, click Save Changes to complete your
Kaltura Management Console (KMC) User Manual
67
Creating and Customizing Playlists and Players
player configuration and design.
Your new player is displayed in the Players List.
Kaltura Management Console (KMC) User Manual
68
Managing Metadata
CHAPTER 5
Managing Metadata
This section contains the following topics:
Entry Metadata
Creating and Managing Content Categories
Uploading Content and Setting Metadata
Metadata and Related Files
Kaltura Custom Metadata Functionality
Managing Schemas
Entry Metadata
Entry Metadata fields are used to tag, manage, search and expose content. You can populate out-of-thebox fields, or create your own custom metadata schema. Kaltura provides extensive asset management
and metadata capabilities. Each media entry has a list of predefined metadata fields including: Name,
Description, Tags, Categories, Thumbnails, Duration, Views, and other fields.
Types of Metadata
Kaltura supports three types of metadata for its media assets.
Technical metadata (read only) – includes the technical attributes of the media file. For example,
the file type, duration, file format. See KalturaMediaInfo in the API Documentation, for a full list of
predefined fields.
Basic metadata – includes Name, Description, Tags, and Categories’ fields. In addition, Kaltura
allows referencing the media entry using an external identifier which can be stored in the
Reference ID field.
Custom metadata – includes custom fields, defined under one or more schemas, which allow
enhancing any media object into a custom business object.
Commercial users, please contact your account manager to enable this feature in your account.
Technical metadata, also known as system metadata, is generated automatically during ingestion and
encoding of the file. All technical metadata information can be accessed through the Kaltura APIs.
Basic metadata is the information you input to the KMC through the Metadata tab. The Reference ID field
allows storing an external identifier for supporting integrations with systems external to Kaltura or can be
used to match a filename to an entry using the Drop Folder feature. See Automated Content Ingestion
via a Drop Folder. Tags are comma separated and can be used as filters for searching through your
content. Categories allow assigning media objects to taxonomies.
Custom metadata, also referred to as Custom Data is stored in a schema, also known as a metadata
profile. You can create multiple schemas and assign them to any Kaltura object. The KMC supports
schemas for entries and categories only. To extend the metadata of an entry, you need to create a
custom schema for entries. See Adding a Schema.
Kaltura Management Console (KMC) User Manual
69
Managing Metadata
Custom data is stored as an XSD schema that you can use to create, edit, and manipulate data. You can
also use the XSD schema to generate you own metadata interface. Custom data XSDs are account
specific.
Metadata Actions
You can manage assets and metadata through the:
KMC UI - You can edit basic and custom metadata for a single asset, or apply a change of a few
basic metadata fields to multiple selected assets.
KMC Entries Bulk upload (CSV/XML) – You can add assets in batch, combining both media files
and associated metadata. (See Bulk Upload and FTP Upload).
Kaltura APIs – All metadata-related functionality available through the KMC can also be
performed using the Kaltura APIs. The APIs also expose additional functionality not available
through the KMC. For more information see here.
Uploading Content and Setting Metadata
Uploading Content and Setting Metadata Workflow:
Upload a media file then set its metadata.
Ingest a media file bundled with metadata (CSV, XML, API)
Prepare a metadata-only "draft" entry for future ingestion of media files.
Upload a Media File and Set Its Metadata
To upload a media file and set its metadata
Go to the Upload tab.
Upload a media file. See The Upload Tab.
Go to the Content tab and select the Entries tab.
Select a Video/Audio entry.
In the Metadata tab, add or edit the following metadata information:
a. Name
b. Description (Optional)
c. Tags
d. Categories
e. Reference ID (Optional).
If you have Custom Data for entries, you can edit the Custom Data fields for the entry. For
multiple schemas, use the drop down Jump To menu to select the schema for the entry. See
Upload a Media File and Set Its Metadata.
Click Save & Close.
The Entry ID assigned to a metadata entry can be used to assign metadata to multiple files. See Editing
and Creating Transcoding Profiles.
Ingest a Media File Bundled with Metadata (CSV, XML, API)
Kaltura Management Console (KMC) User Manual
70
Managing Metadata
To enable more advanced content ingestion options, the provided CSV/XML samples can be extended to
include multiple/custom metadata items, account specific settings, update action and advanced content
ingestion options (for example, ingestion of multiple transcoding flavors, multiple thumbnails etc.) Each
item element within the XML, and each line in the CSV, represents a single entry created in the publisher
account. Each entry will be populated with the metadata listed in its item element and the content
referenced from it. When submitted, the bulk upload XML/CSV is validated on the Kaltura server. The
validation includes an inspection of the XML structure, and verification of elements' structure and order
compliance with Kaltura's bulk upload XSD (XML schema). For more information see Bulk Upload and
FTP Upload.
To ingest a media file bundled with Metadata
Select the Upload tab.
Click Download CSV/XML Samples.
Enter the metadata in the relevant fields.
For more information on the XML Custom data upload see the following:
http://www.kaltura.com/api_v3/xsdDoc/?type=bulkUploadXml.bulkUploadXML#elementcustomDataItems
http://www.kaltura.com/api_v3/xsdDoc/?type=bulkUploadXml.bulkUploadXML#elementcustomData
Prepare a Metadata-only "Draft" Entry for Future Ingestion of
Media Files
To create a draft entry
Go to the Upload tab.
Prepare a Video/Audio Entry.
To add the content (media source file) into the metadata entry
Go to the Content tab and select the Entries tab.
Select a Draft (No Media) entry.
The Edit Entry- Draft Entry form is displayed.
Select the Flavors tab.
Add the media source file. Select from one of the following options:
Upload Files – upload from your desktop
Import Files – import from the web.
o
Enter the File URL and select the Transcoding Flavor.
o
Click Import.
Metadata and Related Files
Related Files are relevant to metadata in relation to transcript and captions/subtitles. Captions and
Subtitles files are considered as metadata files that are time based and related you an entry. For more
information, see Uploading and Modifying Related Files.
Kaltura Management Console (KMC) User Manual
71
Managing Metadata
Kaltura Custom Metadata Functionality
You can create a unique metadata schema. The entire schema management is done via the KMC UI.
You can add fields of the following types:
Text field – values are free text
Text select list – this is similar to the text field, also known as List of Values, This option allows
the publisher to define a predefined list of fields to be used. After you enter the values, you are
presented with a select box element to select a value from the existing list (for example countries,
months)
Date - a date field
Entry ID list - a list to a different entry (asset) that can be used to create compound structure.
Examples of this would be, Related Videos, linking trailer to full-length film etc.
The following is an example of a Custom Metadata Schema.
Using Custom Data for Entries
As a best practice we recommend richly mapping your media assets with metadata to make your assets
more findable and better used as business objects.
You can fill in the values for the defined schema for each media asset (entry). The UI elements are built
per the field type supporting text fields, checkboxes for multiple selections (from predefined values list),
date selector (for date fields), text list (for multiple value fields), and linked entries (for creating structure).
The schemas you customize may be used for viewing and editing, as well as for filtering, search, and
syndication rules. Custom data may be used as a condition for distributing content. For example if you are
trying to distribute data and a custom data field has been defined and expected by the distribution
channel, if the custom data is not received, the content will not be distributed.
Searching (and creating syndication rules) by a custom field is integrated into the KMC UI and workflows.
Kaltura Management Console (KMC) User Manual
72
Managing Metadata
Using Custom Data for Categories
Using Custom Data for categories is useful when you need to set the category itself with non-standard
metadata. You can manage metadata for display on the channel page in your application, within the
category object and not through entries’ metadata. You can create complex filters to control which
categories and channels to display in different areas of your website, and specify other options.
Creating and managing categories’ custom data is identical to how entries’ custom data schemas and
values are managed and set in the KMC. Custom Data schemas should be set to apply on entries or on
categories and cannot apply on both.
NOTE: The categories’ custom data is not inherited by the entries associated with each
category. Categories’ custom data is solely related to the category object and applies on
category related Kaltura API calls only.
Managing Schemas
A schema is a model for describing the structure of information. Each data schema holds a list of
customized fields. An XSD (XML Schema Definition) provides a way to describe and validate data in an
XML environment.
Adding a Schema
To add a schema
Select the Settings tab and then select the Custom Data tab.
Click Add New Schema.
The New Metadata Schema window appears.
Enter a Name and Description.
Select what entity to apply the metadata to. The options are Entries or Categories.
Enter the System Name (optional). This field is required if you are uploading content using Bulk
XML files or if you need access to the schema via the API.
Click Add Field.
Add custom data fields.
Kaltura Management Console (KMC) User Manual
73
Managing Metadata
Adding Custom Data Fields
To add custom data fields
Select the Settings tab and then select the Custom Data tab.
Add a schema. See Adding a Schema.
Click Add Field.
The New Field window appears.
Kaltura Management Console (KMC) User Manual
74
Managing Metadata
Select the Field type. See Kaltura Custom Metadata Functionality.
Enter values for the field or list.
(Optional) Add a Description, or Full Description.
Click Save. The Custom Fields List is displayed.
Use the up and down arrows to change the order of the fields.
The following is an example of entering data as a Text Select list for the field Publish Values.
Kaltura Management Console (KMC) User Manual
75
Managing Metadata
The following screen displays a schema with an entry ID chosen.
Setting Values for Custom Metadata Fields - Per Entry
To add values to the custom metadata fields
Select the Content tab and select Entries.
Click on entry in the Entries table.
The custom data is displayed in the Metadata tab.
Add or modify the Custom Data values and click Save & Close.
The following screen demonstrates the values insertion page within a specific schema. Use the scroll to
view the entire schema information.
Kaltura Management Console (KMC) User Manual
76
Managing Metadata
To add or remove related entries
Create a schema and add the Related Entries field. See Adding Custom Metadata Fields.
Select an Entry and select the Metadata tab.
Scroll to the Related Entries field and click +Add/remove Linked Entries.
Kaltura Management Console (KMC) User Manual
77
Managing Metadata
Move the Related Entries from the Entries table to the Selected Entries list and click Save.
Setting Values for Metadata Fields - Per Category
Custom Data values are set to categories in a similar way they are set for entries, but from the metadata
tab of the Edit Category window.
Kaltura Management Console (KMC) User Manual
78
Managing Metadata
To add values to the custom metadata fields
Select the Content tab and select Categories.
Click on a category in the Categories table.
The custom data is displayed in the Metadata tab.
Add or modify the Custom Data values and click Save & Close.
The following screen demonstrates the values insertion page within a specific schema. Use to
scroll to view the entire schema information.
Kaltura Management Console (KMC) User Manual
79
Locating Content in the KMC
CHAPTER 6
Locating Content in the KMC
This section contains the following topics:
Searching Through Entries
Filtering Content in the Entries Table
Searching Through Categories
Filtering Categories in the Categories Table
Searching Playlists
You can use categories, tags, or any of your custom metadata fields to locate content in the KMC.
Searching Through Entries
The search box in the Entries page enables you to search for specific entries or entry attributes that exist
in your account.
Entries Search Rules
When searching for entries from the KMC search box in the Entries page and/or from the search box
within the Playlist window, the following rules apply:
The Kaltura search engine will match the search term within the KMC search box against the
following entry attributes:
Entry Name, Entry ID, Entry Tags, Entry’s Description, Entry Reference ID, Entry owner ID, Entry
ID of origin entry for clips created in Kaltura, any Entry custom data fields of type: text that was
set to be searchable.
Search criteria may include alphanumeric as well as special characters such as: `, ~, !, @, #, $,
%, ^, &, *, (, ), -, _, =, +, [, ], {, }, ;, :, ', \, |, /, ?, <, >
The space character is treated as an AND search operand. For example, searching for” hello
world” will result with all entries that include both the word hello and the word world in one of the
searchable entry attributes.
The comma character is treated as an OR search operand. For example, searching for hello,
world will result with all entries that include either the word hello, or the word world in one of the
searchable entry attributes.
The ! character is treated as an AND NOT search operand. For example, searching for hello !
world should result with all entries that include the word hello but do not include the word world.
The ! at the beginning of the search criteria is not supported within this AND NOT operant
context. When searching for actual words that start/end with the ! character, the ! character
should be escapes using a backslash. For example, if you want to search for entries that include
the word !hello or hello!, enter the following terms within the KMC search box: \!hello or hello\!
The “” characters are treated as an EXACT MATCH search operand. For example, searching
for hello world will result with all entries that include the exact hello world phrase in one of the
searchable entry attributes.
Kaltura Management Console (KMC) User Manual
80
Locating Content in the KMC
To search through entries
Go to the Content tab and select the Entries tab.
Enter your search criteria and click the magnifying icon on the right, or press Enter.
The search is applied on the entry or the entry attributes selected.
You can search for content and then create playlists containing the filtered content.
To create playlists based on filtered content
Search for content based on a filter.
Click Add Playlist to create a playlist.
To clear the search box
Click the X icon on the right.
Filtering Content in the Entries Table
The list of entries can be filtered according to the parameters that are specified in the filter bars on the left
side of the page. You can filter entries using the search criteria, specific categories, Additional Filters, or
custom metadata based filters
NOTE: You can sort the Entries Table by clicking on the various columns or using the
scroll bar. You can also select how many items to display per page (10 to 500).
Using Categories as Filters
You can filter the entries in the Entries Table by selecting specific categories in the categories filter bar on
the left side of the page.
You can open the Categories Filter Preferences from the preferences icon at the top right corner of the
categories filter area. Your preferences will impact the behavior of the category filter.
You can navigate within the categories tree to select the categories you want to filter entries by. Each
category selection refreshes the Entries Table.
You may also use the Search Categories field to search for categories you want to filter by, instead of
Kaltura Management Console (KMC) User Manual
81
Locating Content in the KMC
navigating to these categories from the categories tree.
NOTE: When a category has more than 1000 sub categories, the category cannot be
expanded in the category tree. Use the Search categories option.
Using Additional Filters
To use additional filters
Click "Additional Filters" to open more filter options, including:
o
Between any two specific dates
o
By media type (Audio, Video, Image, Video Mix, Live Stream)
o
By Ingestion Status (Ready, No Media, Pending, Uploading, Transcoding, Error)
o
By duration — Short clips (up to 4 minutes), Medium clips (4 to 20 minutes), Long clips (more
than 20 minutes)
o
By Original or Clipped entries – original media, entries created by clipping
o
By Scheduling status (Past, Live now, Scheduled to go live at a later date, Scheduled
between specified dates)
o
By moderation status
o
By Media Replacement Status
Kaltura Management Console (KMC) User Manual
82
Locating Content in the KMC
o
By Access Control Profile (See Access Control Profiles for more details.)
o
By video quality (Transcoding Flavor)
o
By Distribution Destination (See Distribution and Syndication for more details.)
You can filter content using a single or multiple criteria.
Performing a Search Based on Metadata Fields
You can use custom fields to search for content and create playlists. To search textual fields, use the
search box, for canned lists use the custom Metadata Filters. See Searching Playlists.
Footnote
Label
Specification
1
Search text
Search text to apply to all textual custom data, for
example teaser title, authors
2
Search filter for Publishing
Status
For publishing status
3
Search filter for Distribution
settings
For content based on distribution channel’s settings
Entries Table Filter Indications
When the Entries table is filtered by categories, filters and/or search criteria, indications for the selected
filters are displayed above the Entries Table. You can remove a filter directly from this display by clicking
on the x on the name of the filter.
Kaltura Management Console (KMC) User Manual
83
Locating Content in the KMC
Searching Through Categories
When managing your categories, the search box in the Categories page enables you to search for
specific categories or category attributes that exist in your account.
Category Search Rules
When searching for categories from the KMC search box in the Categories page the following rules apply:
The Kaltura search engine will match the search term within the KMC search box against the
following category attributes:
Category Name, Category ID, Category Tags, Category Description, Category Reference ID, any
Category custom data fields of type: text that was set to be searchable.
Search criteria may include alphanumeric as well as the following special characters such as: `,
~, !, @, #, $, %, ^, &, *, (, ), -, _, =, +, [, ], {, }, ;, :, ', \, |, /, ?, <, >
The space character is treated as an AND search operand. For example, searching for hello
world will result with all categories that include both the word hello and the word world in one of
the searchable category attributes.
The comma character is treated as an OR search operand. For example, searching for hello,
world will result with all categories that include either the word hello or the word world in one of
the searchable category attributes.
The ! character is treated as an AND NOT search operand. For example, searching for hello !
world should result with all categories that include the word hello, but do not include the word
world.The ! at the beginning of the search criteria is not supported within this AND NOT operant
context. When searching for actual words that start/end with the ! character, the ! character
should be escapes using a backslash . For example, if you want to search for categories that
include the word !hello or hello! you should enter the following terms within the KMC search box:
\!hello or hello\!
The “” characters are treated as an EXACT MATCH search operand. For example, searching
for "hello world" will result with all categories that include the exact hello world phrase in one of
the searchable category attributes.
To search through categories
Go to the Content tab and select the Categories tab.
Enter your search criteria and click the magnifying icon on the right, or press Enter.
The search is applied on the category or the category attributes selected. For canned lists, use
the Categories Metadata Filters.
Filtering Categories in the Categories Table
When managing categories, the Categories Table can be filtered according to the parameters that are
Kaltura Management Console (KMC) User Manual
84
Locating Content in the KMC
specified in the filter bars on the left side of the page. You can filter categories using the search criteria,
by categories. For listing categories under a specific parent category, use Additional Filters or use the
custom data based filters.
Using Categories as Filters
When managing categories, you can filter the categories in the Categories Table by selecting specific
categories in the categories filter bar on the left side of the page.
You can open the Categories Filter Preferences from the preferences icon at the top right corner of the
categories filter area. Your preferences impact the behavior of the categories filter.
You can navigate within the category tree to select the categories you want to filter the Categories Table
by. Each selected category refreshes the Categories table.
You may also use the Search Categories field to search for categories you want to filter by, instead of
navigating to the categories from the categories tree.
Kaltura Management Console (KMC) User Manual
85
Locating Content in the KMC
NOTE: When a category has more than 200 sub categories it cannot be expanded in the
category tree. Use the Search categories option.
Using Additional Filters
To use additional filters
Click "Additional Filters" to open more filter options, including:
o
Created Between any two specific dates
o
By content privacy options (available with entitlement configuration only)
o
By category listings(available with entitlement configuration only)
o
By contribution policy(available with entitlement configuration only)
o
By the availability of specific end –user permissions(available with entitlement configuration
only)
Categories Table Filter Indications
Kaltura Management Console (KMC) User Manual
86
Locating Content in the KMC
When the Categories table is filtered by categories, metadata filters or search criteria, indications for the
selected filters are displayed above the Categories Table. Click on the X to remove a filter directly from
this display.
Searching Playlists
Use the Filters pane to search for playlists in your account. You can search for any word in the playlist
name, tags or both. You can also filter by date by select a date range or by clicking the calendar icons on
the Created between fields.
Kaltura Management Console (KMC) User Manual
87
Managing Access Control Profiles
CHAPTER 7
Managing Access Control Profiles
This section contains the following topics:
Access Control Profiles
Creating an Access Profile
Assigning an Access Control Profile to an Entry
Content Scheduling
Access Control Profiles
Kaltura supports several publication restrictions allowing limited access to content when business
requirements dictate it. These restrictions can be placed on the entry level but can also be streamlined to
be set automatically or on demand, on a group of items based on a set of criteria, during upload via a bulk
upload CSV file, or during an update transaction using Kaltura’s APIs. See Kaltura API documentation.
An Access Control Profile defines authorized and restricted domains where your content can or cannot be
displayed, countries from which it can or cannot be viewed, white and black lists of IP addresses and
authorized and unauthorized domains in which your media can be embedded. Use the Access Control
tab to view existing profiles and create new ones.
Controlled access provides authentication and authorization capabilities. Developer authentication is
done using a combination of the Partner ID and one of two “secrets”, each providing a different set of
authorization capabilities. In return, a Kaltura Session token (“KS”) is generated, through which API calls
can be made.
You can segregate your content based on your various user groups and audiences. You can create
content channels to be accessed only by certain users, and allow other content items to be available to
all. Access profiles also allow you to manage groups and users on your own identity.
To view Access Control settings
Select the Settings tab and then select the Access Control tab.
The Access Control Profiles window is displayed. A default access control profile that permits
access to all is configured automatically.
Kaltura Management Console (KMC) User Manual
88
Managing Access Control Profiles
Creating an Access Profile
To create an access control profile
Select the Settings tab and then select the Access Control tab.
The Access Control Profiles window is displayed.
Click Add Profile.
The New Access Control Profile window is displayed.
Kaltura Management Console (KMC) User Manual
89
Managing Access Control Profiles
Enter an informative Profile Name and Description for the profile.
Configure the Authorized Domains. See Restricting Domains.
Configure the Authorized Countries. See Restricting Countries for Viewing.
Configure the Authorized IP Addresses. See Restricting Views by IP Address.
Configure the Authorized Flavors. See Restricting Access for Specific Flavors.
Configure the Advanced Security. See Restricting Views with a Server Side Secret
Click Create New.
Editing an Access Profile
To edit an access control profile
Select the Settings tab and then select the Access Control tab.
The Access Control Profiles window is displayed.
Select the access profile you want to edit.
The Edit Access Control Profile window is displayed.
Modify the profile according to the sections described in Creating an Access Profile.
Kaltura Management Console (KMC) User Manual
90
Managing Access Control Profiles
Restricting Domains
Kaltura’s Access Control mechanism provides the means to restrict content playback from specific
domains. This is useful to prevent scraping of content from your website or re-sharing of content on other
sites that are not yours.
Domain restrictions allow you to define a “white list” of domains that allow only playback attempts of
content placed on these domains to be granted. Any playback attempt via the Kaltura Dynamic Player
placed on a domain not on this list will be denied. In the same manner a “black list” can be defined
performing the opposite constraint. Any playback attempt from these domains will be denied. You can
create a combination of both “white listed” and “black listed” domains.
To restrict content to specific domains.
In the Authorized Domains section, select one of the following options:
Toggle All Domains – content will display in all domains.
Toggle Only in the following domains - enter a site or list of approved sites that are allowed to
display Kaltura content. See Add or Remove a Domain.
Toggle Block from the following domains - enter a domain or list of approved of domains that are
not allowed to display Kaltura content. See Add or Remove a Domain.
Adding or Removing a Domain
To add a domain
In the Authorized Domains section, select one of the following options:
Click + Add another domain.
Enter the domain name in the format of company.com
To remove a domain
Select a domain from the listed domains.
Click the - Remove selected domains.
Kaltura Management Console (KMC) User Manual
91
Managing Access Control Profiles
Click Yes.
Restricting Countries for Viewing
Geographic restrictions, similar to domain restrictions, allow you to define a “white list” or a “black list” of
specific geographical locations, limiting or enabling playback attempts of content for users located in
these locations. For example, a Kaltura Player entry assigned with geo-restrictions where the white list
contains only Spain can be placed on any domain but will only be playable by viewers located in Spain.
To restrict content to specific countries
In the New/Edit Access Control Profile window, scroll down to the Authorized Countries section.
Select one of the following options:
Toggle Anywhere– content will be displayed in all countries.
Toggle Only from the following countries- select a country or list of approved countries that will
display content. See Add or Remove Geographic Regions (Countries) .
Toggle Block from the following Countries - enter a country or list of approved of countries to
exclude. See Add or Remove Geographic Regions (Countries).
Adding or Removing Geographic Regions (Countries)
To add a geographic region
Click + Add Remove Countries.
Kaltura Management Console (KMC) User Manual
92
Managing Access Control Profiles
Use the scroll (Ctrl button for multiple selections) and select the countries from the Countries List.
Use the arrow buttons to transfer the selected countries to the Allowed Countries.
Click Save.
To remove a geographic region
Click+ Add Remove Countries.
Use the scroll (Ctrl button for multiple selections) and select the countries from the Restricted
Countries.
Use the arrow buttons to transfer the selected countries to the Allowed Countries.
Click Save.
Restricting Views by IP Address
You can restrict content view by IP addresses or ranges and determine which IP ranges will be allowed to
view the content.
To restrict Views by IP Address
In the New/Edit Access Control Profile window, scroll down to the Authorized IPs section. Select
one of the following options:
Toggle All IPs – content will be displayed for all IP addresses.
Toggle Only from the following IPs- select a range of approved IPs that will display content. See
Add or Remove IP Addresses.
Toggle Block from the following IPs- enter a range of approved IPs that should be excluded from
content viewing. See Add or Remove IP Addresses.
Adding or Removing IP Addresses
Kaltura Management Console (KMC) User Manual
93
Managing Access Control Profiles
To add or block IP addresses
Click + Add Another IP.
Use the notation indicated to enter IP addresses.
Click Save.
To remove IP addresses
Highlight the IPs you want to remove from the restricted list.
Click +Remove Selected IPs.
A warning message is displayed.
Click Yes.
Restricting Access for Specific Flavors
You can restrict content view by flavors and determine which flavors will be allowed for playback and
download authorization and for DRM licensing authorization when applicable. The access control flavor
authorization enables you to define restriction rules that are enforced by the Kaltura server, adding a
stronger level of security to player tag based flavor controls.
To restrict access for specific flavors
In the New/Edit Access Control Profile window, scroll down to the Authorized Flavors section.
Select one of the following options:
All Flavors – content will not be restricted by access control for any flavors
Toggle Only flavors defined in the following list - select the approved flavors that will display
content. See Adding or Removing Flavors.
Toggle Block flavors defined in the following list - select a the approved flavors that should be
excluded from content viewing. See Adding or Removing Flavors. .
Kaltura Management Console (KMC) User Manual
94
Managing Access Control Profiles
Adding or Removing Flavors
To add flavors
Click + Add/-Remove flavors.
The list of available flavors is displayed,
Kaltura Management Console (KMC) User Manual
95
Managing Access Control Profiles
Use the arrows to move the relevant flavors to the Allowed Flavors section.
Click Save.
To remove flavors
Highlight the flavors you want to remove from the restricted list.
Click +Remove.
Click Save.
Restricting Views with a Kaltura Session
Often, the user authentication/entitlement mechanism that decides whether a user is entitled to access a
specific media entry or not, will reside outside of Kaltura. When the authentication mechanism resides
outside Kaltura, we recommend that you use an Advanced Kaltura Session (KS) based Access Control
mechanism, that permits access to the media only when a valid Kaltura Session is provided. .The
external entitlement mechanism will then generate the valid Kaltura Session when users should be
permitted to view the content.
The session is created using a secret. The external entitlement mechanism will then generate the valid
KS when users should be permitted to view the content. Common examples include When implementing paid content where the payment gateway is not Kaltura, the server processing the
payment will be the mechanism deciding on entitlement. After the payment is processed, the payment
server creates a valid Kaltura Session by calling the Kaltura API and passes that KS to the Kaltura player.
When implementing a single-sign-on and permissions mechanism using LDAP or other authentication
mechanism outside of Kaltura, the server responsible for user authentication contains the entitlement
logic. The authentication server will call the Kaltura API and generate a valid KS when appropriate.
A Kaltura Player marked with tokenized access requires a “session token” to be created and provided
during every playback. A session token can only be created by a developer possessing valid credentials
and expires after a limited amount of time. Thus, even if an attempt to grab the item’s direct URL is
successful, the playback session will soon expire and without possession of the valid credentials,
regeneration of a new token will not be possible.
This option is useful to prevent scraping of content from your website or re-sharing of content on other
sites that are not yours and provides an additional amount of security to content display.
Pay-Per-View
You can enable paid programming with a video preview, and easy, on-the-fly payment options for full
video access.
Kaltura Management Console (KMC) User Manual
96
Managing Access Control Profiles
To create a Kaltura Session restriction to view content
Check Secure viewing of this video with Kaltura Session (KS).
To enable a free preview
Check Free Preview.
Enter the amount of time in seconds for the free preview display.
Assigning an Access Control Profile to an Entry
You can assign an Access Control Profile to an entry.
To assign an access control profile to an entry
Go to Content tab and select the Entries tab.
Click on the entry to which you want to assign an Access Control Profile.
Go to the Access Control tab and select an existing profile from the drop-down menu.
Click Save & Close to complete the process.
Assigning an Access Profile to a Bulk Upload
A default access profile is included with the KMC. After you create an Access Profile, an ID is created and
listed in the Access Control page.
To assign an access profile to a bulk upload
Set the ID from the Access Control List to the accessControlProfileId in your CSV
Set the profile ID from the Access Control List to the accessControlId in your XML file.
Content Scheduling
Content Scheduling determines when your media entries will be permitted for viewing (“sunrise”) and
Kaltura Management Console (KMC) User Manual
97
Managing Access Control Profiles
when access should be automatically discontinued (“sunset”). You can set specific scheduling
parameters for your content. You can set the entry to be available for display at any time (for example, no
schedule limitations) or you can set the entry to be available during a limited timeframe (for example,
display this video starting on X date with no end time, or display this video only between X date and Y
date). Note that when users try to access a video that is no longer valid (in terms of its scheduling), they
will receive an error message explaining that this content is no longer valid.
To configure content scheduling
Go to Content tab and select the Entries tab.
Click on an entry.
Select the Scheduling tab and select and set your specific time range.
Click Save & Close to complete the process.
Kaltura Management Console (KMC) User Manual
98
Managing Content Entitlement
CHAPTER 8
Managing Content Entitlement
Kaltura provides a built-in infrastructure for controlling and managing end-user entitlements to content.
This infrastructure includes the required attributes and permission controls as well as the server utilities
for enforcing those controls.
Using Kaltura’s entitlement services, end-user facing applications such as Kaltura MediaSpace can be
extended to add the following capabilities:
Groups’ media channels - Provides the ability to set media channels that limit access and
contribution of content to members of a specific group of users.
Granular control over user permissions to content - Provides the ability to define different
privacy and permission levels for accessing and managing content in media channels.
Personalized global search engine - Provides the ability for users to easily search and find
relevant content from the entire set of media they are entitled to access.
Kaltura’s Entitlement Model
Kaltura’s entitlement model relies on the extension of Kaltura’s categories. Categories may hold
entitlement settings as well as specific end-user permissions. These entitlement settings and end-user
permissions are inherited by media entries associated with these types of categories.
The entitlement model provides a direct association between end-users and the collection of media items
they are entitled to access, and enables a simple and efficient way to add entitlement controls to both flat
and hierarchal application/website navigation layout.
Category’s Entitlements Tab
Entitlement settings may be set on categories in different ways, for example, from the application, via the
CSV or through a Kaltura API. The Category’s Entitlements tab in the KMC is where content entitlement
settings are managed by account administrators. The Entitlements tab only appears in KMC accounts
that are set with the entitlement feature and in categories that were set to have entitlement settings for an
application.
NOTE: The Entitlement Settings are added to categories as part of the MediaSpace
installation. For other purposes entitlement settings can be added to categories from the
Integration Settings page under the Settings tab. See Adding Entitlements to Categories
for more information.
The following sections describe the different setting options available in the Entitlements tab and their
impact on end-user entitlements in applications such as MediaSpace.
Kaltura Management Console (KMC) User Manual
99
Managing Content Entitlement
Workflow:
Create a category. See Adding/Editing a Specific Category. Add Entitlements to
categories. See Adding Entitlement to Categories
Go to the Content tab and select the Categories tab.
Click on a category or select Edit from the Actions drop down menu.
Select the Entitlements tab.
Set the Entitlement Settings.
Setting the Entitlement Settings
Perform the tasks in the workflow to configure the KMC with Entitlement Settings.
To set Entitlement Settings
Set the Content Privacy. See Content Privacy.
Select the Category Listing.
Select the Contribution Policy.
Select whether to inherit specific end-user permissions.
Set Specific End User Permissions.
a. Change Owner.
b. Click Manage to manage end-user permissions.
c. Configure Additional Category Entitlement Settings.
Click Save & Close.
Kaltura Management Console (KMC) User Manual
100
Managing Content Entitlement
Content Privacy
The content privacy defines the visibility of content associated with a category, including its related
metadata. The Content Privacy setting is applied to:
Who has access to content published in channel pages
Which content will be available to the user in the application global search results
Who can access to a single media item in the application.
The Content Privacy options are:
No Restriction – Content in the category is visible to everyone with access to the application
page it is published in. In MediaSpace - this option is mostly relevant for setting Media Galleries
that are open on the web and can be accessible by everyone, including anonymous viewers.
Requires Authentication – Content in the category is visible only to authenticated end-users –
In MediaSpace this option is mostly relevant for setting Media Galleries or Open/Restricted
Media Channels that are available to all authenticated users (users of the company/Institution,
customers with login etc.) User authentication is made by MediaSpace against the customer
Identity Management system, or with using Kaltura’s authentication services. In both cases, the
authenticated user ID is then passed to the Kaltura server through the application session.
Private – Content in this category is visible only to users with specific permission to access this
category's content and to the owner of the content. In MediaSpace this option is mostly relevant
for setting Private Media Channels - available only to a group of users.
Note: With any content privacy option the owner of the content is entitled to access and manage
his content
Kaltura Management Console (KMC) User Manual
101
Managing Content Entitlement
Visibility of Content Associated with Multiple Categories
For content associated with more than one category, the privacy and visibility of this content via global
search or a direct link to the video page, is determined based on the category with the lowest restriction
level the content is associated with (within the application category tree).
Examples
In a MediaSpace based media portal:
A video that is published in a few private channels but also in at least one public gallery (Content
Privacy = No Restriction) will be visible to everyone with access to the portal. Access to this
video in this case is available to all from the public gallery page itself, via the portal’s Global
Search or via a direct link to the MediaSpace page of this video.
A video that is published in a few private channels but also in at least one organizational shared
gallery (Content Privacy = Requires Authentication), will be visible to all members of the
organization (following login to the portal) from the organizational shared gallery page itself, but
also via the portal’s Global Search or via a direct link to the MediaSpace page of this video. This
content will not be available to anonymous viewers with a direct link to the MediaSpace page of
this video - a login page will be prompted in this case.
A video that is published in a few private channels but is also set in Kaltura categories managed
in the KMC account that are not integrated with the media portal (for example, categories
integrated with Kaltura extensions to CMS/LMS, categories set by the account KMC
administrator for different purposes, etc.). Access to the video via the Media Portal is determined
only by the entitlements settings of the categories the Media Portal is integrated with. This is
controlled by the application specific “privacy content” label set to these categories.
A video that uploaded by an end-user but was not published in any gallery or channel in
MediaSpace (private media), could only be accessed by the content owner.
Visibility of Content in Outside of the Application
When the entitlement feature is enabled for the account, an internal enforcement level is also set and
managed by Kaltura.
The options for entitlement enforcement are:
Entitlement enforcement is enabled by default.
When entitlement enforcement is enabled for the account - access to content under categories
with entitlement is only possible via applications that implement entitlement and are integrated
with these categories. This is the recommended setting in MediaSpace accounts for the highest
level of content security.
Note: that embed codes that are grabbed by authorized users from within the MediaSpace
application are bypassing the entitlement enforcement for the specific entry. Thus the entry will
become publically available within the grabbed player outside of MediaSpace.
Entitlement enforcement is disabled by default and enabled by the application.
When entitlement enforcement is disabled for account - access to content under categories with
entitlement is possible via any application, including player embed codes that are grabbed from
the KMC. With this option the application itself activate the entitlement enforcement so
entitlement rules are kept within the application but all content in categories the application is
integrated with can be accessed via other applications as well. This is the default setting for
Kaltura trial accounts.
Contact Kaltura to change the entitlement enforcement level for your account.
Kaltura Management Console (KMC) User Manual
102
Managing Content Entitlement
Category Listing
The Category Listing option defines who can see the category's name and metadata in MediaSpace. The
Category Listing options are:
No Restriction - With this option, the category name and metadata is visible to everyone with
access to the application page it is listed in. In MediaSpace - this option is used for having
MediaSpace Galleries always listed in the top menus and side navigation layout and for having
MediaSpace open or restricted channels included in the Channels listing page.
Private – With this option, the category name and metadata are visible only to users with
permission to access the category and its content. In MediaSpace this option is used for having
private channels visible only to group members.
Contribution Policy
The contribution policy option defines which end-users can add content to this category through
applications. The applicative permission to publish in MediaSpace’s shared Galleries is set from the
MediaSpace Application Role of the user. See the Kaltura MediaSpace Setup Guide for more information.
The category contribution policy adds the ability to have this type of authorization for publishing content in
specific galleries/channels.
The Category Contribution Policy options are:
No Restriction – With this option, any end-user authorized to publish content in MediaSpace can
publish content in the gallery/channel associated with this category. In MediaSpace this option is
used in shared galleries to which every user with a MediaSpace Admin Application Role can add
content to, and in Open Channels to which all MediaSpace users with content can add their
content to.
Private - With this option, only end-users with specific permission to add content to this category
are able to add content to it. In MediaSpace this option is used in Restricted/Private Channels.
Specific End-User Permissions
When any one of the Category Entitlement Options is set to Private, the respective access level is based
on specific end-user permissions. User permissions to a category and content associated with it are set
through 4 permission levels: Member, Contributor, Moderator, and Manager. The basic access
permissions listed below are enforced by the Kaltura server. In MediaSpace the permission levels are
used to control the availability of the relevant UI controls and user flows, for example, Channel Settings,
Channel’s moderation panel, Publish Module and others.
Kaltura Management Console (KMC) User Manual
103
Managing Content Entitlement
Permissions
Permission
View
Content
and
Category
Add
Remove
Content to
Category
Approve
Content
added to the
category
Levels
Member
X
Contributor
X
X
Moderator
X
X
X
Manager
X
X
X
Edit
Category’s
settings,
privacy
options and
user
permissions
Remove
Category
X
X
The settings of end-user permissions can be made from the KMC, in Bulk Process via a CSV formatted
schema, or via Kaltura APIs.
In MediaSpace: Channel Managers are able to set their channel’s groups members and may assign
different permission levels to members of their group.
Note: the content owner has always full access and editing permissions to his own content. He is also
able to remove his content from any category, regardless of the category’s settings.
Tip: the category end-user permissions may also be used by applications when the category is not set as
private – for granting category specific applicative permissions to specific users. In MediaSpace: users
that is not set to with an Admin Application Role can still be granted with permission to publish content in
specific galleries. In this case the category’s contribution policy is set to No Restriction while ability to
publish content in the respective gallery is granted by the application to all MediaSpace Admin users, but
also to a few specific users that are set as contributors in the category.
End-User Permission Attributes
Status – indication to the state of the user permission set to the category. This attribute may be
used for supporting different applicative flows.
o
Active – Access permission is active and enforced
o
Deactivated – Access permission is not active anymore. (can be activated again)
Update Method - indication on how a specific end-user permission is updated, this may be used
for supporting automatic processes for setting permissions to channels from groups managed in
on organizational information systems, while being able to set manual overrides to specific enduser permissions.
o
Automatic - user permission is updated via an automatic process (either via a CSV
formatted schema or an API based integration). User permission level may be updated by the
automatic process.
o
Manual – user permission is updated manually only and will not be updated by an automatic
process.
Managing Categories’ Specific End-User Permissions
Kaltura Management Console (KMC) User Manual
104
Managing Content Entitlement
To manage categories specific end-user permissions
Set the Entitlement Settings.
The Specific End-User Permissions window is displayed.
Click Add Users.
Select the Permission Level. See Specific End-Users Permissions.
Select the Update Method. See End User Permission Attributes.
Select End Users. Enter user names.
Click Save & Close.
Kaltura Management Console (KMC) User Manual
105
Managing Content Entitlement
Bulk Actions for Managing Categories Specific End-User
Permissions
To perform bulk actions on specific end-user permissions
Check the box or multiple boxes next to the user name and select Bulk Actions on the bottom of
the page.
Select one of the following options
o
Deactivate – deactivates the specific end user permissions for the category
o
Activate – activates the specific end user permissions for the category
o
Set permission levels- overrides the permission level of all selected end-users
o
Set to manual update method. See End-User Permission Attributes.
o
Set to automatic update method. See End-User Permission Attributes.
o
Delete- deletes specific end-user permission for the category.
Click Close.
Additional Category Entitlement Settings
The following additional settings are available at the lower part of the Entitlements tab:
Category Owner – a category attribute, for setting one of the channel managers as the channel
owner for any applicative need. The category owner is automatically set with a manager
Kaltura Management Console (KMC) User Manual
106
Managing Content Entitlement
permission level for the category. See Change Owner.
Default Permission Level – a category attribute for setting a specific default permission level to
the category, for supporting different applicative flows.
Moderate Content - a category attribute, for supporting the moderation of content prior it’s
publishing in the channel. (Moderation is configured through MediaSpace.)
Kaltura Management Console (KMC) User Manual
107
Managing Categories
CHAPTER 9
Managing Categories
Media entries may be divided into categories. The different categories are built in a tree-like hierarchy
where each category can include multiple sub-categories.
Categories provide a logical structure for your site and assist with content management. You can use
categories, along with metadata and filters to create manually or dynamically generated
playlists. Categories may also be used for setting content entitlements to end-users in various
applications. See Entitlement Settings.
Defining and Assigning Entry Categories
Categories are built in a tree-like hierarchy where each category can include multiple sub-categories. You
can add, remove and edit categories from the Categories Tab. You can assign a media entry to a specific
category from the Entries Tab.
To assign an entry to a specific category
Go to the Content tab and select the Entries tab.
Click on the Entry.
Enter the Category in the Metadata tab.
Click Save and Close.
To remove an entry from a category
Go to the Content tab and select the Entries tab.
Click on the Entry.
Remove the category settings in the Metadata tab.
Click Save.
NOTE: When you click Delete in the Entries table, the entry will be deleted from the
account and not only from the category that is currently selected. See Delete Entry.
Categories Table
The Categories Table lists the categories in your account and provides a way to edit the category’s
specific metadata and entitlement settings. You can edit each a specific category from the Edit Category
window or apply actions on several categories simultaneously from the Bulk Actions Menu.
Adding/Editing a Specific Category
To add a category
Select the Content tab and then select the Categories tab.
Kaltura Management Console (KMC) User Manual
108
Managing Categories
Select Add Category.
The New Category window is displayed.
Select No Parent if you want the category to be at the top level or select the parent category
under which the new category should be created and select Next. We recommend that you
minimize categories at the top level. The New Category window is displayed.
Kaltura Management Console (KMC) User Manual
109
Managing Categories
Add metadata and click Save & Close.
Adding Metadata to a Category
You can add or edit metadata to a category or to multiple categories.
To add/edit metadata to a category
Select the Content tab and then select the Categories tab.
Click on a category. Edit Category window is displayed.
In the Metadata tab, add or edit the metadata information. Enter a
a. Name
b. Description (Optional).
c. Tags.(Optional)
d. Reference ID (Optional).
Kaltura Management Console (KMC) User Manual
110
Managing Categories
If you have Custom Data for categories, you can edit the Custom Data fields for the category. For
multiple schemas, use the drop down Jump To menu to select the schema values you want to
edit for the category. See Managing Schemas for more information.
Click Save & Close.
Editing the Entitlement Settings of a Category
When a category is set to have entitlement settings for an application, the category’s Entitlements tab is
displayed for editing. See Managing Content Entitlement for more information.
NOTE: Entitlement Settings are added to categories as part of the MediaSpace installation. For
other purposes, Entitlement Settings can be added to categories from the Integration Settings
page under the Settings tab.
To edit Entitlement Settings of a category
Select the Content tab and then select the Categories tab.
Click on a category. The Edit Category window is displayed.
In the Entitlements tab, edit the Entitlement Settings options, set a category owner and any
specific end-user permissions you want to set to the category for your application. Informative
tooltips are available for each one of the options. See Managing Content Entitlement for more
information.
Click Save & Close.
Kaltura Management Console (KMC) User Manual
111
Managing Categories
Reordering Sub Categories
When a category has up to 50 sub-categories the Sub-Categories tab is available for editing. Use the Sub
Categories tab to order the sub categories. Sub Categories will appear in the application as they are
ordered.
Use the Sub- Categories tab to order MediaSpace Galleries. For other applications: the ordering set
through the Sub- Categories tab can be used through the Kaltura API while ordering category lists based
on the partnerSortValue category attribute.
To reorder sub categories
Select the Content tab and then select the Categories tab.
Click on a category. The Edit Category window is displayed.
Select the Sub-Categories Tab,
Set the order of the sub-categories. Position the sub categories as you want them to be ordered
in your application.
Click Save & Close.
Kaltura Management Console (KMC) User Manual
112
Managing Categories
Editing Multiple Categories in Bulk
You can edit multiple categories in bulk.
To edit multiple categories in bulk
Select the Content tab and then select the Categories tab.
Check the boxes near the names of the categories you want to edit.
Select Bulk Actions at bottom of the list.
Kaltura Management Console (KMC) User Manual
113
Managing Categories
Use the Categories tab to:
Add Tags
Remove Tags
Move Categories
Change Content Privacy (available with entitlement configuration only
Change Category Listing (available with entitlement configuration only)
Change Contribution Policy(available with entitlement configuration only)
Change Category Owner (available with entitlement configuration only)
Delete Categories
Add Tags to Categories
You can add tags to categories in the KMC that will propagate to other applications.
To add tags to a category listing
Select the Content tab and then select the Categories tab.
Select a category or multiple categories and select Bulk Actions on the bottom of the page.
Select Add Tags from the drop-down menu.
Enter tags to append to all selected categories.
Click Save Changes.
Kaltura Management Console (KMC) User Manual
114
Managing Categories
Remove Tags from Categories
You can remove tags from categories in the KMC. Tag deletion will propagate to other applications.
To remove tags from a category listing
Select the Content tab and then select the Categories tab.
Select a category or multiple categories and select Bulk Actions on the bottom of the page.
Select Remove Tags from the drop-down menu.
Select the tags to remove from the selected categories.
Click Remove.
Move Categories
You can move categories from one level to another.
To move a category to another parent category
Select the Content tab and then select the Categories tab.
Select a category or multiple categories that area currently under the same parent category and
select Bulk Actions on the bottom of the page.
Select Move Categories from the Bulk Actions options.
Select the new parent category under which the selected categories will appear.
Click Apply.
Kaltura Management Console (KMC) User Manual
115
Managing Categories
Following a Move Categories action, the category tree is updated on the Kaltura backend. When more
than a few categories are affected, this operation may take a few minutes. Until the completion of this
process, the editing options in the Categories page are disabled and are automatically released when the
update process is completed.
Change Content Privacy
Content privacy is a category entitlement setting option that defines the visibility of content associated
with a category. For more information see Content Privacy.
This option is available with entitlement configuration only.
To change the content privacy
Select the Content tab and then select the Categories tab.
Select a category or multiple categories.
Select Bulk Actions on the bottom of the page and then select Change Content Privacy from the
drop-down menu. The content privacy options are:
No Restriction – Content in this category is visible to everyone with access to the application
page it is published in.
Requires Authentication – Content in this category is visible only to authenticated end-users.
User authentication is made by the application against the customer Identity Management
system, or using Kaltura’s authentication services. In both cases access to content in this
category requires that an authenticated user ID is passed to the Kaltura server through the
application session.
Private – Content in this category is visible only to users with specific permission to access this
category's content.
Click Apply.
Kaltura Management Console (KMC) User Manual
116
Managing Categories
Note that the Changing the Content Privacy will only apply to categories that have entitlement settings.
Change Contribution Policy
The contribution policy is a category entitlement setting option that defines which end-users can add
content to a category through applications. For more information see Change Contribution Policy. This
option is available with entitlement configuration only.
To change the contribution policy
Select the Content tab and then select the Categories tab.
Select a category or multiple categories and select Bulk Actions on the bottom of the page.
Select Change Contribution Policy from the drop-down menu.
Select one of the following options:
No Restriction – With this option, any end-user authorized by the application can add content to
this category
Private - With this option, only end-users with specific permission to add content to this category
are able to add content to it.
Click Apply.
Note that the Change Category Contribution Policy action will only apply on categories that have
entitlement settings.
Kaltura Management Console (KMC) User Manual
117
Managing Categories
Change Category Listing
The category listing is a category entitlement setting option that defines who can see the category's name
and metadata in the application’s category menus, navigations and listing or anywhere a category list is
present. See Category Listing for more information.
This option is available with entitlement configuration only.
To change a category listing
Select the Content tab and then select the Categories tab.
Click on a category. The Edit Category window is displayed.
Select a category or multiple categories and select Bulk Actions on the bottom of the page.
Select Change Category Listing from the drop-down menu.
Select one of the following options:
No Restriction - The category name and metadata is visible to everyone with access to the
application page it is listed in.
Private – The category name and metadata are visible only to users with permission to access
the category and its content.
Click Apply.
Note that the Change Category Listing action will only apply on categories that have entitlement settings.
Change Category Owner
The Category Owner is a category entitlement option supporting applicative case in which an end-user
should be set as the owner of the category. This will automatically set the user with a manager
permission level for this category and enable the user to manage the category settings from the
application.
This option is available with entitlement configuration only.
To change the ownership on a category listing
Select the Content tab and then select the Categories tab.
Select a category or multiple categories and select Bulk Actions on the bottom of the page.
Select Change Category Owner from the drop-down menu.
Enter the new owner’s User Name or User ID.
Kaltura Management Console (KMC) User Manual
118
Managing Categories
When the selected user is already listed in Kaltura, the user’s ID or name appears in blue. When
the selected user is not listed in Kaltura the typed text appears in red shape. .After saving, the
user is added to Kaltura as the user ID.
Click Save.
Delete Categories
You can delete categories in the KMC. Category deletion is propagated to other applications.
When categories are deleted from the KMC, the entries in these categories are automatically added to
the parent of the deleted category.
To delete categories
Select the Content tab and then select the Categories tab.
Select a category or multiple categories and select Bulk Actions on the bottom of the page.
Select Delete from the drop-down menu.
Select the categories to remove.
A warning message is displayed.
Click Remove.
Updating Categories’ State
Some of the category related actions taken in the KMC may trigger a category update process on the
Kaltura backend. This is mainly to allow continuous work through the KMC interface even when actions
affect large portions of the category tree or apply on a very high number of categories.
Kaltura Management Console (KMC) User Manual
119
Managing Categories
While the Kaltura backend process is running, an ‘Updating Categories’ indication is set on the top right
corner of the categories filter bar.
The ‘Updating Categories’ state may last a few minutes and until its completion. Some category settings
and tree displays in the KMC may not be fully updated.
After the updating process is completed the ‘Updating Categories’ indication automatically disappears.
Kaltura Management Console (KMC) User Manual
120
KMC Users and Roles
CHAPTER 10
KMC Users and Roles
This section contains the following topic:
Roles and Permissions
Roles and Permissions
Roles and permissions enable organizations to define a user's ability to perform actions based on the
user's responsibilities. Only users with admin permissions can add users, create roles and define
permissions.
A publisher uses the roles and permissions infrastructure to specify actions that a user is allowed to
perform. User roles define permissions granted to the user for the different KMC functionalities.
KMC user permissions depend on account permissions for specific features.
The following is high level description of each default role.
Publisher Administrator - has permission to all KMC options enabled for the account.
Manager - has permissions to all KMC options enabled for the account - excluding access to
Administration tab (KMC user and role management) and excluding permissions to modify account
settings and account integration settings.
Content Uploader - has permission to upload files from desktop or via bulk upload csv/xml - has a viewonly access to entries and categories under the content tab.
Content Moderator - has permission to Moderation tab only and ability to approve/reject entries.
Player Designer - has permission to Studio tab only and ability to set all player options excluding
advertisement.
Adding a User
The following table lists the information that should be provided for adding a new KMC admin user.
Please note that a limited number of users are allocated by default to each KMC account. If you reached
the KMC users quota for your account and need to set additional users, please contact Kaltura with
a request for additional KMC admin users.
Field
Description
Email address
The user’s email address serves as a unique identifier of the user in
the Kaltura system, as the user login username and as a recipient
address for system-generated messages. Upon the creation of a new
user account, a welcome email notification will be sent to this email
address with a link for setting the initial password.
First name, Last name
User’s name
Publisher ID (Optional)
A unique identifier that may be in use by the publisher in different
systems. This will serve as the KMC user identifier as content
contributor in all KMC-related locations. When a publisher ID is not
Kaltura Management Console (KMC) User Manual
121
KMC Users and Roles
Field
Description
provided, the user email address will be used as a default value.
User Role
Defines the set of permissions granted to the user for the different
KMC functionalities. This role should be set according to the tasks that
the user needs to work on and the functionalities that the user needs
access to within the KMC. The different KMC user roles are set (by
users who are granted with permission to do so) from the KMC Roles
page (under the Administration tab).
To add a user
Go to the Administration tab and select the Users tab.
Click Add User, and fill in the details in the Add User window.
Select a User Role from the drop-down menu.
(Optional) Click Add Role to create a custom role. See Creating Custom Roles.
Click Save.
When a user is created, an email will be sent to the specified email address containing a link to set the
account password.
Editing a User
After a user account is set in the system, the user’s personal details can only be set by the user
personally, from the My User Settings page in the Settings tab. See My User Settings.
To edit user information
Go to the Administration tab and select the Users tab.
Click on a User and then select Edit from the drop down tab.
Only the Publisher User ID and the User Role may be edited in Edit User window. Please note that it is
not possible to edit the user role that is defined as the Account Owner. In addition, a KMC user with
access to user management functionalities cannot edit the user role selection in their account.
Kaltura Management Console (KMC) User Manual
122
KMC Users and Roles
Deleting and Blocking Users
You can prevent users from logging into the KMC temporarily or permanently. Blocking a user will prevent
the user from logging into the KMC. This restriction can be removed by applying the unblock action.
Deleting a user is a permanent action. The deleted user's content contribution records will be kept in the
system.
To block or unblock a user
Select the Administration tab and select the Users tab.
Click on a User Name.
Select Block/Unblock from the Select Action drop-down menu to block a user temporarily.
Select Delete from the Select Action drop-down menu to remove a user permanently.
Purchasing a License for Additional Users
Each KMC account is allocated three users.
To request additional users
Select the Administration tab and then select the Users tab
The Current Status lists the number of KMC users and the number of available users.
Click on the Click here to upgrade your account link.
Creating Custom Roles
When you add a KMC admin user role to a specific publisher account, you should add the relevant set of
permissions in the Add Role window. You can select which KMC functionalities are available to users
Kaltura Management Console (KMC) User Manual
123
KMC Users and Roles
with the defined role. Clicking the checkmark next to each permission group name will toggle the
permission level for the specific KMC functionality to the following modes:
Full Permission (checked) – Grants access to all KMC functionalities listed under the
permission group.
View-Only Permission (partially checked) –Only part of the functionality listed in the group is
selected.
No Permission (unchecked) – No access to the KMC pages that are relevant to the KMC
functionalities listed under the permission group.
To create custom roles
Go to the Administration tab and select the Roles tab.
Click Add Role to create a custom role.
Enter the Role Name and provide a description.
After naming the role and providing a description you will be able to select the specific
permissions required.
Most of the permissions are organized under KMC high-level functionalities. For granular
permissions within each category click Expand All. Or click Advanced to open a more detailed list
of the specific KMC functionalities related to the group.
Click Save.
You can edit, duplicate or delete any existing role via the using the Select action drop-down menu.
Role Management
After you create roles you can:
Edit a role
Duplicate a role.
Delete a role.
Kaltura Management Console (KMC) User Manual
124
KMC Users and Roles
To modify roles
Go to the Administration tab and select the Roles tab.
Click on a role.
Select an option from the Actions menu.
Edit a role
Editing a user role affects the access level of the KMC user associated with this role only after the
user logs in to the KMC. We recommend that you edit an “in-use” role when users associated
with this role are not logged into the KMC.
Duplicate a role
Duplicating a role is a quick way to create a new KMC user role with a similar, but not identical,
set of permissions as an existing user role. The duplicated role is populated with the permission
set of the duplication source role, so minor changes to this permission set can be easily made.
After you duplicate a role, use the Edit option to modify the permissions.
Delete Role
Deleting a role is a permanent action. It is not possible to delete a user role record as long as
KMC admin users are associated with the role. In such cases, make sure to update the relevant
KMC user accounts with another user role before attempting to delete their existing role.
Kaltura Management Console (KMC) User Manual
125
Moderation and Editorial Workflows
CHAPTER 11
Moderation and Editorial Workflows
This section contains the following topics:
Content Moderation Workflows
The Moderation Tab
Content Moderation Workflows
You can review content before it is published to eliminate spam and abusive content in User Generated
Content (UGC) portals. You can also implement complex editorial workflows for your various editorial
team roles.
The Moderation Tab
The Moderation tab located in the Content tab in the KMC, allows publishers to see the moderation
queue, where all entries marked as pending, are waiting to be approved or rejected. Content moderators
can change the moderation status (approve/reject).
This window displays a list of all content that has been flagged as inappropriate by users. By default, the
list is filtered and sorted according to the amount of flags that each entry has received. You can sort the
list by clicking on the various columns and scroll through the pages at the bottom of the list.
To display content for moderation
Select the Content tab and then select the Moderation tab.
Kaltura Management Console (KMC) User Manual
126
Moderation and Editorial Workflows
Click on the name of an entry.
The Edit Entry window is displayed. Similar to the Entries tab, the Filters bar to the left of the
entries table is displayed.
Filter your moderation entry list according to various parameters and search criteria. See Filtering
Content in the Entries Table.
By default, the list is already filtered by content that was flagged for review. To change this, click on the
"Additional Filters" button (see Use Additional Filters).
Previewing Content using the Moderation Tab
To preview content
Select the Content tab and then select the Moderation tab.
Click on the name of an entry.
The entry is displayed in the small player to the right of the list.
Click on the bottom right of the preview pane, "View full details" link for quickly reviewing or
editing the content of an entry.
Rejecting Content Using the Moderation Tab
To reject content (one or more entries)
Select the Content tab and then select the Moderation tab.
Select the relevant entries (for multiple choices, use either the CTRL key or the selection dropdown menu at the bottom of the page) and press the "Reject Selected" button.
You can reject more than one entry at a time, but only for entries appearing on the same page of
the main list.
Approving Content Using the Moderation tab
To approve content (one or more entries)
Select the Content tab and then select the Moderation tab.
Select the relevant entries (for multiple choices, use the CTRL key or use the selection dropdown menu at the bottom of the page) and press the "Approve Selected" button.
You can approve more than one entry at a time, but only for entries appearing on the same page
of the main list.
Banning Users Using the Moderation tab
To ban users
Select the Content tab and then select the Moderation tab.
Click on the "Ban User" link under the preview player. This triggers a notification to be sent to
your website's CMS with a request to ban the specific user that created the selected entry.
Kaltura Management Console (KMC) User Manual
127
Moderation and Editorial Workflows
Kaltura Management Console (KMC) User Manual
128
Using Subtitles and Captions
CHAPTER 12
Using Subtitles and Captions
This section contains the following topics:
Caption File Types
Subtitles and Captions Terminology
Adding Captions to an Entry
Setting Up Captions for Display
Caption File Types
You can upload multiple subtitle and caption files (SRT, DXFP, and XML) and transcripts (TXT), or
reference an external link to a captions file in the KMC. Viewers can then select and toggle between
different language subtitles and captions. Subtitles and captions are fully searchable as a metadata field.
Kaltura’s accessibility player plugin also makes the captions readable via screen readers and therefore
helps organizations adhere to 508 compliancy regulations. Kaltura’s “In Video Search” API allows users
to for a specific phrase within a library of videos and within the search results directs the user to the exact
point in the video where the phrase appears. For more information see Kaltura Demo Apps for Captions.
You can also automate the creation of subtitles and captions, and transcriptions through our partners in
Kaltura Exchange. For instance check out 3Play Media Interactive Transcript / Captioning Plugin.
Searching within Captions
Publishers can use the Kaltura API and code skeleton to search within the captions and point the viewer
directly to the relevant point in time. The search is done across a catalogue of videos, making the
discovery process easy and accessible, especially when searching in a large amount of content.
Contact your account manager to learn more on how to integrate this functionality into your website and
environment.
Subtitles and Captions Terminology
A caption file contains both the text and information about when each line of text should be displayed.
A caption is synonymous with subtitle and is usually displayed at the bottom of the screen.
SRT and DXFP are text file formats that contain captions; including the time each subtitle should be
displayed followed by the text of the subtitle.
If the caption includes non-dialog text, the file is considered a closed caption.
Transcriptions are files that contain text of the video without time stamps.
Captions can either be a form of written translation of a dialog in a foreign language or a written rendering
of the dialog in the same language. Closed captions files contain added information to help viewers who
are deaf and hard-of-hearing to follow the dialog, or people who cannot understand the spoken dialogue
or who have accent recognition problems.
Kaltura Management Console (KMC) User Manual
129
Using Subtitles and Captions
For greater accessibility and compatibility with equipment like screen readers, use Kaltura’s 508
Compliant Player. For more information, see 508-Compliant Video Player .
Adding Captions to an Entry
Adding Captions to an Entry Workflow:
In the Upload tab, upload an entry.
Create a player and add content to the player.
Configure the player’s Subtitles and Transcriptions options.
Select an entry and add captions to the entry.
View the entry with the captions.
You can add multiple captions files to each entry. For example, you can create subtitles captions in
multiple languages and label each language.
To assign a caption file to an entry
Select the Content tab and click on an entry.
Select the Captions tab.
Click Add Another Caption.
Select the Type. Choose SRT or DXFP.
Paste an external URL in the File Location or click Upload File and upload an SRT or DFXP file
from your computer.
Kaltura Management Console (KMC) User Manual
130
Using Subtitles and Captions
Assign a Language to the caption from the drop down menu.
Enter a Label that will appear in the player’s captions drop-down menu. For example: Japanese.
In the Actions column click Set as Default.(optional – use for multiple languages)
Select Add Another Caption to add additional captions files and repeat steps 4 to 7.
Click Save.
Editing a Captions File
After you upload a captions file you can edit the file, remove it, or set it as the default captions file.
To edit a captions file
Select the Content tab and click on an entry.
Select the Captions tab.
In the Actions column, click Download File.
Edit the file and then upload the file again as described in Adding Captions to an Entry.
Select Remove to delete the captions file.
Setting Up Captions for Display
You will need to enable captions in your player or select a player with captions already enabled.
To enable captions for display during playback
Go to the Studio tab, and select Player or Create New Player.
Kaltura Management Console (KMC) User Manual
131
Using Subtitles and Captions
Select a player and select Edit from the drop down menu.
In the Edit Player window, select the Features tab.
Scroll down and select Subtitles and Transcriptions.
Check one of the following:
Subply Component – Uses the PlyMedia solution. For more information, see Plymedia on the
Kaltura Exchange site. Additional transcoding and captioning services can also be used. See the
Kaltura Exchange for more information.
Captions on video - The subtitles/captions will be displayed as an overlay at the bottom of the
video area. You can control the area where the captions will appear on the player.
Captions for accessibility – Creates a dedicated area under the video area to display captions.
Check this option if you intend to use the 508 Player
Audio Description – This option is associated solely with the 508 player. Check this option if
you intend to use audio description track.
.
Click Options to modify the text style and background. See Captions Options.
Click Apply.
Viewing an Entry with Captions in a Player
To view the captions in a player
Select the entry that you added the captions file to.
Click Preview and Embed.
In the Player window select the player to use to display this entry.
Kaltura Management Console (KMC) User Manual
132
Using Subtitles and Captions
Use the URL indicated in the View as a standalone page with this player.
The following is an example of an entry with 2 subtitle files where the default language is English.
Captions Options
The following lists the options you can use to customize your caption file display.
Kaltura Management Console (KMC) User Manual
133
Using Subtitles and Captions
Adding an Audio Description File to an Entry
Adding an Audio Description to an Entry Workflow:
In the Upload tab, upload an entry.
Create a 508 player and add content to the player.
Configure the player’s Subtitles and Transcriptions options.
Select an entry and assign an audio description file to the entry.
.Playback the Audio Track in a 508 Player.
To assign an audio description file to an entry
Select the Content tab and click on an entry.
Add a custom data field. See Adding Custom Data Fields.
Add a text field named “AudioFile”.
Select the Metadata tab.
Enter the value of the URL of the audio file.
Click Save.
Playback the Audio Track in a 508 Player
Kaltura Management Console (KMC) User Manual
134
Using Subtitles and Captions
After you configure the player and upload the audio file you can hear the playback.
To playback the audio file
Select the entry that you added the audio file to.
Click Preview and Embed.
Select the 508 Player.
Click AD to On.
Press Play.
The following is an example of an entry with the Audio Description turned on.
Kaltura Management Console (KMC) User Manual
135
Live Streaming
CHAPTER 13
Live Streaming
This section contains the following topics:
Live Streaming Using the KMC
Workflow for Setting up Live Streaming
Live Streaming Using the KMC
Kaltura’s Live Streaming solution is the easiest and most cost effective way to incorporate live streaming
video into your website or application. Backed by world-class data centers, and fault tolerant software
architecture, Kaltura is able to provide the reliability and capacity necessary to handle encoders that are
supported by Akamai.
You can broadcast live streams through a Content Delivery Network (CDN) such as Akamai, through the
KMC. The encoding software installed (such as FMLE) encodes your real-time camera signal and sends it
out through a secure RTMP connection to the CDN. Then, using a Kaltura Player, you can embed the live
broadcast in your websites. You can set the live stream entry metadata and specify broadcasting settings
in the KMC in the same way VOD content is managed.
By using a CDN for live streaming, you guarantee a better experience for your viewers world-wide.
NOTE: In the Kaltura SaaS Edition, Live Streaming is an additional service. To add Live
Streaming to your account, contact your Account Manager.
In Kaltura Community Edition, Live Streaming requires a Flash Streaming Server software
installed such as Adobe FMS, Red5 and Wowza or alternatively, an Akamai CDN account.
To enable live streaming for your account
Contact us or call +1-800-871-5224
After your account is enabled you can set up Kaltura’s Live Streaming service.
Digital Video Recorder (DVR)
The DVR feature allows you to seek back up to 30 minutes into the stream, when seeking into the video
when you are in DVR mode. Seeking forward is also available. When dragging the scrubber all the way to
the right, the video showing is synced with the live stream.
Workflow for Setting up Live Streaming
This section describes how to set up the KMC, the encoder, and a device for the live streaming service.
Kaltura Management Console (KMC) User Manual
136
Live Streaming
Set up the Hardware and Software.
Create a Live Streaming Entry in the KMC.
Configure the Live Streaming Parameters in the KMC
Set up the Broadcasting Computer.
View the Broadcasting Setup (optional).
Setting up the Hardware and Software
To set up the hardware and software for live streaming
Download the Flash Media Live Encoder (FMLE) from here.
Install the FMLE on your local Windows machine.
NOTE: Be certain that your system has the minimum requirements. See
http://www.adobe.com/products/flashmediaserver/flashmediaencoder/systemreqs/ for details.
Connect your camera to the installed computer.
Creating a Live Streaming Entry in the KMC
To create a live stream entry in the KMC
Login into the KMC and go to the Upload tab.
Select Live Stream Entry.
Kaltura Management Console (KMC) User Manual
137
Live Streaming
The Add New Stream window appears.
Select the Live Stream Type.
The following Live Stream types are available:
Universal Streaming, Flash and Mobile (HDS/HLS) - Supports both flash HDS (Adobe HTTP
Dynamic Streaming) and HLS (Apple HTTP Live Streaming) from a single ingested stream.
Akamai universal live streaming also supports DVR functionality that allows you to seek back in
time within the live stream window. The default DVR window is 30 minutes. Contact Kaltura for
more information.
Kaltura Management Console (KMC) User Manual
138
Live Streaming
Legacy Flash Streaming (RTMP) - Delivers live content as an RTMP stream. RTMP is limited to
only desktop Flash and does not support DVR. We recommend migrating live streams to
“Universal Streaming”.
Manual Live Stream URLs - Allows you to associate custom live end user URLs with a Kaltura
entry. This option is useful if you are using a 3rd party to provision and broadcast a live stream.
Fill in the required values and click Save. The required fields depend on the Live Stream Type
you select. An indication is displayed when required fields are not populated.
The following are the Required / Optional fields for Universal Streaming Flash and Mobile
(HDS / HLS ) and Legacy Flash Streaming only (RTMP)
Field
Description
Name
Required, minimum 5 characters. The name of the stream that will
appear in the KMC entries list.
Description
A description of the stream (Optional).
Primary encoder IP
Required, must match “ip” format (can be IP6) The public address that
will be used for streaming (the computer where the client encoder, for
example Adobe FMLE is installed).
Note: your IP address can be retrieved by browsing from the computer
where the FMLE is installed to http://www.whatismyip.com/ 0.0.0.0
cannot be used as your IP address.
Secondary encoder IP
Required (can be the same as primary). If you are using two encoders
(for redundancy), fill in the secondary encoder IP. If you are using a
single encoder, copy the Primary encoder IP to the Secondary
encoder IP field.
Broadcasting password
(Optional) This password is required in the client encoder (FMLE)
software. If you do not enter a password the system will automatically
create one for you and it will be displayed in the Live Stream tab of the
entry details window under “Broadcasting credentials”.
NOTE: When using Kaltura’s SaaS edition, Kaltura will provision your new Live Stream
with the CDN (for example, Akamai). The CDN will then populate the information about
the new Live Stream to the CDN’s servers. This may incur up to a 20 minute delay, for the
stream to become available for broadcasting. You should always provision your Live
Stream ahead of time, and be certain that you have at least 20 minutes lead time to going
live.
Kaltura's uses Akamai as the default CDN. You can also use a CDN other than Akamai, however,
you will have to provision the stream via the CDN portal, or through technical support, and then
ask Kaltura Support to create a live stream entry pointing to the provisioned stream.
The following are the Required / Optional fields for the Manual Live Stream URLs stream type.
Field
Description
Name
Required, minimum 5 characters. The name of the stream that will
appear in the KMC entries list.
Description
A description of the stream (Optional).
Live Flash HDS stream URL
Required, type URL
Live Mobile HLS stream
Optional type URL.
Kaltura Management Console (KMC) User Manual
139
Live Streaming
URL
Click Create Live Stream. A message is displayed that your live stream has been created
successfully and make take up to 20 minutes to display.
Configure the live stream parameters in the KMC.
Multiple Bitrate Encoding
To maintain the best possible viewing experience and video quality, it is often necessary to stream
different versions of the encoded video to different clients using different devices and over variable
connection speeds.
Multiple Bit Rate (MBR) encoding is designed to adjust to fluctuations in bandwidth while maintaining an
acceptable quality. MBR combines several bit rates into a single encoded file. When the file is accessed,
the player determines the appropriate bit rate based on the available bandwidth, and then retrieves the
encoded file at the optimal bit rate. If the available bandwidth decreases for any reason, a stream at a
lower bit rate can then be served. With a lower bit rate, there is often a decrease in quality. See Video
Delivery Settings for more information.
Configuring the Live Stream Parameters in the KMC
To configure the live stream parameters
Go the Content tab in the KMC.
Click on the Live Stream Entry in the Entries table.
Select the Live Stream tab.
For the Legacy Flash Streaming only (RTMP) option:
a. Enter the bitrate configuration as instructed.
b. Click Save.
Kaltura Management Console (KMC) User Manual
140
Live Streaming
For the Universal Streaming option: in the Live Stream Configuration section enter the following:
o
HLS Stream URL—Enter the hlsStreamUrl
o
Akamai Stream ID – Enter the externalStreamId
o
DVR Status -- dvrStatus on/off Default is off.
o
DVR Window – listed in npt format hh:mm:ss of DVR window
For the Manual Live Stream URL option, the live stream tab within the KMC lists the live stream
URLs that were provided .
o
HDS stream url – {value}
o
HLS stream Url – {value}
Kaltura Management Console (KMC) User Manual
141
Live Streaming
Set the MBR. (Optional)
a. When broadcasting with MBR the player will choose the most appropriate bitrate to
stream. Be certain that your client encoder is aligned with the same settings.
b. Determining the right bit rates for your Live Stream is generally dependent on the quality of
your video, the size of the player your viewers will use, the bandwidth your client encoder
computer has and the bandwidth of your viewers. It is common to have widths of 240, 360,
480, 720 and 1080 with HD content streaming. If you are broadcasting a webcam, it is
generally best to use the default KMC settings. To get professional assistance, please
contact Kaltura’s support.
Click Save.
Setting up the Broadcasting Computer
To set up the broadcasting computer
Connect your camera /recording device to the broadcasting computer.
Run the Adobe Flash Media Live Encoder (FMLE).
Select the relevant recording Device from the drop-down menu. Copy the details of the live entry
to the Flash Media Live Encoder. You can copy the details manually, or use the “Export XML to
FME” option.
a. Enter or copy the Primary URL in the FMS URL field, and the Backup URL in the
Secondary URL as configured in the KMC.
b. Enter the Stream Name as displayed in the KMC.
c. Enter the MBR settings if you have defined them. See Multiple Bitrate Encoding.
d. Use the Preset dropdown menu in the FMLE to select the MBR.
Enter the Bit Rates as configured in the KMC. If you select to Save to File, you must
append %i to the file name.
Kaltura Management Console (KMC) User Manual
142
Live Streaming
NOTE: The Stream name is formatted for use with the FMLE. If you are using an encoder
other than FMLE, such as Wirecast, you will need to replace the "%i" with a "1". For
example, remove the % and replace the i with a 1 for the first stream or 2 if it is the
second stream and so on.
Click Connect.
Enter the Broadcasting credentials, (User Name and Password) as configured in the KMC Live
Stream tab and click OK. The system will prompt you twice for the Broadcasting credentials. Click
Start.
You are now broadcasting live.
When your broadcast is finished, click Stop.
Viewing the Broadcasting Setup (Optional)
To view the broadcasting setup
Return to the KMC and select the Content tab.
In the KMC Entries Table, click the Preview & Embed link for the live stream entry.
Select the player from the drop-down menu and copy the Embed Code.
Paste the Embed Code within an HTML page or short link URL created for this live stream.
Browse to the page where the embed code was inserted and press Play on the video player.
Advanced Live Streaming Configuration Options
There are multiple factors that can influence the video quality for live streaming. To receive good results
Kaltura Management Console (KMC) User Manual
143
Live Streaming
you should optimize the settings based on your specific needs.
The following table can be used as a starting point for optimization and setup. A rough estimate is
provided for the different factors, based on the video dimensions.
Video
Dimensions
Bitrate
Required
Camera
Requirements
FMLE HW
Requirements
Broadcaster
Uplink,
Viewer
Downlink
Requirements
(Mbps)
Throughput
example
for 1000
concurrent
viewers of
1 hour
broadcast
support frame
size &bitrate
Dual Core
2GB RAM
0.4
135 GB
(Mbps)
320x240
0.3
640x480
1.4
Quad Core Xeon
3GB RAM
2
630 GB
1024x720
3.5
8 Core
Xeon
3GB RAM
5
1600 GB
For more information about setting up these parameters in the Flash Media Live Encoder, as well as
additional advanced configuration options, see the FMLE guide.
Kaltura Management Console (KMC) User Manual
144
Content Authoring Tools
CHAPTER 14
Content Authoring Tools
This section contains the following topics:
The Content Tab
Editing Entries
Entries Table
Clipping and Trimming Media Files
Choosing a Thumbnail for your Video
The Content Tab
The Content tab is used to manage your media library and provides all the tools you need, in one intuitive
interface. You can organize your content and metadata, easily search media, edit, moderate, create
playlists, and much more through the Content tab.
The Content Tab has the following tabs:
Entries Tab
Moderation Tab
Playlists Tab
Syndication Tab
Categories Tab
Entries Tab
Your first step in the KMC is to upload files to the Entries Table. See The Upload Tab.
After you upload content to the KMC you can perform various modifications to your content, for example,
categorize, clip, and create ads. However, the most logical thing you may want to do is to embed your
video into your website. See Preview and Embed.
Entries Table
The Entries Table lists the entries in your account and provides a way to edit the entry’s specific metadata
and settings. You can perform several actions on a specific entry or several entries simultaneously. To
choose multiple entries, check the boxes near the entry name and then, select Bulk Actions at bottom of
the list. You can search through entries; delete entries, preview entries as well as other actions.
Kaltura Management Console (KMC) User Manual
145
Content Authoring Tools
Use the Entries tab to perform the following actions on multiple entries:
Set Scheduling – See Content Scheduling for applying scheduling to a single entry.
Set Access Control
Edit Tags
o
Add Tags
o
Remove Tags
Edit Categories
o
Add Categories
o
Remove Categories
Add to New Category Playlist
o
Add to New Category
o
Add to New Playlist
Change Owner
Download
Delete
Set Scheduling
Set specific scheduling parameters for your content.
To set a scheduling for an entry
Select the Content tab and then select the Entries tab.
Select an entry or multiple entries and select Bulk Actions on the bottom of the page.
Select Set Scheduling from the drop-down menu.
Enter the scheduling times that should be applied to the selected entries.
Click Apply to all Selected Entries.
Kaltura Management Console (KMC) User Manual
146
Content Authoring Tools
Set Access Control
Set access control permissions for your entries. (See Managing Access Control Profiles for more details).
To set access control permissions for entries
Select the Content tab and then select the Entries tab.
Select an entry or multiple entries and select Bulk Actions on the bottom of the page.
Select Set Access Control from the drop-down menu.
Select the access control profile that should be applied to the selected entries or click Add Profile
to create a profile. See Creating an Access Profile.
Click Apply to all Selected Entries.
Kaltura Management Console (KMC) User Manual
147
Content Authoring Tools
Edit - Add Tags to and Entry
You can add tags to entries in the KMC that will propagate to other applications.
To add tags to an entry
Select the Content tab and then select the Entries tab.
Select an entry or multiple entries and select Bulk Actions on the bottom of the page.
Select Add Tags from the drop-down menu.
Enter tags to append to all selected entries.
Click Save Changes.
Edit - Remove Tags from an Entry
You can remove tags from entries in the KMC. Removal will propagate to other applications.
To remove tags from an entry
Select the Content tab and then select the Entries tab.
Select an entry or multiple entries and select Bulk Actions on the bottom of the page.
Select Remove Tags from the drop-down menu.
Enter tags to append to all selected entries.
Click Save Changes.
Kaltura Management Console (KMC) User Manual
148
Content Authoring Tools
Edit - Add Categories
You can add categories to entries in the KMC that will propagate to other applications.
To add categories to an entry
Select the Content tab and then select the Entries tab.
Select an entry or multiple entries and select Bulk Actions on the bottom of the page.
Select Add Categories from the drop-down menu.
Select or search for a category to apply to all the selected entries.
Click Apply.
Kaltura Management Console (KMC) User Manual
149
Content Authoring Tools
Edit - Remove Categories
You can remove categories from entries in the KMC. Removal will propagate to other applications.
To remove categories from an entry
Select the Content tab and then select the Entries tab.
Select an entry or multiple entries and select Bulk Actions on the bottom of the page.
Select Remove Categories from the drop-down menu.
Check the categories to remove from the all selected entries.
Click Apply.
Kaltura Management Console (KMC) User Manual
150
Content Authoring Tools
Add to New Category
You can select multiple entries in the entries list and then click "Add to New Category to create a new
category with the specific entries included. See Adding Editing a Specific Category for information on how
to create categories.
Add to New Playlist
You can select multiple entries in the entries list and then click "Add to New Playlist" to create a new
playlist with the specific entries included in the playlist. See the Playlists Tab for information on how to
create playlists.
To create and add entries to a new playlist
Select the Content tab and then select the Entries tab.
Select an entry or multiple entries and select Bulk Actions on the bottom of the page.
Select Add to new Playlist from the drop-down menu.
Check the entries to add to the new playlist.
Click Apply.
Change Entry Owner
By default, channel managers are the channel owner for any applicative need. A channel owner cannot
be deleted by other channel managers; however you can set a new owner for an entry.
Kaltura Management Console (KMC) User Manual
151
Content Authoring Tools
Download Files
To download files to your computer for offline use
Select an entry and select Bulk Actions on the bottom of the page and select Download from the
drop down menu.
Note that you can download more than one entry at a time, as long as the entries appear on the
same page of the entries list.
A flavor (format/quality) selection window is displayed for the video files you select to download.
Select your preferred flavor from the drop-down menu and click "Submit" to proceed. A message
will appear stating that links to your downloaded files will be sent to your email. Click "OK" to
proceed.
Delete Multiple Entries
You can delete multiple entries in the KMC.
To delete entries
Select the Content tab and then select the Entries tab.
Select an entry or multiple entries and select Bulk Actions on the bottom of the page.
Select Delete from the drop-down menu.
Kaltura Management Console (KMC) User Manual
152
Content Authoring Tools
Select the entries to remove.
A warning message is displayed.
Click Remove.
Preview and Embed
To preview and get the embed code for entries in the Entries Table; click the Preview & Embed" link
under the Actions column on the main list of entries. In the new window that opens, you can preview the
entry and select the player that you would like to use. See Embedding a Player on your Site.
To preview and embed your content to a website
Go to the Content tab and select the Entries tab.
Click on an entry in the Entries table.
Select Preview and Embed in the actions drop down menu.
In the new window that opens, you can preview the entry and select the player that you would like
to use and other delivery and player options... See Embedding a Player on your Site.
Grab the embed code.
Editing Entries
To edit an entry
Click on an entry name. The Edit Entry window is displayed.
Use the Edit Entry window to manage all information relating to the entry.
Kaltura Management Console (KMC) User Manual
153
Content Authoring Tools
Edit Entry Tabs
Metadata: Use to display the entry and edit basic metadata: Name, Description, Tags,
Categories and Reference ID. See Managing Metadata for more information. For video and
audio entries, you can also trim or clip the entry. You can see the Entry ID, type of entry (video,
video mix, image or audio), moderation status (approved, flagged for review or rejected), flags,
duration, date of creation, creator, rating, votes count and number of plays. In this tab you can
also trim or create multiple clips from a single video. Each clip gets its own embed code and
metadata, while remaining associated to the original video. Trimming and clipping tools are
available both to administrators and site users. See Clipping and Trimming Media Files. You can
leverage metadata fields to tag, manage, search and expose content. Populate out-of-the-box
fields, or create your own custom metadata schema.
Thumbnails: Use to upload thumbnails, grab a thumbnail from video, crop thumbnails and select
a default thumbnail. You can generate thumbnails from videos or upload external images.
Capture, crop and adjust to get the best result. See Choosing a Thumbnail for your Video.
Access Control: Use to assign an access control profile to an entry. See Managing Access
Control Profiles.
Scheduling: Use to specify date ranges for scheduling an entry. See Content Scheduling.
Flavors: Lists all related flavors. Use to convert an entry to additional flavors or to re-convert
existing flavors. See Transcoding and Processing.
Distribution: Lists distribution channels associated with an entry and use to manage distributors.
See Content Distribution.
Captions: Use to manage captions. Use to upload captions, link to external caption files, and to
add additional captions to an entry. See Subtitles and Captions.
Advertisements: Use to create midrolls and overlays for each entry. Add cue points to your
video files to enable time-based functionality such as chaptering, display of related files at
specific points, and timed advertisements. See Adding a Midroll.
Related Files: Use to upload related files and to assign the files to an entry. See Uploading and
Modifying Related Files.
Kaltura Management Console (KMC) User Manual
154
Content Authoring Tools
Clips: Displayed if clips were created from an original video or audio entry. See Clipping an
Entry.
Users: Use to add editing and publishing rights for additional end-users to work with this entry
across applications. See Users Tab.
Clipping and Trimming Media Files
You can create clips from existing videos, set in and out points. Each clip becomes its own media entry
encoded to multiple flavors, and can be downloaded, distributed and played back on any device. You can
also trim the length of a video directly from within the Kaltura Management Console. The clipping tool
enables you to edit your videos visually or by setting the start time and end time of your clip. For
additional information see Server Side Clipping and Trimming.
Clipping creates a new entry from an existing entry and allows you to specify the start and end time for
the new entry. For example you can clip an entry that can be used to create a 2 minute intro video to a
long lecture, or clip part of an entry, such as homework assignments. You can also clip a long lecture to
several shorter clips divided by subjects. The new entry will point to its source entry so that you can
always identify the source entry for the clip.
Trimming does not create a new entry. Sometimes, you may want to trim the start and/or end of a video to
remove redundant parts. Trimming is performed on the source flavor of the entry, modifying that video
permanently.
To clip a media entry
Select the Content tab and then select an entry from the Entries Table.
In the Metadata tab, click Clip This.
The Clipping Tool window is displayed.
Click Add New Clip.
Kaltura Management Console (KMC) User Manual
155
Content Authoring Tools
Use the arrow to choose the granularity level for the display.
The choices are:
o
100%
o
5 sec
o
1 sec
o
Frames.
Press Play and click Set In as the starting point of the video clip, or alternatively, select the start
time.
Select Set Out as the end point of the video clip, or alternatively select the end time.
Provide a New name and Description for the clip (optional).
Click Save.
The new clip appears in the Entries Table.
This Clips tab is available after you create a clip. The read-only list of all created clips includes
the following information:
o
Name
o
ID
o
Creator
o
Plays
o
Duration
Kaltura Management Console (KMC) User Manual
156
Content Authoring Tools
To trim a media entry
Select the Content tab and then select an entry from the Entries Table.
In the Metadata tab, click Clip This.
Select Add New Clip.
Use the trimming timeline or enter exact in and out times.
Press Play and click Set In as the starting point of the video clip or alternatively, select the start
time.
Select Set Out as the end point of the video clip, or alternatively select the end time.
Provide a New name and Description for the clip (optional)
Click Save.
The trimmed video appears in the entries table.
Troubleshooting Trimming and Clipping
The Trim and Clip feature may be disabled if your transcoding profile does not include the flavor for the
file you want to trim or clip.
When you upload content, new flavors are created from the Source flavor and transcoded to the flavors
you define in your Transcoding Settings.
To add the Source flavor to your transcoding profile
Go to Settings tab and select the Transcoding Settings tab.
At the bottom of the page, click Switch to Advanced mode.
Click on the name of your default transcoding profile
In the Edit Transcoding profile check the Source flavor and then Save Changes.
Users Tab
The Users tab is displayed when your account is configured to support the end-user management
feature.
The Users tab provides information about the users that are associated with the entry. The users are
the creator of the entry in Kaltura - usually the person that uploaded the media
the administrative owner of the entry - the user that is assigned with ownership to manage the
entry. By default it is the entry creator, however you can assign ownership to a different user from
this tab.
By editing the co-editors and co-publisher fields, you can add editing and publishing rights for additional
end-users to work with this entry across applications.
To edit the entry’s users settings
Go to the Content tab and then select an entry from the Entries Table.
Select the Users tab.
Kaltura Management Console (KMC) User Manual
157
Content Authoring Tools
Click Change Owner.
Enter the new owner name and click Save.
The CoEditor(s) and Co-Publishers field is displayed only when configured in your acount.
Click Save and Close.
Choosing a Thumbnail for your Video
You can select a thumbnail for your video after the file transfer is complete and the file is embedded in
your website. Thumbnails are configured in the Thumbnails tab in the Contents tab. By default, a
thumbnail is automatically grabbed from the first frames of the video. You can choose to have multiple
thumbnails of different qualities associated with your video, or grab any frame from the video to use as a
thumbnail.
You can search for a thumbnail and its dimensions, size, distributors and status and perform the following
actions: Set as default, Download and Delete.
Kaltura Management Console (KMC) User Manual
158
Content Authoring Tools
To edit the thumbnails associated with the video
Go to the Content tab and select the Entries tab.
Select an entry and select the Thumbnails tab.
Select Upload, Grab from Video or New Crop.
o
Upload - uploads an external image as a thumbnail.
o
Select Upload and specify the file location and name, then click Open.
o
Grab from Video -Capture a new thumbnail from the video.
Play the video in the "Grab from Video" window. Pause on the frame you want to use and
click the thumbnail capture icon (camera). A thumbnail will be captured from the highest
quality video flavor. Exit to return to the Thumbnails tab.
o
New Crop - Modify thumbnail dimensions.
Select a thumbnail and create a thumbnail with a new position and size.
Adjust the display area with the handles on the image and click Generate Thumbnail.
The connector name is added to thumbnail dimension menu if you have defined thumbnails for a
distribution target.
The default thumbnail is now displayed in the entries list.
Kaltura Management Console (KMC) User Manual
159
Publishing to Your Site
CHAPTER 15
Publishing to Your Site
This section contains the following topics:
Embedding a Player with a Single Entry on your Site
Embedding a Player with a Playlist on your Site
Adding the Flavor Selector Module
Embedding a Player with a Single Entry on your Site
To embed a player on your site
Create a Player. See Configuring the Player Basics Settings.
Select content (an entry) for your player. See Adding Content to a Player.
The Entries table from the Content tab is displayed.
Click Preview and Embed.
The Embedding window is displayed.
Select your preferred player from the drop-down menu. See Configuring the Player Features.
(Optional) – Click Show Advanced Options.
a. Select the Delivery Type. See Video Delivery Settings.
b. Select the Embed Type. See Embed Code Types.
(Optional) Check Include Search Engine Optimization data. See Search Engine Optimization.
(Optional) Check Support for HTTPS embed code. See Support for HTTPS Embed Code.
Preview: (Optional) Scan the QR code to preview the content in your mobile device.
Preview: (Optional) Select to view a standalone page with this player by clicking on the provided
link.
Kaltura Management Console (KMC) User Manual
160
Publishing to Your Site
NOTE: The (Preview) QR code and standalone links are for preview use only. Do not use
these links for production purposes.
Click Copy Embed Code and Close.
Copy Embed and Close is identical to the Copy embed code, except that Copy Embed and close
closes the Preview and Embed window.
Embedding a Player with a Playlist on your Site
After you've created a playlist, and have assigned the playlist to a player, see Designing and Configuring
A Player you can publish the player to your site.
To embed a player with a playlist on your site
Go to the Content tab and select the Playlists tab.
Locate the playlist you want to publish on your website and click Preview & Embed.
The Embedding window is displayed.
Kaltura Management Console (KMC) User Manual
161
Publishing to Your Site
Select your preferred player from the drop-down menu. See Configuring the Player Features.
(Optional) – Click Show Advanced Options.
a. Select the Delivery Type. See Video Delivery Settings.
b. Select the Embed Type. See Embed Code Types.
(Optional) Check Include Search Engine Optimization data. See Search Engine Optimization.
(Optional) Check Support for HTTPS embed code. See Support for HTTPS Embed Code.
(Optional) Scan the QR code to preview the content in your mobile device.
(Optional) Select to view a standalone page with this player by clicking on the provided link.
Click Copy Embed Code and Close.
Copy Embed and Close is identical to the Copy embed code, except that Copy Embed and close
closes the Preview and Embed window.
Video Delivery Settings
You can choose between the following types of video delivery settings:
Kaltura Auto - The default delivery type. Kaltura server chooses between HTTP Progressive
Download and Akamai’s HTTP Adaptive Streaming, based on entry duration and available
flavors. Auto gives you the best video delivery and playback quality for your entry.
HTTP Progressive Download Delivery– Allows you to pause the video playback and wait for the
content to download. Typically used where viewers have very limited bandwidth.and might
experience more buffering than adaptive bitrate.
HTTP Streaming (HDS) - HTTP streaming based on Adobe technology. Allows adaptive bitrate
so the player can adjust the video quality on the fly based on network and CPU conditions.
HTTP Streaming Based on Akamai's Technology– HTTP streaming based on Akamai’s
technology. Allows adaptive bitrate so the player can adjust the video quality on the fly based on
network and CPU conditions, formally called Akamai HD.
RTMP Streaming – RTMP streaming based on Adobe technology. Allows adaptive bitrate so the
player can adjust the video quality on the fly based on network and CPU conditions.
Secure Transport (RTMPE) - RTMP encrypted using Adobe's security mechanism which wraps
the RTMP session in a lighter-weight encryption layer.
For more information see Best Practices for Multi-Device Transcoding.
Kaltura Management Console (KMC) User Manual
162
Publishing to Your Site
For Kaltura SaaS users, the default delivery format is Kaltura Auto.
For users using MP4 (new flavor set), Akamai HTTP Streaming is the default delivery format. For users
using VP6, (old flavor set) Progressive download is the default delivery format...
Kaltura Auto
The Kaltura server internal logic chooses between two formats:
HTTP Progressive Download
Akamai’s HTTP Streaming.
Based on entry’s characteristics, before playback, the server decides which format is best for your video
delivery and playback quality.
For a video length <5 minutes (short form) – delivery format will be Progressive Download.
For a video length >5 minutes (long form) – delivery format will be Akamai HTTP Streaming.
If you have defined an Access Control Profile, the delivery format will be HDS.
HTTP Progressive Download Delivery
With HTTP Progressive download, the digital media begins downloading and after a specified amount of
data becomes available to the video player, the media begins to play while the rest of the data continues
to buffer.
HTTP Streaming (Based on Akamai’s Technology)
Akamai's advanced adaptive bitrate streaming technology intelligently adjusts the bit rate of a video
stream to ensure the optimum playback quality based on changing bandwidth conditions. It also allows for
flavor switching without the loss of content. You can send streaming video over HTTP from an ordinary
web server for playback on iPhone and iPad, or other devices, such as desktop computers, without the
limitations of Progressive Downloads. An optional feature with this selected delivery setting is that the
implementation also provides for media encryption and user authentication over HTTPS, allowing
publishers to protect their work. The Akamai HD Network is designed and optimized for large-scale
broadcasters and film distributors to increase audience engagement and expand revenues by
complementing traditional mediums such as TV and DVD with the Internet.
HTTP Dynamic Streaming (HDS) Based on Adobe
HTTP Dynamic Streaming (HDS) enables adaptive bitrate video delivery over regular HTTP connections.
RTMP Streaming (Legacy)
Adaptive Bit Rate (ABR) streaming is a technique of detecting a viewer's bandwidth capabilities in real
time, and then adjusting the quality of the video stream accordingly, always delivering the best possible
picture quality. ABR streaming results in less buffering, fast start time and an overall better experience for
both high-speed and low-speed connections.
ABR dynamically shifts bandwidth to higher and lower levels based on availability. For Adaptive Bitrate
Streaming to work, a video is first encoded at different bitrates to accommodate varying bandwidth
connections. Each bitrate version is sliced up into tiny fragments — typically 2 to 10 seconds. The Kaltura
player pulls fragments from the different encodings and inserts them into the stream as bandwidth
Kaltura Management Console (KMC) User Manual
163
Publishing to Your Site
dictates resulting in faster video start times and a continuous, uninterrupted video experience.
For example, a movie called The “Big Movie” is streaming. The end user would view a smoothly playing
video. Unknown to the user, multiple streams are actually available and may be seamlessly switched to, if
their connection drops lower or improves. The key here is “seamless”. When adaptive bit streaming is
done correctly, there should be no interruption of playback.
For The Big Movie, a player might be serving up the following all at once:
The Big Movie @ 2612 kbps
The Big Movie @ 1600 kbps
The Big Movie @ 1200 kbps
The Big Movie @ 800 kbps
USE CASE
If a user’s connection dropped from over 2.5 Mbps to 1600kbps, the Kaltura player would switch, again
seamlessly, from the 2612 bit rate down to the 1600. Often the Kaltura player is designed to begin playing
using the lowest possible bit rate so that playback starts immediately. For this example, the 800 kbps
stream might be served up first and then as the Kaltura player realizes that the user can handle a higher
bitrate, the streaming rate would then be switched up higher.
Secure Transport RTMPE (Legacy)
Kaltura supports various methods of securing delivery of video streams (for example, Progressive
download over HTTPS, Akamai HD Network or SWF verification) RTMPE is one of them.
RTMP Encrypted uses Adobe's security mechanism which wraps the RTMP session in a lighter-weight
encryption layer.
Embed Code Types
The following options are available:
Auto Embed – (default) Auto embed is concise embed code and is good for quickly getting a
player or widget onto the page without many runtime customizations (flashvars).
Dynamic Embed – This is the preferred method to dynamically embed the Kaltura player into
web sites and web applications. The advantages over an object or Flash library rewrite are:
o
Fast - does not have to wait for dom ready to output the Flash or HTML5 player
o
Clean - uses JSON embed configuration for easy runtime customization, no long messy
parameter strings
o
Dynamic - better supports dynamic HTML5 and Flash embed methods, responsive web
design, and CSS inheritance of embed target.
Thumbnail Embed – This method takes the same arguments as the dynamic embed. Thumbnail
embed passes the entire configuration to the kWidget.embed when the user "clicks" on the play
button. This is the recommended method to use when you need to embed many players/entries
in the same web page.
Legacy Flash Embed (Object Rewrite) – The basic player rewrites works by including the
JavaScript library followed by the Flash object tag embed. This option should be used only when
JavaScript cannot be embedded or you don’t require high performance HTML5 support.
Iframe, no page JavaScript embed - iframe embed is good for sites that do not allow 3rd party
JavaScript to be embeded on their pages. This mode fits more stringent page security
Kaltura Management Console (KMC) User Manual
164
Publishing to Your Site
requirements while supporting both Flash and HTML5 delivery..
Search Engine Optimization
When the SEO (Search Engine Optimization) box is checked, the target page element includes metadata
useful for search engines to index your page video content. The metadata is included using the
scheme.org format that Google and other major search engines recommend using for documenting inpage content.
The content for these metadata fields is pulled from your entry metadata. It’s also recommended that you
add Facebook open graph xml to your page which is not included in the embed code because it must go
in the header of your page. You can see sample Facebook open graph xml in any player preview page.
In some cases with Kaltura SaaS, SEO may also include Kaltura product definition links, please contact
your account manager if you would like these disabled.
Support for HTTPS Embed Code
Check the Support for HTTPS Embed Code box if you intend to put the player on pages that are
delivered over HTTTPS. The HTTPS embed URLs use protocol relative URLs so that the same embed
code also works for non secure delivery.
Adding the Flavor Selector Module
Any entry is available in various transcoding flavors. The flavor selector module allows you to manually
select the video flavor you want to watch, based on your preferences. The options are HD on or HD off.
If you are broadcasting with Adaptive RTMP then the flavor selector will be set to “auto”.
To add the Flavor’s Selector module
Go to Studio tab and create a new player or edit an existing one.
In the Features tab, go to the Features List and click Controls.
Check Flavor Selector.
Kaltura Management Console (KMC) User Manual
165
Publishing to Your Site
Select Options (optional) to configure display options and Save Changes.
Click Preview to view your selection and click Save Changes to complete the process.
Mobile and HTML5 Support
By default, your account includes mobile and HTML5 flavor support. If you require additional changes to
the mobile flavor set, you must configure specific encoding flavors. To transcode a file to this flavor, go to
the Edit Entry window's Flavors tab. See Transcoding and Processing and check the applicable mobile
flavors.
Kaltura Management Console (KMC) User Manual
166
Distribution and Syndication
CHAPTER 16
Distribution and Syndication
This section contains the following topics:
Kaltura Distribution Module
How Does Distribution Work?
Scheduling a Video Package
Content Syndication
How Does Syndication Work?
Setting Up Syndication
Kaltura offers several advanced syndication and distribution services to ensure that publishers maximize
their content’s reach and increase their audience. Kaltura’s tools help publishers save time and money by
making content distribution to a wide range of video destination sites and search engines extremely easy
and streamlined.
Kaltura Distribution Module
Kaltura’s Distribution Module allows you to reach your users on the web and across any mobile device.
The module provides a streamlined and simple workflow so you can distribute your content to distribution
partners, such as YouTube, Hulu, Comcast, MySpace, MSN or an FTP drop folder, directly from within
the KMC.
Key Benefits:
Full control over where and when the content is presented.
Manage all of your distribution partners through a single user-friendly interface
Deliver assets automatically as they are added to your Kaltura account, or require a manual
review, at your discretion
Seamlessly push updates to distributed content from a central dashboard
Control scheduling sunrise and sunset per asset and per distribution partner
Track your content across all distribution partners
Simple and straightforward pricing, with no hidden fees or “guesstimates”
Kaltura’s system validates content to make sure it’s ready to be distributed to each distributor,
and alerts about any errors that need to be fixed prior to distribution (missing thumbnails, missing
metadata, etc.)
Successful delivery to each distribution partner is confirmed for each asset (if supported by the
partner)
Kaltura Management Console (KMC) User Manual
167
Distribution and Syndication
How Does Distribution Work?
Distribution ensures that your content is viewed by as many customers as possible across multiple video
destination sites and improves total views for your content. Kaltura pushes the actual contents of the
video assets to distribution partners for them to host on their sites. Each distribution channel is unique
and depends on the distributor’s capabilities and the extent of their desired exposure.
The Kaltura Distribution Module supports several workflows. You can configure simple as well as complex
asset information to distribute. For example, simple asset information may include the entry name,
description and tags, or metadata alone, that may be used for example, to configure ads based on
metadata. More complex distribution data is configurable by your project manager and depends on the
distributor’s capabilities.
You can define the destinations for each video package and control aspects such as the video qualities,
number and size of thumbnails, metadata, and scheduling data for each distribution destination.
You can display distributors for each entry, the distribution start and end dates, submission status.
NOTE: You can distribute ALL videos to be pushed automatically to the destination or you can
distribute selected entries MANUALLY to be sent to the destination.
NOTE: Tag based or Rule Based distribution options are currently not available. You can either
distribute ALL entries or NONE. If none, you can manually select which entries will be
distributed to the destination.
A sample distribution configuration may contain the following components for an entry: video, metadata,
thumbnail, scheduling, content availability by Kaltura and removal of distributed content.
The Distribution Module can be configured to update distributed content for metadata, so that the most
updated information is propagated to the distribution site. Other customizable parameters may be
configured for distribution. The Distribution Module also can be configured to remove distributed content
for metadata, so that information that was propagated to the distribution site can be retracted.
With the Kaltura Distribution Module, administrators can control the destinations for each video package,
and for each distribution destination. In addition, administrators can control video transcodes, multiple
thumbnails in different sizes, metadata translations, scheduling data, and more.
The Distribution Module is an add-on module to the KMC, and incurs additional fees based on the amount
of distribution destinations supported for your account. Additional connectors to distribution destinations
can also be developed as custom work. Contact your Kaltura project manager or sales representative for
complete pricing.
Kaltura Management Console (KMC) User Manual
168
Distribution and Syndication
Adding a Distributor to an Entry
NOTE: To enable automatic distribution of all new entries, contact us, or call +1-800-871-5224.
To add more distribution destinations, contact your project manager.
To add a distributor
Go to the Content tab and select the Entries tab.
In the Entries Table, click the name of the entry you want to distribute.
In the Edit Entry window, select the Distribution tab.
Click Add / Remove Distributors.
The Add/Remove Distributors window is displayed.
Kaltura Management Console (KMC) User Manual
169
Distribution and Syndication
To add distributor destinations to your account
Contact your account manager.
To select distributors
Check the distributors from the Distributor list. Click All or None at the top of the column to select
or clear all the items in a column.
Check the Distribute Automatically column to distribute an entry as soon as it is ready. Click All or
None at the top of the column to select or clear all the items in a column.
All includes all distributors. For example, if you have configured Daily Motion and YouTube as
distributors, content will be distributed to both destinations.
Click Apply to save your changes and return to the Distribution tab.
Click Save Changes to complete the process.
Scheduling a Video Package
By default, an entry's general scheduling is inherited by all distributors. The instructions here are for
setting scheduling for a specific distributor. A Remote ID is the ID assigned to the distributed content in
the distributor, and is only available after content has been distributed. The Remote ID may be used as a
response from the distributor as well as a reference, for example, to reach the page where the distributed
content appears in the distributor.
To schedule when an entry should be distributed
Select the Content tab and select the Entries tab.
In the Entries Table, click the name of the entry that you want to schedule.
In the Edit Entry window, select the Distribution tab and then select the name of a distributor.
Kaltura Management Console (KMC) User Manual
170
Distribution and Syndication
The Distribution Details window is displayed.
Set the Start Date and End Date and enter the hour.
Click Save to return to the Distribution tab.
Kaltura Management Console (KMC) User Manual
171
Distribution and Syndication
Click Save and Close to complete the process.
Validating a Video Package
Errors may occur when you specify a video package distributor.
To find and resolve errors
Go to the Content tab and select the Entries tab.
In the Entries Table, click the name of an entry for which you added a distributor.
In the Edit Entry window, go to the Distribution tab and click the error name in the Submission
Status column to display a description of the error.
You can also click on the Distributor in the Distribution tab, and then click the error name in the
Distribution Details window.
Follow the instructions in the error description.
The following errors may occur:
Missing Flavor Error
To add a flavor:
NOTE: If you click "Go to Flavors Tab" in the error description, skip to step 4.
Go to the Content tab and select the Entries tab.
In the Entries Table, click the name of the entry that is missing a flavor.
In the Edit Entry window, go to the Flavors tab.
Kaltura Management Console (KMC) User Manual
172
Distribution and Syndication
In the Action column, click Convert or Reconvert for each transcoding flavor specified in the error
description, and click Save Changes.
Metadata Error
To correct metadata:
NOTE: If you click "Go to Metadata Tab" in the error description, skip to step 4.
Go to the Content tab and select the Entries tab.
In the Entries Table, click the name of the entry that has a metadata error.
In the Edit Entry window, go to the Metadata tab.
Modify the information in the metadata field specified in the error description, and click Save and
Close.
If the submission status error is still displayed in the Edit Entry window's Distribution tab: go back
to the Settings menu Custom Data tab.
Add the missing information specified in the error description, and click Save and Close.
Missing Thumbnail Error
To add a thumbnail
NOTE: If you click "Go to Thumbnails Tab" in the error description, skip to step 4.
Go to the Content tab and select the Entries tab.
Kaltura Management Console (KMC) User Manual
173
Distribution and Syndication
In the Entries Table, click the name of the entry that is missing a thumbnail.
In the Edit Entry window, go to the Thumbnails tab.
Click Add Thumbnail and select an option.
o
If you have a thumbnail file, select Upload, specify the file location and name, and click Open.
o
To Grab from Video, play the video, pause on the frame you want, and click the thumbnail
capture button (camera).
A thumbnail will be captured from the highest quality video flavor.
Exit to return to the Thumbnails window.
To modify the thumbnail dimensions
In the Edit Entry window, click Add Thumbnail and select New Crop.
Kaltura Management Console (KMC) User Manual
174
Distribution and Syndication
Select the Thumbnail to modify.
Check the Lock aspect ratio and scale to option and select the values specified in the error
description.
Adjust the display area with the handles on the image.
Click Generate Thumbnail and exit to return to the Thumbnails window.
Click Save Changes to complete the process.
Removing a Distributor from a Video Package
You may want to change your distribution destinations for video packages.
To remove a distributor from a video package
Go to the Content tab and select the Entries tab.
In the Entries Table, click the name of the entry with a distributor that you want to remove.
In the "Edit Entry" window, go to the "Distribution" tab and click "Add / Remove Distributors".
In the "Add / Remove Distributors" window, clear a distributor checkbox.
To clear all items in a column, click "None" at the top of the column.
Kaltura Management Console (KMC) User Manual
175
The Syndication Tab
Click Apply to save your changes and return to the Distribution tab.
Click Save Changes to complete the process.
Managing Distributor Details
To manage an entry's distributor details
Click the distributor's name on the "Distribution" tab.
In the "Distribution Details" window, you can see the distributor's distribution details (status,
remote ID and schedule), the entry's metadata details, the available thumbnails and the video
flavors.
In the "Distribution Details" section:
a. To fix an error, click the error name to display an error description and follow the instructions.
b. To schedule when an entry is available at the distributor, set the start and end dates and
times, and click "Save".
You can set scheduling separately for each distribution so that the same content may have a
different schedule depending on the distributor.
In the "Thumbnails" section, Thumbnails are matched to the distribution point's required
thumbnail size. If you have multiple thumbnails of the same size, click "Swap" to manually select
the one you want.
In the "Video Flavors" section, to preview the entry in a specific flavor, click "Preview" and play
the entry in the "Flavor Preview" window.
The Syndication Tab
Details on how to syndicate your content to specific destinations are included here.
Content Syndication
Content syndication is a way of making your content available to multiple other sources. This creates a
form of leverage that gives you the ability to create your content once while maximizing your exposure on
the Internet by distributing your content in many places at the same time. Content syndication is a win-win
Kaltura Management Console (KMC) User Manual
176
The Syndication Tab
for both the publisher and the webmaster. As a result of this type of distribution, publishers receive
increasingly more exposure for their content and webmasters receive new source for additional content.
Kaltura allows you to create video feeds in multiple formats that are ready for submission to 3rd party
platforms such as Google, Yahoo!, iTunes and other video sharing sites and social networks. Videos are
distributed via playlist feeds (such as MRSS) to the channels of your choice. The content remains on the
Kaltura host.
RSS syndicates your web content to other sites and builds inbound links, making RSS one of the most
effective SEO strategies today. Using RSS as part of your SEO strategy is advantageous. If you need
help with web content syndication, contact your account manager.
Syndicating to Google in the KMC is used mainly to create video site maps to submit into Google search
engines for indexing.
iTunes syndication in the KMC is used to show content in iTunes and to create a feed for iTunes.
How Does Syndication Work?
Kaltura provides syndication to the following out of the box formats:
Google
Yahoo
iTunes
TubeMogul
Partners and developers can also syndicate content in Flexible Feed Format, or you can contact
Professional Services to create a customize feed in XSLT or XML. See Flexible Feed Format.
Kaltura’s MRSS Feeds and Syndication services allow publishers to syndicate and track their videos on a
wide range of video sharing sites and social networks via playlist feeds managed through the Kaltura
Management Console. Publishers can then track their videos and tweak their programs and campaigns
based on the results.
Publishers can set up MRSS feeds into major video search engines including Google, Yahoo! and iTunes
from within the KMC. You can create a feed based on all of the content in your KMC account, or a subset
of the content that is determined by a specific playlist see the Playlists Tab. You can then add the
selected content to a feed by selecting its destination site. The content of a playlist can change, for
example a rule-based playlist can be modified by changing a rule, or a manually created playlist may be
modified by manually adding content to the playlist. The feed will automatically change according to the
modifications. Feeds are cached in the Kaltura server for 24 hours. The feed refresh is automatic, and the
changes are available after that time.
Syndicating to a Standard MRSS Feed (Yahoo)
Yahoo is the standard MRSS feed type which can be used by any MRSS reader for various use cases.
Yahoo also uses the standard MRSS feed to submit site maps. For example, if you create an MRSS, you
can place the link in your site and allow end users to subscribe to the feed, or use the feed for your own
integration. You can create your own video galleries that refresh when you update the feed, as well as
integrate the feed to your site, and extract data from the feed to display the content, depending on fields
you define. There are many clients (for example all browsers), and desktop applications, and site
integrations that know how to read MRSS feeds.
Search Engine Optimization (SEO)
Kaltura Management Console (KMC) User Manual
177
The Syndication Tab
Submitting feeds to major search engines helps to increase your content’s SEO, and ultimately direct
more traffic to your website. See Maximizing Video SEO With Kaltura.
Key Benefits
Setting up a new feed is simple and quick - easily set-up multiple playlists in the KMC to be
distributed, videos within each playlist are automatically distributed to the relevant channels on
the video sharing sites.
Automatic updates – after a one-time set-up, any additional videos that are added to the selected
playlist will automatically be syndicated accordingly based on the feed’s specific configuration.
There is no need for manual updates to the feed.
Setting up Syndication
To configure syndication settings
Go to the Content tab and select the Syndicate tab.
Click Create New Feed.
Enter the Feed Name (required).
Select the content to syndicate.
o
All Content – syndicates all entries.
o
Only content from this playlist – syndicates content from the playlist you select.
Select the Feed Type.
Kaltura Management Console (KMC) User Manual
178
The Syndication Tab
You can shorten the caching time by limiting the feed size.
To shorten the caching time for a syndication feed
Manually add the parameter (&limit=50) to the feed URL.
Adding this parameter will limit the feed size to up to 50 items and will reduce the caching time to 30
minutes
Syndicating to Google
You can submit your videos to the Google search engine which will ultimately direct more traffic from
Google to your website. Submission of video feeds to Google is free of charge, yet requires some
technical knowledge. It is recommended that your website's webmaster be available for assistance.
Google syndication is used mainly for submitting your site map and being certain that your media is
indexed by Google.
The workflow for setting up Google syndication is divided into the following tasks:
Kaltura Management Console (KMC) User Manual
179
The Syndication Tab
Create a Landing Page.
Google Webmaster Tasks
KMC Publisher Tasks
Create a Landing Page
See Kaltura and Video SEO for information on creating a landing page.
Google Webmaster Tasks
To configure syndication settings for Google
Setup a Google Webmaster account for your website.
Setup your website in the Google Webmaster Tool.
Follow the directions here. Make sure your site is valid based on the Google instructions.
Submit the Feed to a URL.
Create a server page on your website that redirects to this feed URL.
For example, for a php implementation, save a php file named redirect.php with the following
content (replace the XXXX with your feed URL):
Login to the Google Webmaster Tool.
In the Google Webmaster Tool, go to Site configuration > Sitemaps > Add/Test sitemap.
Submit the feed as your redirect page in your site, for example:
http://mysite.com/redirect.php.
KMC Publisher Tasks for Google Syndication
To configure syndication settings for Google
Configure the Syndication Settings. See Setting Up Syndication.
Select Google from the Feed Type drop-down menu.
The Google parameters are displayed.
Enter the Google Parameters, see Google: Feed Parameters and click Add Feed.
Kaltura Management Console (KMC) User Manual
180
The Syndication Tab
Kaltura Management Console (KMC) User Manual
181
The Syndication Tab
Google: Feed Parameters
Field
Description
Content Flavor
The format and quality of the content to be syndicated
Landing page
The URL template that you would like to appear in the Google search
results for each video in this feed. The system will append the specific
entry ID for each entry. See feed example below.
Add to default transcoding
profile
Check to add the chosen Content flavor to content that will be
uploaded subsequently, using the default transcoding profile
Playback directly from Google
-
Select if you prefer for Google to display a link to your website only or if
you'd like Google to display the actual video directly within the search
results page (see screenshot below). If you allow Google to playback
the videos directly from the search results page, you can select the
player that will be used for playback. The player may include your
branding, watermark, etc.
Adult content
If selected, videos in this feed should be available only to users with
SafeSearch turned off.
Syndicating to TubeMogul
Kaltura and TubeMogul have partnered to provide a premium syndication service at the most attractive
pricing available.
This service allows you to seamlessly syndicate your content to over 20 video portals including YouTube,
Daily Motion, Metacafe, etc. and to receive aggregated analytics across video portals.
Each time you add a video to your syndicated content, it will be automatically distributed to your channel
in the video portal you selected.
To learn more about this feature and pricing information contact us or call +1-800-871-5224.
KMC Publisher Tasks for TubeMogul Syndication
Kaltura Management Console (KMC) User Manual
182
The Syndication Tab
To configure syndication settings for TubeMogul
Configure the Syndication Settings. See Setting Up Syndication.
Select TubeMogul from the Feed Type drop-down menu.
The TubeMogul parameters are displayed.
Enter the TubeMogul Parameters, see TubeMogul: Feed Parameters and click Add Feed.
The URL for the feed is generated.
TubeMogul: Feed Parameters
Field
Description
Content flavor
The format and quality of the content to be syndicated.
Add to default transcoding
profile
Check to add the chosen Content flavor to content that will be
uploaded subsequently, using the default transcoding profile.
Kaltura Management Console (KMC) User Manual
183
The Syndication Tab
Field
Description
Feed categories
These categories will be used when pushing your content to the
various sharing websites
TubeMogul Webmaster Tasks
To submit the video feed to TubeMogul
Copy the feed URL you obtained after you added the feed. See KMC Publisher Tasks for
TubeMogul Syndication.
Login to your Kaltura–TubeMogul account.
Go to Advanced Tools, select More Tools, and then select MRSS Feed Manager.
Submit your feed.
Syndicating to iTunes
You can submit your content to the iTunes Store as a podcast. You will need an active Apple ID and the
iTunes application installed. The flavors for feeds for iTunes must either be MP4, or a flavor that is
compatible with Apple iTunes.
KMC Publisher Tasks for iTunes Syndication
To configure syndication settings for iTunes
Configure the Syndication Settings. See Setting Up Syndication.
Select iTunes from the Feed Type drop-down menu.
The iTunes parameters are displayed.
Enter the iTunes Parameters, see iTunes: Feed Parameters and click Add Feed.
Kaltura Management Console (KMC) User Manual
184
The Syndication Tab
iTunes: Feed Parameters
Field
Description
Name
Name of the feed.
Content selection
You can either select all content, or create a feed of a specific playlist
only.
Content flavor
The format and quality of the content to be syndicated. iTunes supports
these formats: .m4a, .mp3, .mov, .mp4, and .m4v. Refer to here for
more information.
Add to Default Transcoding
Profile
Check to add the chosen Content flavor to content that will be
uploaded subsequently, using the default transcoding profile.
Landing page
The URL template that you would like to appear in the iTunes Store for
each video in this feed. The system will append the specific entry ID for
each entry. The following parameters will be presented in the iTunes
store, as demonstrated in the illustration below:
Feed Author
Feed Landing Page (link back to your website)
Feed Category (will direct iTunes store how to categorize your feed)
Kaltura Management Console (KMC) User Manual
185
The Syndication Tab
Field
Description
Feed Description
Feed Image URL (should be 600x600)
In addition, the system will add the following relevant information for
every entry: Name, Duration, Create date, Description.
Contact information
The name and email you enter for the feed will be used for iTunes
Store to contact you if necessary. This information will not be
presented in the iTunes Store.
Language
The language of the videos/ audio files in this feed.
Adult content
If you select this, an "explicit" parental advisory graphic will appear
next to your podcast artwork on the iTunes Store, and in the Name
column in iTunes.
To test the feed before submitting to the iTunes Store
Copy the URL you obtained after adding the feed.
Launch the iTunes application installed on your desktop.
Go to Advance > Subscribe to podcast and submit the feed URL.
To submit the feed to the iTunes Store as a podcast/ video podcast:
Copy the feed URL.
Go to https://phobos.apple.com/WebObjects/MZFinance.woa/wa/publishPodcast(launches
iTunes application in the right page)
Submit your feed.
Syndicating to Yahoo
Syndicating to Yahoo in the KMC is used mainly to create standard MRSS feeds. Yahoo syndication can
also be used to create site maps to submit into Yahoo search engines for indexing.
Kaltura Management Console (KMC) User Manual
186
The Syndication Tab
KMC Publisher Tasks for Yahoo Syndication
To configure syndication settings for Yahoo
Configure the Syndication Settings. See Setting Up Syndication.
Select Yahoo from the Feed Type drop-down menu.
The Yahoo parameters are displayed.
Enter the Yahoo Parameters, see iTunes: Feed Parameters, Yahoo: Feed Parameters and click
Add Feed.
Yahoo Webmaster Tasks
To submit the video feed to Yahoo
Copy the feed URL you obtained after you added the feed. See KMC Publisher Tasks for Yahoo
Syndication.
Go to http://video.search.yahoo.com/mrss/submit
Fill in the form and submit your feed as a “Full feed”.
Yahoo: Feed Parameters
Kaltura Management Console (KMC) User Manual
187
The Syndication Tab
Field
Description
Name
Name of the feed.
Content selection -
You can either select all content, or create a feed of a specific playlist
only.
Content flavor
The format and quality of the content to be syndicated
Add to Default Transcoding
Profile
Check to add the chosen Content flavor to content that will be
uploaded subsequently, using the default transcoding profile.
Landing page
The URL template that you would like to appear in the Yahoo search
results for each video in this feed. The system will append the specific
entry ID for each entry.
Playbacks directly from Yahoo
Select if you prefer for Yahoo to display a link to your website only or
also if you'd like Yahoo to display the actual video directly within the
search results page. If you allow Yahoo to playback directly from within
the search results page, you can select the player that will be used for
playback. This player may include your branding, watermark, etc.
Adult content
If selected, videos in this feed should be available only to users with
SafeSearch turned off.
The table below maps categories between the different websites.
TubeMogul
Arts &
Animat
ion
Comedy
Entertain
ment
Music
News &
Blogs
Science &
Technolo
gy
Sports
Travel &
Places
5min
Arts/Ot
hers
People/Oth
ers
Home/Ent
ertaining
Music/Oth
ers
Business/O
thers
Tech/Other
s
Sports/Oth
ers
Wheels/Ot
hers
Blip.tv
Art
Comedy
Movies and
Television
Music and
Entertainm
ent
The
Mainstrea
m Media
Technology
Sports
Travel
Break
Animati
on
Funny
Videos
Entertainm
ent
Entertainm
ent
News
Videos
Entertainm
ent
Sports
Videos
Entertainm
ent
DailyMotion
Arts
Funny
Film & TV
Music
News &
Politics
Science &
Technology
Sports &
Extreme
Travel
eBaums
World
Arts
Animati
on
Comedy
Entertainm
ent
Music
News Blogs
Science
Tech
Sports
Travel
Places
Graspr
Arts &
Crafts
Other
Other
Music
Other
Computers
& Internet
Sports &
Recreation
Travel
GrindTV
N/A
N/A
N/A
music
N/A
N/A
N/A
N/A
Howcast
Animati
on
Techniq
ues
Humor &
Comedy
General
Performing
Arts
Making
Music
Videos
Politics &
Citizenship
General
Technology
General
Sports
General
Travel
i2TV
Arts,
Film,
Animati
on
Comedy
Entertainm
ent
Music
News
Technology
Sports &
Games
Travel &
Places
Metacafe
Art &
Animati
on
Comedy
Entertainm
ent
Music &
Dance
News &
Events
Science &
Tech
Sports
Travel &
Outdoors
Kaltura Management Console (KMC) User Manual
188
The Syndication Tab
TubeMogul
Arts &
Animat
ion
Comedy
Entertain
ment
Music
News &
Blogs
Science &
Technolo
gy
Sports
Travel &
Places
MSN Video
Movies
Movies
TV
Music
News
Web
Sports
Events
MySpace
Animati
on/CGI
Comedy
and Humor
Entertainm
ent
Music
News and
Politics
Science
and
Technology
Sports
Travel and
Vacations
Sclipo
Arts /
Design
Other
Other
Music
Other
Science /
Technology
Sports
Hobby /
Games
StreetFire
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
StupidVideos
Just
Plain
Stupid:
Laugh
Out
Loud
Just Plain
Stupid:
Laugh Out
Loud
Just Plain
Stupid:
Laugh Out
Loud
Just Plain
Stupid:
Laugh Out
Loud
Just Plain
Stupid:
Office/Wor
kplace
Just Plain
Stupid:
Laugh Out
Loud
Sports:
Other
Just Plain
Stupid:
Laugh Out
Loud
Veoh
Animati
on
Comedy
Entertainm
ent
Music
News
Tech &
Gaming
Sports
Travel &
Culture
VideoJug
Creative
&
Culture
Humour &
Bizarre
Entertainm
ent
Music
Current
Affairs
Technology
& Cars
Sports &
Outdoors
Travel
Yahoo
Art &
Animati
on
Funny
Entertainm
ent
Music
News
Technology
& Products
Sports &
Games
Travel
YouTube
Film &
Animati
on
Comedy
Entertainm
ent
Music
News &
Politics
Science &
Technology
Sports
Travel &
Events
Flexible Feed Format
Developers may create custom syndication feeds. You can customize syndication feeds by creating an
XSLT.
Flexible feed format allows for greater flexibility for creating syndication feeds. You can transform your
feed into any format programmatically and include additional data such as custom data fields, system
data fields, and other fields. For example, you may want to re-format a standard MRSS field, to move a
media item’s description place, or, for example, add the entry duration.
Flexible feed format allows you to determine what content goes into the feed field and the location of the
field. You can change the structure and the content of the feed
Kaltura Management Console (KMC) User Manual
189
Advertising and Ad Networks
CHAPTER 17
Advertising and Ad Networks
This section contains the following topics:
Overview of Advertising with Kaltura
Connecting with an Ad Server
Creating Kaltura Video Ads
Adding the VAST Ad Server
Configuring VAST Ads
Creating Bumper Ads
Configuring Third Party Ad Plugins
Configuring Companion Ads
Overview of Advertising with Kaltura
Kaltura’s monetization features contain a comprehensive set of advertising tools, pay-per–view,
subscription models, and built-in reports that let you optimize your strategy based on viewer behavior.
You can target viewers with ads on live videos or VOD, and across multiple devices such as mobile, PC
and set-top-box. With support for a wide range of video ad formats (including all major IAB standards),
and integrated plugins for video ad networks, such as Google DoubleClick DART, FreeWheel, Ad Tech,
Eye Wonder, AdapTV, Tremor Video and others, managing you can optimize your monetization.
The Kaltura Player supports pre-rolls, mid-roll post-rolls, Flash companion ads and HTML companion ads.
The Kaltura Player is VAST-compliant, supports custom SWFs, bumper videos, and has plugins for
AdapTV, Tremor, FreeWheel and Doubleclick.
Player Branding
Players can be designed and skinned to match any brand and used for your own brand or for advertisers
on your site. See Configure the Player Features.
Connecting with an Ad Server
Integrating your Ad Server with the KMC is a one-time activity performed when you initially set up video
advertising. The ad server has to be VAST compliant or available as a Kaltura plugin. You may also
create a custom swf for the Kaltura Player to support.
After you have selected an ad server and set up an account with that ad server, you integrate the ad
server with the KMC by establishing a connection between that ad server and KMC. After the connection
is established, all ad requests generated by the Kaltura Dynamic Player are in a format which the ad
server expects, allowing seamless communication between the Kaltura Player and the ad server.
The Digital Video Ad Serving Template (VAST) is an industry standard for the XML response from an ad
server. Most of the leading Ad Servers and Ad Networks are VAST compliant, and support IAB standard
Kaltura Management Console (KMC) User Manual
190
Advertising and Ad Networks
(VAST 1.0 / VAST 2.0 and VAST 3.0).
Popular ad servers include DoubleClick, Dart For Publisher (DFP), Microsoft Atlas, OpenX, ScanScout.
To see the full list of servers and networks that comply with VAST, refer to the IAB website:
http://www.iab.net/iab_products_and_industry_services/508676/compliance/679253
In general, ads, tracking, scheduling, and other parameters, are configured on the ad server side. With
VAST, other parameters need to be configured through the KMC or Kaltura Player. Ad parameters are
configured through the Studio tab in the KMC.
Kaltura Player and Ad Plugins
Kaltura partners have the ability to create a custom .swf file to stream ads from their own ad server to the
Kaltura Player. The.swf file acts as an ad plugin. The configured key-value pairs must be defined to play
the relevant ads.
You have to subscribe to an ad server and configure the ads on the ad server side.
Supported Ad Servers
All VAST compliant ad servers are supported. For more information see Kaltura’s Generic Ads Player
Plugin for VAST.
The Kaltura Player all VAST compliant ad servers and supports the following ad plugins:
AdapTV
Tremor
DoubleClick
FreeWheel
For more information see Configuring Third Party Ad Plugins.
Ad Terminology
Ad tracking – the ability to define which/if ads play based on specific metadata.
Overlay – an ad that appears as an image (usually with text) over a video, while the video is playing.
Companion ad– a banner ad that accompanies the ad that plays over the video player – this can either
be located in the list area of the playlist or somewhere else on the HTML page.
Ad Tag URL – a URL that is XML that contains all the information about the ad(s) that should be
displayed. VAST works with an ad tag URL system. The XML needs to conform to VAST standard in
order to be considered “VAST-compatible”. That means that it needs to have the proper tags.
The following is an example of a VAST ad tag URL:
http://ad3.liverail.com/?LR_PUBLISHER_ID=1331&LR_CAMPAIGN_ID=229&LR_SCHEMA=vast2
To see the example, insert this URL into your browser.
Ad Cue Points – time based points on an entry that can be used to view mid- roll advertisements.
Creating Kaltura Video Ads
The following is the workflow for configuring a KMC VAST compliant ad.
Kaltura Management Console (KMC) User Manual
191
Advertising and Ad Networks
Adding the VAST Ad Server
Configuring VAST Ads
Adding the VAST Ad Server
To add an ad server that supports the VAST standard
Obtain an Ad tag URL from your ad server. See How to Locate the Ad Tag URL.
Configuring VAST Ads
To configure VAST Ads
Select the Studio tab and select an existing player or create a new one. See Designing and
Configuring a Player. The player is configured to display VAST ads only.
Select the Advertising tab.
Enable Request ads for this player.
Configure the Ad Source as VAST Ad server.
Configuring VAST Pre-roll Ads
Pre-roll ads are ads that appear prior to an online video.
To configure pre-roll ads
Configure the Player Advertising Settings.
Click on Pre-Roll Ads.
Toggle on Request PreRoll Ads Enabled.
Paste the Ad Tag URL received from the ad server. See How to Locate the Ad Tag URL.
Select the Display options.
Display X ads assumes that there is more than one ad configured in the ad tag URL.
Before every X video starting with the X video assumes that there is either a playlist on the page
Kaltura Management Console (KMC) User Manual
192
Advertising and Ad Networks
or a gallery. This functionality works with galleries as well as playlists.
Configuring VAST Post Rolls
PostRoll ads are ads that appear after an online video.
To configure PostRoll ads
Configure the Player Advertising Settings.
Click on PostRoll Ads.
Toggle on Request PostRoll Ads Enabled.
Paste the Ad Tag URL received from the ad server. See How to Locate the Ad Tag URL.
Select the Display options.
Kaltura Management Console (KMC) User Manual
193
Advertising and Ad Networks
Adding a Midroll
Midrolls and overlays are cue points that are defined on an entry level in the player configuration section
of the Studio Advertising tab.
To add a midroll
Configure the Player Advertising Settings.
Select the Content Tab and select an entry.
Select the Advertisements tab.
Kaltura Management Console (KMC) User Manual
194
Advertising and Ad Networks
Select the method to obtain the midroll add from the File Actions drop down menu.
Choose the granularity level for the time-based display. The choices are:
100%
5 sec
1 sec
Frames.
Identify the exact scene or frame to display the advertisement and insert a cue.
This can be done on the timeline:
To edit a cue point, select whether the advertisement will be a video or an overlay.
Kaltura Management Console (KMC) User Manual
195
Advertising and Ad Networks
a. For a video - the entry will stop playing, the ad will play, and then the entry will resume.
b. For an overlay - while the entry is playing, a banner will appear on the screen. The entry
never stops playing.
For both video and overlay, there are 2 options in the provider section: VAST and OTHER. VAST
allows a user to insert a VAST ad tag URL. OTHER is for customers who have created a custom
plugin that allows for creating cue points Other, does NOT refer to existing ad plugins such as
Tremor, Adap.TV..
If you select overlay, the display time will be indicated next to the Overlay option:
You can modify the amount of time you want the overlay to appear on the video using the up and
down arrows.
To apply the selected cue points to the player, create a new player or edit an existing one under
the “Studio” tab. Within the advertisement portion of the player, make sure that the “Request Ads
From Entry’s Cue points” is set to “Yes”.
Adding an Overlay
An overlay ad is an ad banner that is displayed over the video.
To add an overlay at the entry level
Configure the Player Advertising Settings.
Select the Content Tab and select an entry.
Select the Advertisements tab.
Click on the + icon to add an overlay.
Select the method to obtain the overlay add from the File Actions drop down menu.
(Required) Select the Ad Type (video/overlay).
For Video the Duration is the length of the video and the field will be greyed out.
For Overlay – enter the amount of time to display in the Duration field.
Enter the provider name: VAST or Other and optional values.
For VAST enter the Tag URL and a descriptive name for the Midroll or Overlay, For other
providers enter values that you want to pass to the player.
Click Save.
To configure an overlay on the player level
Configure the Player Advertising Settings.
Within the advertisement portion of the player, make sure that the “Request Ads From Entry’s
Cue points” is set to “Yes”.
Click on Ads.
Toggle on Request Overlay Ads Enabled.
Paste the Ad Tag URL received from the ad server. See How to Locate the Ad Tag URL.
Select the Display options.
Kaltura Management Console (KMC) User Manual
196
Advertising and Ad Networks
Creating Bumper Ads
Bumpers are videos that act as ads and do not use an ad server. Bumper videos uploaded to Kaltura can
be inserted before or after a video, to function as pre-rolls or post-rolls. Bumper videos are associated
with a player, and are not associated with a specific video. Bumper videos are independent of actual
pre/post-rolls and can be played in addition to ads. Bumper videos are helpful for Kaltura partners that
would like to advertise their logo, or other information, before or after a video, and for smaller partners
that would like to advertise, but do not expect to monetize from their ads.
Bumper videos can be configured in addition to any other ads that are configured. On the bottom of the
Advertising tab, the option to add bumper videos only is available.
To configure a Bumper ads
Go to the Studio tab and select or create a player.
Select the Advertising tab.
In the Ad Timeline section, click on Bumper Video.
Toggle on Bumper Video Enabled.
Paste the Kaltura Entry ID that will be used as the bumper.
Enter the URL in the Click URL field.
Kaltura Management Console (KMC) User Manual
197
Advertising and Ad Networks
A Kaltura partner also has the ability to enable ONLY bumper ads by choosing Bumper Only as the Ad
Source:
While in the Advertising tab, you can also configure bumper pre-rolls, and or bumper post-rolls.
To configure bumper post-rolls
Create a bumper video. See Creating Bumper Ads.
In the Features tab on the left, select the Additional Parameters and Plugins section.
Enter the following:
postbumper.plugin=true&postbumper.width=0&postbumper.height=0&postbumper.lock
UI=false&postbumper.playOnce=false&postbumper.path=bumperPlugin.swf&postbum
per.relativeTo=video&postbumper.position=before&postbumper.includeInLayout=
false&postbumper.preSequence=false
Click Go.
Whenever both pre-rolls and bumper videos are enabled, pre-rolls will always play before the bumper
video. This is because the pre-roll is configured as, preSequence=1, and the bumper video is,
preSequence=2. You can change the play order via the uiconf. Post-roll ads will always play AFTER the
bumper post-rolls.
Configuring Third Party Ad Plugins
Kaltura Management Console (KMC) User Manual
198
Advertising and Ad Networks
This section describes how to configure third party ad plugins.
Tremor Media
Tremor Media is an ad network that acts as a connector between ad companies/servers and their
customers. Tremor Media connects with numerous ad sources and partners from a single control
center and works with their customers to provide the appropriate ads from the appropriate ad servers.
To configure the Tremor Media plug in
Go to your Tremor account; define ads, scheduling, targeting, etc. on the Tremor end.
Go to the Studio tab and edit an existing player or create a new one.
Select the Advertising tab.
Enable ads for the selected player.
Select Tremor as the Ad Source.
In the key=value section, enter the policy ID. Type in progId=[policy ID].
NOTE: TremorMedia allows users to utilize other ad sources.
Kaltura Management Console (KMC) User Manual
199
Advertising and Ad Networks
NOTE: Tremor also allows users to utilize a different ad source as a fallback.
The Tremor plugin is in charge of displaying specific ads, and all the configurations are done on the
Tremor end.
Tremor Media Added Functionality
The following lists functionality that has been added to the Tremor plugin.
Functionality
Description
Passing dynamic
data
By inserting specific key-value pairs
in the uivars, a Kaltura partner can
define that any Kaltura metadata gets
passed to TremorMedia via the
TremorMedia plugin. Then, using the
Tremor ad server, the partner can
decide how to target ads via the
metadata.
To enable this functionality, a custom
ad path must be inserted into the
uiconf.
Kaltura Management Console (KMC) User Manual
Example
:
Note: The Content Rating custom data
field, has a slightly different value from
the rest of the metadata.
Internal
companion ads
The ability to insert a companion ad
directly on the list part of the playlist.
The companion ad must be inserted
as a custom ad path via the uiconf or
via Additional Parameters and
Plugins.
Capping ads
A Kaltura partner can cap ads via the
KMC based on the creation date.
To configure the Tremor plugin with
the startDateOffset, with the
parameter key maxAge, add the
following 2 attributes to the XML (if
the file is maintained manually):
paramKey1="duration"
paramValue1="{tremor.create
dAtOffset}"
or the equivalent uivars/flashvars line
paramKey1=duration¶mVal
ue1={tremor.createdAtOffset
}
This is based on the assumption that
the Tremor xml node has the id set to
'tremor '. If using a studio player the
id would be 'customAd'.
AdapTV
AdapTV has two different models – the standard model and the marketplace. The standard model allows
Kaltura partners to define their own ads. The marketplace provides the customer the ability to connect
with all sorts of ad companies to choose the most fitting ads.
To configure the AdapTV ad plug in
Go to your AdapTV account; define ads, scheduling, targeting, and other parameters, on the
AdapTV end.
Go to the Studio tab and edit an existing player or create a new one.
Select the Advertising tab.
Enable ads for the selected player.
Select AdapTV as the Ad Source.
Kaltura Management Console (KMC) User Manual
201
Advertising and Ad Networks
Enter the Custom SWF URL.
The Kaltura partner administrator should contact their ad server company to obtain the SWF URL
and the proper Key-Value Pairs to insert.
In the key-value section insert key=[your AdapTV key]. In AdapTV, many users utilize the zone to
differentiate between different ads. In this case, the customer needs to insert zone=[zone name]
in the key-value section as well.
To utilize the latest AdapTV plugin (the current out-of-the-box plugin is utilizing AdapTV’s legacy
integration of AS2, the new plugin utilizes AS3 integration): in the Additional Parameters and
Plugins section of the player, insert key=customAd.path value=
http://cdnbakmi.kaltura.com/flash/kdp3/v3.5.7.6/plugins/adaptvas3Plugin.swf
DoubleClick
Kaltura Management Console (KMC) User Manual
202
Configuring Companion Ads
You can configure the Kaltura DoubleClick plugin into a player via the KMC.
To configure the DoubleClick ad plug in
Select the Studio tab to access your players.
Select a player, click on Select Action and then select Edit.
On the left pane, click Features.
Click on Additional parameters and plugins.
Add the AdTagUrl. See Add the adTagUrl.
Under Paste your plug-in here: paste this line of code
doubleClick.plugin=true&doubleClick.path=http://kgit.html5video.org/ps/pulls/1
8/ps/DoubleClick/resources/flash/doubleClickPlugin/binrelease/doubleClickPlugin.swf&doubleClick.width=100%&doubleClick.height=100
%&doubleClick.includeInLayout=true&doubleClick.relativeTo=screensLayer&doub
leClick.position=after&doubleClick.disableCompanionAds=false&doubleClick.po
stSequence=0&doubleClick.preSequence=1&doubleClick.trackCuePoints=false&dou
bleClick.debugMode=true&adsOnReplay=true&debugMode=true
NOTE: The adTagUrl is not included in the sample line of code. The reason the adTagUrl
was not added to the code is because ampersands are often included in the adTagUrl and
this confuses the KMC. Therefore, the adTagUrl must be added in separately.
Click Go.
The added fields with their values should display. The first value should be doubleClick.plugin
with a value of true followed by the rest of the properties specified in step #5. The properties and
values can be entered in separately, however, the line of code provided here saves lots of time
since multiple properties separated by an ‘&’ are entered at once.
To add the adTagUrl
Under Paste your plug-in here: type or paste the doubleClick.adTagUrl
Click Go.
Right below, in the Key-value table, the first property should be the one just added
(doubleClick.adTagUrl).
In its value box, enter in your adTagUrl.
You can also use one of the samples provided in this document such as the sample linear
adTagUrl
http://pubads.g.doubleclick.net/gampad/ads?sz=400x300&iu=%2F6062%2Fiab_vast_sa
mples&ciu_szs=300x250%2C728x90&impl=s&gdfp_req=1&env=vp&output=xml_vast2&un
viewed_position_start=1&url=[referrer_url]&correlator=[timestamp]&cust_para
ms=iab_vast_samples%3Dlinear
Click Save changes.
The player should now be updated and can be viewed from the KMC by selecting the Content
menu and then selecting the Entries tab and selecting an entry to Preview & embed.
Configuring Companion Ads
Companion Ads are text, display ads, rich media, or skins that wrap around the video experience, and
can run alongside either or both the video or ad content. The primary purpose of the Companion Ad
Kaltura Management Console (KMC) User Manual
203
Configuring Companion Ads
product is to offer sustained visibility of the sponsor throughout the video content experience.” See
http://www.iab.net/wiki/index.php/Companion_Ad
VAST
Kaltura’s platform makes it easy to add Companion Ads in either HTML or Flash. After you’ve configured
your player (see Designing and Configuring a New Player or Playlist ), edit the player and navigate to the
Advertising tab. Scroll down to the “Player Configuration” section
Choose whether to configure HTML or Flash-based Companion Ads.
Companion Ads in HTML
To add companion ads in HTML
Click on the “Add companion div” text in the “Player Configuration” section. Entry fields to enter
the CSS “id” of your companion ad and the dimensions in pixels appear.
Enter the CSS DIV ID and dimensions (in pixels) for each ad region. Be certain to enter the
dimensions to match the dimensions of your served ads.
Click on the “Add companion div” text multiple times to enter more ad regions.
Kaltura Management Console (KMC) User Manual
204
Configuring Companion Ads
In the web page where your Companion Ads will display, you need to include a JavaScript file as well as
a corresponding HTML tag with a matching id for each region you create.
….
….
….