Skip to content

AudioNormalizationSettings

Source code in docs_src/capo_mediaconvert/types/audio_normalization_settings.py
class AudioNormalizationSettings(TypedDict, closed=True):
    algorithm: NotRequired[
        "capo_mediaconvert.types.audio_normalization_algorithm.AudioNormalizationAlgorithm"
    ]
    """Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1."""
    algorithm_control: NotRequired[
        "capo_mediaconvert.types.audio_normalization_algorithm_control.AudioNormalizationAlgorithmControl"
    ]
    """When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted."""
    correction_gate_level: NotRequired[
        "capo_mediaconvert.types.__integer_min_negative70_max0.__integerMinNegative70Max0"
    ]
    """Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected."""
    loudness_logging: NotRequired[
        "capo_mediaconvert.types.audio_normalization_loudness_logging.AudioNormalizationLoudnessLogging"
    ]
    """If set to LOG, log each output's audio track loudness to a CSV file."""
    peak_calculation: NotRequired[
        "capo_mediaconvert.types.audio_normalization_peak_calculation.AudioNormalizationPeakCalculation"
    ]
    """If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness."""
    target_lkfs: NotRequired[
        "capo_mediaconvert.types.__double_min_negative59_max0.__doubleMinNegative59Max0"
    ]
    """When you use Audio normalization, optionally use this setting to specify a target loudness. If you don't specify a value here, the encoder chooses a value for you, based on the algorithm that you choose for Algorithm. If you choose algorithm 1770-1, the encoder will choose -24 LKFS; otherwise, the encoder will choose -23 LKFS."""
    true_peak_limiter_threshold: NotRequired[
        "capo_mediaconvert.types.__double_min_negative8_max0.__doubleMinNegative8Max0"
    ]
    """Specify the True-peak limiter threshold in decibels relative to full scale (dBFS). The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Enter a value from 0 to -8. Leave blank to use the default value 0."""

algorithm instance-attribute

algorithm: NotRequired[AudioNormalizationAlgorithm]

Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.

algorithm_control instance-attribute

algorithm_control: NotRequired[AudioNormalizationAlgorithmControl]

When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.

correction_gate_level instance-attribute

correction_gate_level: NotRequired[__integerMinNegative70Max0]

Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected.

loudness_logging instance-attribute

loudness_logging: NotRequired[AudioNormalizationLoudnessLogging]

If set to LOG, log each output's audio track loudness to a CSV file.

peak_calculation instance-attribute

peak_calculation: NotRequired[AudioNormalizationPeakCalculation]

If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness.

target_lkfs instance-attribute

target_lkfs: NotRequired[__doubleMinNegative59Max0]

When you use Audio normalization, optionally use this setting to specify a target loudness. If you don't specify a value here, the encoder chooses a value for you, based on the algorithm that you choose for Algorithm. If you choose algorithm 1770-1, the encoder will choose -24 LKFS; otherwise, the encoder will choose -23 LKFS.

true_peak_limiter_threshold instance-attribute

true_peak_limiter_threshold: NotRequired[__doubleMinNegative8Max0]

Specify the True-peak limiter threshold in decibels relative to full scale (dBFS). The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Enter a value from 0 to -8. Leave blank to use the default value 0.