dbmd_atmos_parse is a command line utility that parses the Dolby Audio Metadata (DBMD) chunk in a Dolby Atmos Audio Definition Model (ADM) WAV file. The tool displays the status of some Dolby Atmos metadata, including:

• Headphone rendering metadata

• Trim metadata per output speaker configuration

• Warp mode setting

The primary purpose of this code is to help users that need to assess the state of the metadata in an ADM WAV file. Note that this tool only parses the Dolby Atmos metadata segments in the DBMD chunk, it does not parse the ADM XML.

For more information see the release notes.

These instructions will help you get a copy of the project up and running on your local machine for development and testing purposes.

• README.md This file.

• ReleaseNotes.md Release notes.

• LICENSE Terms of use.

• dbmd_atmos_parse/ Main application folder.

  • src/ Source code.

  • make/ Build files.

• sample_files/ Sample Dolby Atmos ADM WAV files.

For Linux and OSX, the library and tool can be built using GNU makefiles. For windows, Visual Studio 2017 projects and solutions are provided. For all platforms, 64-bit targets are supported.

Use the makefiles located in dbmd_atmos_parse/make/. Go to the appropriate directory and run GNU make. Executables are created in the bin/ directory within the same directory as the makefile.

Go to the Windows MSVS directory under dbmd_atmos_parse/make/. In Visual Studio 2017, open the solution file (.sln). Select build solution in Visual Studio. The executable is created in the bin/ directory within the same directory as the solution file.

dbmd_atmos_parse is a command line utility and the usage is provided by running the tool with no options.

Dolby Atmos DBMD Parser (Version 1.1)
Copyright (C) 2020, Dolby Laboratories Inc.

Usage: DBMD_ATMOS_PARSE <input ADM WAV file name> 

To test the basic functionality of the tool, sample ADM WAV files with varying metadata have been provided. These files can be found in the sample_files/ directory. For each sample WAV file, there is a corresponding text file with output from the tool. These files can be used for debugging purposes or verify any modifications.

See the Release Notes file for additional details.

This project is licensed under the BSD-3 License - see the LICENSE file for details