Upload media and metadata in a bulk
If you have several assets that you need to upload we understand that uploading them one by one through the console is tiresome and inefficient. We can, therefore, give you access to your dedicated bucket (S3) in the Amazon web service environment (AWS). This is the fastest way to upload bigger amounts of media files and their metadata. If you want to use this process please contact support@magine.com and we will give you access. Please follow this guide for connecting to the S3 bucket.
Requirements for uploading directly to the S3 bucket
- An asset consists of one media file following our specifications
- Subtitle files and metadata files are optional
- If you upload a metadata file specify it as a JSON file.
- All filenames and the source AssetId must match the following regular expression [-_a-zA-Z0-9]. Please use only alphanumeric characters, dash, and underscore. No whitespace or punctuation is allowed.
The folder structure in your S3 bucket
Your S3 bucket has three dedicated paths:
- /vod
- /trailers
- /epg
When uploading directly to the S3 create a folder for every asset in the dedicated path following this structure:
source_id/
├── source_id.json (optional)
├── source_id.mp4
├── source_id-poster.jpg (optional - referenced from .json)
├── source_id-square.jpg (optional - referenced from .json)
├── source_id-eng.srt
├── source_id-swe.srt
A show consists only of a metadata file and has no video or subtitle tracks connected. Instead, a show has a groupID that connects the file with episodes that have the same groupID.
Starting the transcoding process
After you upload any video media (.mp4 files), the platform will automatically probe the file, to quality check the file format and media specifications.
You can then start the transcode process via:
- Magine Pro Console and start the transcoding process from the Storage & Transcoding section.
- Use the Magine Pro Platform API, when using this API end point, you need to supply the Media Format (Resolution, Framerate etc of your media file - this is the same data that can be found in Console, after the Media has been probed)