Introduction
This article describes how migrations from other video cloud services are handled when importing content into Icareus Video Cloud.
Dreambroker
Before migration
Because importer fetches data from Dreambroker channels, every video that needs to be imported must be included in a channel.
The importer fetches video data from their web pages, which is why the relevant channels and videos must be public during the import.
The time required to import each channel depends on the number of videos in that channel.
During migration
The importer creates a folder for each Dreambroker channel. Every video in that channel is added to the corresponding folder in Icareus Video Cloud.
If the Dreambroker channel has categories, the importer creates the same category structure as subfolders under the channel folder in Icareus Video Cloud. Videos are placed in the matching subfolders.
The importer also tries to import the following metadata and related assets, if they exist:
- subtitles
- chapters
- thumbnail
- publishing times
- the video’s unique Dreambroker ID
The Dreambroker video ID can later be used to find the same video in Icareus Video Cloud.
The importer does not create a master video file. Instead, it imports the video qualities provided by Dreambroker as presets in Icareus Video Cloud. As a result, the video should have the same number of presets in Icareus Video Cloud as it had available qualities in Dreambroker.
After migration
After the migration, you can review the imported videos in Media Library of the admin interface. The videos are grouped into folders based on their original Dreambroker channels.
Ubicast
Before migration
Ubicast migrations use the Ubicast API. This means that an API key is required. A new API key can be created in the Ubicast admin interface.
All data to be imported must be available through the API key, including subtitles and other related assets.
The importer only imports videos stored in Ubicast. Ubicast can also contain videos where the source is hosted outside Ubicast, for example on YouTube. These external videos are ignored during the migration.
The importer does not import users or user groups into Icareus Video Cloud. It fetches this information and stores it in local files, but currently this information is not used during the import.
During migration
The importer tries to import all following data:
- video files
- subtitles
- thumbnails
- categories
The importer also preserves the category tree structure as folders and subfolders.
The importer does not create master video files. Instead, it imports the quality files provided by Ubicast and saves them as presets in Icareus Video Cloud.
After all qualities have been imported, the importer automatically creates a new SMIL file. This allows the videos to work with dynamic players immediately.
After migration
After the migration, you can review the imported videos in the Media Library of the admin interface. The videos are grouped according to the imported Ubicast category structure.
YuJa
Before migration
YuJa migrations use the YuJa API. This means that an API key is required.
The name of the YuJa API server is also required. It is typically in the following format: https://<organization>.yuja.com
Because YuJa allows different permissions for each API key, the API key must have access to at least the following API fronts:
- Services/users/
- Services/videos/user/
- Services/media/video/
- Services/media/videos/
- Services/media/folders/
- Services/media/retrievefolderassets/
During migration
The importer tries to import the following data:
- users, including creators and admins
- videos
- subtitles
- thumbnails
- folders
- indexes
YuJa indexes are saved as chapters in Icareus Video Cloud.
Videos are imported to the user who created the video in YuJa. Each user gets their own folder in Icareus Video Cloud, and the videos are saved under the same folder structure as they were in YuJa.
If subtitles are provided as SRT files, they are converted to VTT files before they are saved in Icareus Video Cloud.
After migration
After the migration, you can review the imported videos in the Media Library of the admin interface. No additional YuJa-specific actions are required after the import.
Additional
Subtitles
Icareus currently supports VTT subtitle files. If your source service uses SRT files or another subtitle format, please mention this before the migration.
SRT files can be converted to VTT, but this must be handled separately in the importer.
Embed video URLs