# Dolby Atmos
Dolby Atmos provides an immersive audio experience in cinemas and home theaters. With the right audio input files, you can use AWS Elemental MediaConvert to create Dolby Atmos outputs. You can create streaming outputs that end viewers can experience in their home theaters or file outputs that you can use in your professional workflows.
AWS Elemental MediaConvert can create Dolby Digital Plus with Atmos outputs by either encoding channel-based immersive audio content that you provide as 9.1.6, 7.1.4, or 5.1.4 PCM mono channels, or by passing through already encoded Dolby Digital Plus with Atmos content.
**Topics**
+ [Configuring Dolby Atmos encoding](using-dolby-atmos-encoding.md)
+ [Requirements for Dolby Atmos encoding](feature-restrictions-for-dolby-atmos-encoding.md)
+ [Configuring Dolby Atmos passthrough](using-dolby-atmos-passthrough.md)
+ [Feature Restrictions for Dolby Atmos Passthrough](feature-restrictions-for-dolby-atmos-passthrough.md)
# Configuring Dolby Atmos encoding
AWS Elemental MediaConvert can encode Dolby Digital Plus with Atmos channel-based, immersive audio, Audio Definition Model Broadcast WAV files, or Dolby Atmos Master File.
**Note**
Understanding Dolby Atmos is required prerequisite knowledge for using this feature. Your input audio channels must already be set up according the Dolby Atmos standard you are using as input. For more information about Dolby Atmos, see the Dolby online documentation.
## Setting up a job for Dolby Atmos encoding
AWS Elemental MediaConvert can encode Dolby Digital Plus with Atmos channel-based, immersive audio, Audio Descriptive Model Broadcast WAV files, or Dolby Atmos Master File.
**Note**
Understanding Dolby Atmos is required prerequisite knowledge for using this feature. Your input audio channels must already be set up according the Dolby Atmos standard you are using as input. For more information about Dolby Atmos, see the Dolby online documentation.
For more details about setting up your job for Dolby Atmos encoding, see one of the following procedures:
[Procedure with separate audio input files](#proc-atmos-separate-input-files)
[Procedure with a single audio input file](#proc-atmos-single-input-file)
**To set up a Dolby Atmos job, with audio inputs as 16 individual .wav files**
1. Open the MediaConvert console at [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert).
1. Choose **Create job**.
1. Set up your input video as described in [Tutorial: Configuring job settings](setting-up-a-job.md).
1. Set up your input audio selectors as follows:
1. On the **Create job** page, in the **Job** pane on the left, choose **Input**.
1. On the right, in the **Audio selectors** section, under **Audio selector 1**, choose **External file**.
1. For **External file**, provide the path and file name to the .wav file for your first channel. For **Audio selector 1**, this channel must be L.
**Important**
You must set up the channels in the following order: L, R, C, LFE, Ls, Rs, Lrs, Rrs, Lw, Rw, Ltf, Rtf, Ltm, Rtm, Ltr, Rtr.
That is, if your input audio is in separate .wav files, **Audio selector 1** must point to the L channel, **Audio selector 2** must point to the R channel, and so on.
1. At the top of the **Audio selectors** section, choose **Add audio selector** to create **Audio selector 2**.
1. Under **Audio selector 2**, choose **External file**.
1. Specify the path and file name to the .wav file for your second channel. For **Audio selector 2**, this channel must be R.
1. Repeat the steps to create an audio selector for the rest of your 16 channels. Choose the following channels for each selector:
+ **Audio selector 3**: C
+ **Audio selector 4**: LFE
+ **Audio selector 5**: Ls
+ **Audio selector 6**: Rs
+ **Audio selector 7**: Lrs
+ **Audio selector 8**: Rrs
+ **Audio selector 9**: Lw
+ **Audio selector 10**: Rw
+ **Audio selector 11**: Ltf
+ **Audio selector 12**: Rtf
+ **Audio selector 13**: Ltm
+ **Audio selector 14**: Rtm
+ **Audio selector 15**: Ltr
+ **Audio selector 16**: Rtr
1. Create an input **Audio selector group** as follows:
1. In the **Audio selector groups** section, choose **Add audio selector group**.
1. For **Group name**, enter a descriptive name, such as **Dolby Atmos Audio Group**.
1. For **Select audio selectors**, choose each audio selector that you created earlier in this procedure. Choose them in order, starting with **Audio selector 1**.
1. Set up your output groups, outputs, and video output selectors as described in [Tutorial: Configuring job settings](setting-up-a-job.md) and [Creating outputs](output-settings.md). Choose supported containers as listed in [Requirements for Dolby Atmos encoding](feature-restrictions-for-dolby-atmos-encoding.md).
1. Create audio output selectors as described in [Tutorial: Configuring job settings](setting-up-a-job.md) and [Creating outputs](output-settings.md).
Set them up as follows:
1. In the **Job** pane on the left, choose an output that includes audio.
1. In the **Encoding settings** section, choose **Audio 1**.
1. For **Audio codec**, choose **Dolby Digital Plus JOC (Atmos)**.
For **Audio source**, choose the audio selector group that you created earlier in this procedure, such as **Dolby Atmos Audio Group**.
1. For the audio encoding settings, choose values that are suitable for your workflow. For more information, see the Dolby documentation for the Dolby Digital Plus Atmos encoding library.
**Note**
AWS Elemental MediaConvert automatically performs audio normalization on Dolby Digital Plus Atmos outputs. Therefore, there is no **Dialnorm** setting under audio encoding settings.
**To set up a Dolby Atmos job, with audio input as a single file with 16 tracks**
1. Open the MediaConvert console at [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert).
1. Choose **Create job**.
1. Set up your input video as described in [Tutorial: Configuring job settings](setting-up-a-job.md).
1. Set up your input audio selectors as follows:
1. On the **Create job** page, in the **Job** pane on the left, choose **Input**.
1. On the right, in the **Audio selectors** section, under **Audio selector 1**, choose **External file**.
1. For **External file**, provide the path and file name to the .wav file.
1. For **Selector type**, choose **Track**.
1. For **Tracks**, list your 16 PCM mono tracks in a comma-separated list. Specify them in the following order: L, R, C, LFE, Ls, Rs, Lrs, Rrs, Lw, Rw, Ltf, Rtf, Ltm, Rtm, Ltr, Rtr.
+ If the tracks of your input audio file are already in that order, then list them that way: **1, 2, 3, … 16**.
+ If the tracks of your input audio file are in a different order, list them according to the specified order. For example, if your L channel is in track 3, then list **3** first.
1. Set up your output groups, outputs, and video output selectors as described in [Tutorial: Configuring job settings](setting-up-a-job.md) and [Creating outputs](output-settings.md). Choose supported containers as listed in [Requirements for Dolby Atmos encoding](feature-restrictions-for-dolby-atmos-encoding.md).
1. Create audio output selectors as described in [Tutorial: Configuring job settings](setting-up-a-job.md) and [Creating outputs](output-settings.md).
Set them up as follows:
1. In the **Job** pane on the left, choose an output that includes audio.
1. In the **Encoding settings** section, choose **Audio 1**.
1. For **Audio codec**, choose **Dolby Digital Plus JOC (Atmos)**.
For **Audio source**, keep the default **Audio selector 1**.
1. For the audio encoding settings, choose values that are suitable for your workflow. For more information, see the Dolby documentation for the Dolby Digital Plus Atmos encoding library.
**Note**
AWS Elemental MediaConvert automatically performs audio normalization on Dolby Digital Plus Atmos outputs. Therefore, there is no **Dialnorm** setting under audio encoding settings.
# Requirements for Dolby Atmos encoding
Note the following restrictions in the MediaConvert implementation of Dolby Atmos encoding:
+ **Input Channel-Based Immersive (CBI):** MediaConvert supports channel-based immersive (CBI) content.
+ **Input Dolby Atmos Master File (DAMF):** MediaConvert supports Dolby Atmos master file (DAMF). This is a collection of 3 files with the extensions, .atmos, .atmos.metadata, and .atmos.audio
+ **Input Immersive Audio Bitstream (IAB):** MediaConvert supports immersive audio bistream (IAB).
+ **Input Audio Definition Model Broadcast WAV Format (ADM BWF):** MediaConvert supports ADM BWF. It is a single broadcast WAV file contains header data with the .atmos and .atmos.metadata information.
+ **Output codec:** You can create Dolby Atmos audio outputs encoded with only the Dolby Digital Plus (EAC3) codec.
+ **Output containers:** For file outputs, you can create Dolby Atmos audio in only in one of the video containers that supports Dolby Digital Plus: MPEG-4, MPEG-2 Transport Stream, or QuickTime.
+ **Output packages:** For adaptive bitrate (ABR) outputs, you can create Dolby Atmos audio in any of the MediaConvert output group types: CMAF, Apple HLS, DASH ISO, or Microsoft Smooth Streaming.
# Configuring Dolby Atmos passthrough
AWS Elemental MediaConvert can create Dolby Digital Plus with Atmos outputs by either encoding audio in 9.1.6, 7.1.4, or 5.1.4 PCM mono channels, or by passing through already encoded Dolby Digital Plus with Atmos content.
You set up your job to pass through Dolby Digital Plus with Atmos content in the same way that you pass through Dolby Digital and Dolby Digital Plus content.
**To set up a Dolby Atmos job, passing through finished audio content**
1. Open the MediaConvert console at [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert).
1. Choose **Create job**.
1. Set up your input audio and video as described in [Tutorial: Configuring job settings](setting-up-a-job.md).
1. Set up your output groups, outputs, and video output selectors as described in [Tutorial: Configuring job settings](setting-up-a-job.md) and [Creating outputs](output-settings.md). Choose supported containers as listed in [Supported output formats](reference-codecs-containers.md).
1. Create audio output selectors as described in [Tutorial: Configuring job settings](setting-up-a-job.md) and [Creating outputs](output-settings.md).
Set them up as follows:
1. In the **Job** pane on the left, choose an output that includes audio.
1. In the **Encoding settings** section, choose **Audio 1**.
1. For **Audio codec**, choose **Passthrough**.
# Feature Restrictions for Dolby Atmos Passthrough
Note the following restrictions in the AWS Elemental MediaConvert implementation of Dolby Atmos passthrough:
+ **Output codec:** You can create Dolby Atmos audio outputs encoded with only the Dolby Digital Plus (EAC3) codec.
+ **Output containers:** For file outputs, you can create Dolby Atmos audio in only one of the video containers that supports Dolby Digital Plus: MPEG-4, MPEG-2 Transport Stream, or QuickTime.