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.  


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.