The procedure for input handling - AWS Elemental MediaLive

The procedure for input handling


If you plan to remove the color space metadata from all the outputs, there is no point to correcting the metadata. Skip to The procedure for output handling and set Color space to FOLLOW.

To decide how to handle the color space metadata

  1. Contact the content provider to determine what color space or color spaces apply to each video source. One individual source might contain a combination of different color spaces, particularly if the content is a VOD asset that is a few years old.

  2. Find out from the content provider if the color space metadata is accurate. The content might be any of the following:

    • Correctly marked.

    • Incorrectly marked. This case is more common with older SDR content.

    • Unmarked (no color space metadata is present).

    • Marked as unknown.

    • Marked with a color space that MediaLive doesn't support.

    One source content might be any combination of marked, unknown, and unmarked.

  3. Decide if you need to clean up the color space metadata in each input. You can clean up SDR metadata. You can't clean up HDR metadata, but that metadata is usually clean and accurate.

    • If you plan to remove color space metadata from all of the outputs, there is no need to clean it up. You can pass it through to the output as is.

    • If you plan to include color space metadata in at least one output (either passed through from the input, or converted), then you should clean it up, if it's not already clean.

    For information on your choices for different content, see the tables in Cleanup scenarios for color space metadata.

    The following rules apply:

    • Choose one of the cleanup options only if the input is one of the SDR color spaces. (You can't correct HDR content, but typically HDR content is correctly marked.)

    • The cleanup options don't convert the color space metadata. They mark it—MediaLive inserts metadata that is missing, or it changes the metadata for incorrectly marked content.

    • Only clean up the color space if you are sure that all the unmarked portions use the color space that you choose. If the cleanup results in marking content as being in a specific color space when it isn't, then the video color quality will be degraded in the output.

    • If you are planning to convert the color space on the output side, keep in mind that this conversion will apply only to marked content. So if you use cleanup to insert missing metadata, you can increase the percentage of the content that gets converted in the output.

To set up the input

  1. On the Create Channel page, in the Input attachments section, for Video selector, choose Video selector.

  2. Set the appropriate values for Color space and Color space usage. These two fields control correction to the color space metadata.

In the following table, each row shows a valid combination of the two fields and the result of that combination.

Color space field

Color space usage field



This field is ignored.

Passthrough. MediaLive doesn't change the color space metadata.

REC_601 or REC_709


Cleanup. MediaLive marks all the content as using the specified color space.

REC_601 or REC_709


Cleanup. MediaLive marks the content as using the specified color space only for portions of the content that are unmarked or marked as unknown.