Video Ingest - Uploading videos

Video Ingest - Uploading videos

Introduction

Icareus Suite accepts many video formats and transcodes them for online and TV delivery. This page gives you insight how to prepare your master video files for ingest and what are the alternatives to upload your files to Icareus Suite.

Video Formats

The following video formats and delivery protocols with their limitations are supported.

Ingest Formats

mp4, flv, mov(with moov -atom)

File format
.mp4
Resolution (example)
1920x1080
Encoding
h.264 High Profile
Video Bitrate
Max. 6Mbit/s
Vide keyframe interval
2
Audio Bitrate
256kbit/s
Audio encoding
AAC-HE


Ingesting video on demand content

Introduction

Icareus offers three ways to add content on the platform:
  1. Manually via Icareus Suite web user interface
  2. Via webpage without login
  3. Batch uploading through FTP watch folder
  4. Via Icareus Suite API

1. Via Icareus Suite Web Admin UI

New videos are added by dragging video Master -files to the drag-and-drop -zone at the bottom of the Videos page.


It opens a pop-up where you can input the main metadata and follow-up the uploading.


Click 'Save' -button. System will then create the video asset based on the data.

2. Via webpage without login

Icareus also offers the possibility to use the addition of videos without logging in, for example via the Internet or Intranet website. For that, Icareus Videopilve has a download page, which can be found under Upload- in the main menu of the management interface:

The upload page can be embedded, for example, in the Intranet, where anyone of the Intranet users can upload the video to the Icareus Video cloud account.

3. Batch Uploading via FTP Watch Folders

To automate the content ingestion Icareus Suite offers an account specific FTP watch folder. Icareus Suite monitors this folder and once new assets and their metadata appear in the folder they are automatically processed and added to Icareus Suite Assets.

There are two ways to ingest content to Icareus Suite using the FTP when it comes to videos.

Videos folder
By uploading the video file to the "videos" folder on the FTP:  A new asset will be created that will then be transcoded to generate presets of different quality based on the quality of the master file.

Videos/no_transcode folder
By uploading the video file to the "no_transcode" folder (this folder is inside the "videos" folder) on the FTP: A new asset will be created, but it will only have the master file and won't be transcoded.

Adding New Assets via FTP Watch folder
  1. Adding new assets
  2. Updating existing assets
An Icareus Suite Account can have a designated FTP Watch Folder on Suite Cloud from where content can be added automatically to Icareus Suite Assets. FTP credentials can be seen in the Account Info, if this feature has been enabled for that account. Please contact Icareus support, if you cannot find your credentials.
Each FTP Watch Folder is bound to one Icareus Suite account. For customers managing several Icareus Suite accounts, please open separate FTP Watch Folder for each account.
Icareus Suite supports standard workflow logic for the Watch Folder(s) and additional customer specific workflows. The standard workflows are explained below.

Updating existing assets via FTP Watch folder
Via FTP watch folder it is also possible to update the existing assets:
  1. update video assets
  2. update of subtitle assets to FTP update
  3. upload & update of graphic assets to FTP update
It's also possible to add asset images by uploading the image files to the no_transcode folder. The naming of the image files should follow this format:
<assetId>_<image type>_<image size>

where
<image type> is the type of image: thumbnail, cover or banner
<image size> is one of: small, medium, large

supported file formats for images are currently .jpg, .jpeg, .png

For example naming of image assets:
123_thumbnail_small.jpg
123_thumbnail_medium.jpg
123_thumbnail_large.jpg
123_cover_small.jpg
123_cover_medium.jpg
123_cover_large.jpg
123_banner_small.jpg
123_banner_medium.jpg
123_banner_large.jpg

Workflow for Ingesting Videos without Metadata

Master Video File

The master video file should be a single file with the filename name and a common video file extension, e.g. mp4, mov, flv, avi.
Example: filename.mp4

The name of the file will be used as the Asset title.
Subtitle File(s) - Optional
This workflow also supports adding subtitle files for the assets.
Please note that subtitle support must be first activated on your account by contacting Icareus.
Supported Formats: WebVTT (.vtt) and SRT (.srt)

Default subtitles:
Subtitle files for default language (can be set on request by Icareus for an account. System default is English) are named as follows:
If master video file is filename.mp4 then subtitle files must be named as filename.srt or filename.vtt

Language specific subtitles:
Subtitle files for different languages must follow a specific naming pattern as follows:
If master video file is filename.mp4 then subtitle files must be named as filename___fi_FI.srt or filename___fi_FI.vtt (triple underscore followed by language identifier). See Supported Languages at the end of this document.
A language specific subtitle will take precedence over a default subtitle for the same language

It is recommended to upload the subtitle files first, i.e. before uploading the video file (in FTP folder) so there is no risk of the subtitles being ignored.


Workflow for Ingesting Videos and Metadata

