Operations like this are done by writing a so-called “stitch.xml” file and load it into the Atmos Conversion Tool. By clicking on “Start converting” the stitch.xml file will be executed and a new master file will be created as the output. It´s possible to do a framerate and/or format conversion at the same time.


As a starting point you should use the example file act_logo_stitch.xml attached to this article.  Similar example files are included with the Atmos Conversion Tool installer, you will find them at /Applications/Dolby/Dolby Atmos Conversion Tool/Examples/ (Mac) or C:\Program Files\Dolby\Dolby Atmos Conversion Tool\Examples (PC). 

Stitch.xml files can be opened and edited in any text editor.


The file is already prepared with two “sources”. Your logo-audio will be the first source, and the main-feature will be the second source. If you need to add multiple logos, you can add more sources, by copy pasting the text block starting with <source> and ending with </source>. Every source has four parameters associated to it, which you need to edit to create a valid stitch file:


<path> Here you need to provide the full file path of each source master file (for example the logo audio and the main-feature audio). Master files can be in the format .atmos, ADM.wav, .rpl or .mxf.

<sourceStart> This is the timecode of the “First Frame of Action”, aka the timecode where the master file starts. Typically, master files start at the full hour or at 8 seconds if there´s a technical leader.

<outputStart> This is the timecode where the master file will start in the final “stitched” output file. The logo can start, for example, at 00:00:00:00 or at the full hour 01:00:00:00. The main feature audio will start at the timecode where the logo ends. For example, if the logo ends at TC 01:00:30:00, the main-feature should start at this timecode. Refer to your picture reference to find the exact timecodes.

<outputEnd> This is the timecode where the master file ends.  This line is optional. Without this line, the start of the next master file automatically defines the end of the previous master file.


A few things to note:

  • All commands in the stitch file are case-sensitive.
  • Make sure that the <framerate> matches your original content. The tool doesn´t support stitching master files with different framerates.
  • You have to define one master to be the “primary source”. This is indicated by the text <source primary=”true”>. Certain global metadata information is taken from the “primary master” and copied to the output file. Refer to the Dolby_Atmos_Conversion_Tool_v1.9_Software_Guide for more information.