Ingest

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.

Uploading files

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:

  1. Open and sign in to the qibb go! Portal.

    The welcome screen is displayed.

  2. Click on either Ingest or Ingest related actions App links > Upload your assets.

    The Asset Uploader user interface is opened in a new browser tab.

    Asset Uploader

    Figure: Asset Uploader

  3. Select a folder in the ingest storage as target for your upload, by clicking on the Target folder sidebar icon icon on the right side to open the target folder sidebar. Then select the target folder.

    Asset Uploader - Target folder sidebar

    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.

    Tip

    You can also create new folders by using the Create new folder area in the target folder sidebar. To do this, proceed as follows:

    1. Enter the name of the new folder in the Folder name field. Do not use a leading slash but append a closing slash (Example: folder/subfolder/).

    2. To create the folder, click Create.

    The folder list is updated and you can select the newly created folder as target.

  4. Optional (if you want to assign the file to be uploaded to an already existing placeholder asset): Select a placeholder as follows:

    1. Click Assign to placeholder.

      A list of available placeholders is displayed.

      Asset Uploader - List of available placeholders

      Figure: Asset Uploader - List of available placeholders

    2. Use the Search field and/or the paging function to specifically search for a placeholder.

    3. Select a placeholder.

    4. Click Ok.

      The list of placeholders is closed and the name of the selected placeholder is displayed right to the Assign to placeholder button.

      Asset Uploader - Placeholder selected

      Figure: Asset Uploader - Placeholder selected

  5. To select the files to upload, click Add file.

    The file selection window opens.

  6. In the selection window select one or more files and click Open.

    Notice

    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.

    Notice

    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.

    Asset Uploader - Upload started

    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.

    Notice

    The upload speed is not limited. The application will use the full upload bandwidth currently available on client side.

    Asset Uploader - Upload completed

    Figure: Asset Uploader - Upload completed

    Notice

    While uploads are in progress, you can either pause, resume or cancel individual or all uploads via the corresponding buttons.

    Warning

    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.

File processing

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

  • download 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:

  1. Open and sign in to the qibb go! Portal.

    The welcome screen is displayed.

  2. Click on Ingest related actions App links > View your assets.

    The Asset Viewer user interface is opened in a new browser tab.

    Asset Viewer

    Figure: Asset Viewer

  3. 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.

  4. Select a video file.

    The preview player on the right side is loaded.

    Asset Viewer - File selected

    Figure: Asset Viewer - File selected

  5. Use the player controls below the video to preview the file.

  6. To view technical and (if available) descriptive metadata of the selected file, select the Metadata tab at the top of the preview area.

Tip

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.

Tip

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.

Tip

To delete a file, select one or more files in the file list and click Delete.

Housekeeping

q.air provides two workflows for deleting files within the scope of housekeeping: automatic and manual.

Both workflows include the following steps:

  1. Removing the file internally from the q.air system by removing all corresponding database entries

  2. Deleting the file from the ingest storage

  3. Deleting the file from local storage on playout instances

Automatic housekeeping

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

Manual housekeeping allows deleting uploaded files at any time (regardless of the global expiry date) via the q.air Asset Viewer.


Last update: 2021-04-14