A master video file with associated metadata file(s) should be uploaded together to the FTP Watch Folder for Icareus Suite to successfully process the content.

Master Video File

The master video file should be a single file with the filename name and a common video file extension, e.g. mp4, mov, flv, avi.
Example: filename.mp4
The name of the file will be used as the Asset title.

Metadata File(s)

To add more detailed metadata for the Asset an metadata file can be accompanied.
Make sure that the properties file has character encoding "UTF-8" (without BOM)
At least one, or multiple metadata files can be provided with the master video file. The metadata files must follow the following naming convention:
  1. Must have the same file name as the video file (as a prefix)
  2. May provide a language variation as a suffix. (see the bottom of this page)
  3. Must have a .properties extension
Examples: filename.properties, filename_en_US.properties, filename_fi_FI.properties, filename_es_ES.properties
SEE "SUPPORTED LANGUAGES" SECTION BELOW

Metadata File format

asset.assetId=1234 (Optional: If need to update an existing asset)
asset.referenceId=ABC123-_=? (Optional)
asset.title=Text in the defined language
asset.description=(Optional)Text in the defined language
asset.genre=12345,67890 (Optional: Single item or comma separated list of IDs)
asset.category=11111,22222 (Optional: Single item or comma separated list of IDs)
asset.tags=Tag1,Tag2 (Optional: Single item or comma separated list)
asset.duration=300 (Optional: Seconds)
asset.quality=0,1,2 or 3 (Optional: 0{SD} by default if not provided. 1 for HD. 2 for QHD, 3 for Ultra HD)
asset.publishStart=2014-10-31 12:00 (Optional)
asset.publishEnd=2014-12-31 12:00  (Optional)
property.ABC=XYZ123
property.XYZ=456JKL
(property. fields can be 0...N, they can contain any custom meta data needed for an object. Using the format: property.FIELDNAME=FIELDVALUE)


SUPPORTED LANGUAGES

Arabic (Saudi Arabia): ar_SA
Basque (Spain): eu_ES
Bulgarian (Bulgaria): bg_BG
Catalan (Andorra): ca_AD
Catalan (Spain): ca_ES
Chinese (China): zh_CN
Chinese (Taiwan): zh_TW
Croatian (Croatia): hr_HR
Czech (Czech Republic): cs_CZ
Danish (Denmark): da_DK
Dutch (Netherlands): nl_NL
Dutch (Belgium): nl_BE
English (United States): en_US
English (United Kingdom): en_GB
Estonian (Estonia): et_EE
Finnish (Finland): fi_FI
French (France): fr_FR
Gallegan (Spain): gl_ES
German (Germany): de_DE
Greek (Greece): el_GR
Hebrew (Israel): iw_IL
Hindi (India): hi_IN
Hungarian (Hungary): hu_HU
Indonesian (Indonesia): in_ID
Italian (Italy): it_IT
Japanese (Japan): ja_JP
Korean (South Korea): ko_KR
Lao (Laos): lo_LA
Norwegian Bokmål (Norway): nb_NO
Persian (Iran): fa_IR
Polish (Poland): pl_PL
Portuguese (Brazil): pt_BR
Portuguese (Portugal): pt_PT
Romanian (Romania): ro_RO
Russian (Russia): ru_RU
Serbian (Serbia): sr_RS
Serbian (Serbia,latin): sr_RS_latin
Slovenian (Slovenia): sl_SI
Slovak (Slovakia): sk_SK
Spanish (Spain): es_ES
Swedish (Sweden): sv_SE
Turkish (Turkey): tr_TR
Ukrainian (Ukraine): uk_UA
Vietnamese (Vietnam): vi_VN



    • Related Articles

    • Video Ingest - Uploading videos

      Introduction Icareus Video Cloud accepts many video formats and transcodes them for online and TV delivery. This page gives you insight how to prepare your master video files for ingest and what are the alternatives to upload your files to Icareus ...

    • Managing Videos

      Introduction VIdeos are the core of Icareus Suite. The management of videos is described in this chapter. Managing Video Assets Add New Videos to Cloud Icareus offers four (4) ways to add content on the platform: Manually via Icareus Suite web user ...

    • As Online Video Platform

      FOR MEDIA COMPANIES, ENTERPRISES AND SPORTS -  Cloud Solution for Your Online Video Services Icareus Online Video Platform customers are media companies, large corporations, SMEs, sports clubs, non-profit organizations and anything in between those ...

    • Youtube - Uploading on-demand videos to YouTube account

      Introduction YouTube is the world's 2nd most used social media service, with 1.9 billion monthly users. YouTube's content volumes are just as staggering. Based on the statistics (2019) every minute YouTube users upload 500 hours of new content to the ...

    • Clipping a video

      Introduction You can clip a video directly in the cloud environment. Clipping means cutting footage from the video into separate video assets. Clipping To open the clipping tool, click the "Clip video" icon next to the video preview on the video ...