The purpose of the ingest workflow is to provide new video files to the playout. After each successful upload the corresponding file is automatically processed by q.air. When the internal file processing is completed, the uploaded file is registered in q.air and can be scheduled for playout.
Manual file upload via q.air Asset Uploader¶
The ingest process starts with the file upload. For this purpose, q.air includes the q.air Asset Uploader, a web application for uploading files to the ingest storage.
With q.air Asset Uploader you can either upload a new file to the system, creating a completely new asset or you can assign the file to be uploaded to a placeholder asset that already exists in the system. A placeholder is a virtual element, that can be used to schedule a file for playout, that is not yet available (that has not yet been created). By using this concept, playlists can already be prepared via the planning component, even if the actual files are created later.
Via q.air Asset Uploader each uploaded file can be linked to placeholder. As a result, the uploaded file replaces the placeholder everywhere it is used in the planning component.
To upload a file, proceed as follows:
The welcome screen is displayed.
Click on either Ingest or Ingest related actions > Upload your assets.
The Asset Uploader user interface is opened in a new browser tab.
Figure: Asset Uploader
Select a folder in the ingest storage as target for your upload, by clicking on the icon on the right side to open the target folder sidebar. Then select the target folder.
Figure: Asset Uploader - Target folder sidebar
The folder is selected and the sidebar is closed. The name of the selected folder is displayed above the upload list.
You can also create new folders by using the Create new folder area in the target folder sidebar. To do this, proceed as follows:
Enter the name of the new folder in the Folder name field. Do not use a leading slash but append a closing slash (Example:
To create the folder, click Create.
The folder list is updated and you can select the newly created folder as target.
Optional (if you want to assign the file to be uploaded to an already existing placeholder asset): Select a placeholder as follows:
Click Assign to placeholder.
A list of available placeholders is displayed.
Figure: Asset Uploader - List of available placeholders
Use the Search field and/or the paging function to specifically search for a placeholder.
Select a placeholder.
The list of placeholders is closed and the name of the selected placeholder is displayed right to the Assign to placeholder button.
Figure: Asset Uploader - Placeholder selected
To select the files to upload, click Add file.
The file selection window opens.
In the selection window select one or more files and click Open.
If you selected a placeholder as described in the optional step 7, you can only select a single file. If no placeholder is selected, you can select multiple files.
Depending on how the q.air Asset Uploader is configured, only allowed file types can be selected and uploaded. It is possible to allow any file type or to restrict the allowed file types to e.g. MP4 files only. In this case only files of this type would be displayed in the selection window and could be selected.
The selected files are added to the upload list and the upload starts automatically.
Figure: Asset Uploader - Upload started
During the upload process the progress of each upload is displayed, including current upload speed, amount of uploaded data and overall upload percentage. Completed uploads are highlighted with a green status.
The upload speed is not limited. The application will use the full upload bandwidth currently available on client side.
Figure: Asset Uploader - Upload completed
While uploads are in progress, you can either pause, resume or cancel individual or all uploads via the corresponding buttons.
Don't close your browser while uploads are in progress. Otherwise your upload progress will be lost.
When a file upload is completed, the file processing starts automatically.
After each successful upload, the internal file processing is automatically triggered. When it is completed, the uploaded files are registered in q.air and can be scheduled for playout.
File processing includes the following steps:
|No.||Step||Purpose||Input (uploaded) file format||Output file format|
|1||Creating a low-res (proxy) video file |
This is only necessary, if original files are uploaded in a format other than MP4.
|Web-based preview of the video file||MXF or any other source video format||MP4|
|2||Creating a thumbnail image||Display the image in the user interface||Created from uploaded source video file||PNG|
|3||Determine technical metadata||Optimized internal file processing, display file information in the user interface||Created from uploaded source video file||XML|
|4||Creating a proxy subtitle file |
This is only necessary, if matching subtitles are uploaded for the original video file.
|Web-based preview of the video file including subtitles||SRT||VTT|
Previewing uploaded files¶
For previewing uploaded files, q.air includes the q.air Asset Viewer web application.
It provides the following features:
list all files contained in the ingest storage
preview media files including optional additional graphic overlays
display closed captions for video files
manually delete files and folders
manually trigger file processing
display additional file metadata
IAM-based security for secure file access
To preview uploaded and processed files, proceed as follows:
The welcome screen is displayed.
Click on Ingest related actions > View your assets.
The Asset Viewer user interface is opened in a new browser tab.
Figure: Asset Viewer
To find a specific file, either enter a term (e.g. a file name or a file type/extension) in the Search field above the file list or use the paging buttons below the file list.
Select a video file.
The preview player on the right side is loaded.
Figure: Asset Viewer - File selected
Use the player controls below the video to preview the file.
To view technical and (if available) descriptive metadata of the selected file, select the Metadata tab at the top of the preview area.
File processing is usually triggered automatically and does not require manual action. If proxy files are not created as expected, you can also manually trigger file processing, by internally simulating a file change.
To do this, select one or more files in the file list and click Trigger change. The file processing workflow is started and proxy files should be created as expected.
You can check the current file processing state via the File processing list.
To download a file, select it in the file list, select the Metadata tab at the top of the preview area and in the Common area click Download.
To delete a file, select one or more files in the file list and click Delete.
q.air provides two workflows for deleting files within the scope of housekeeping: automatic and manual.
Both workflows include the following steps:
Removing the file internally from the q.air system by removing all corresponding database entries
Deleting the file from the ingest storage
Deleting the file from local storage on playout instances
Automatic housekeeping deletes files automatically based on their expiry date. This time period is globally configured and the actual expiry date is calculated individually for each uploaded file based on this setting. When the expiry date is reached, the corresponding file is automatically deleted.
It is possible to configure protected folders, that are excluded from housekeeping. Files uploaded to these folders are never automatically deleted, even if the global expiry date is reached.
Manual housekeeping allows deleting uploaded files at any time (regardless of the global expiry date) via the q.air Asset Viewer.