manual/include/export-dialog.html

<p>
  When the work in Ardour is finished, one or multiple sound file(s) need to be
  created, be it to be printed to a medium such as a CD or DVD, uploaded to a
  streaming site or sent to another person or software for further work. This
  can be done either using <kbd class="menu">Session &gt; Export &gt;
  Export to Audio file(s)&hellip;</kbd>.
</p>

<figure class="right">
  <img class="hdimage" src="/images/export-dialog-file-format.png" alt="The Export window">
  <figcaption>
    The Export window
  </figcaption>
</figure>

<h2 id="export-file_format">File Format</h2>

<p>
  This tab contains controls for the format of the exported audio file(s).
  More than one format can be enabled here, in which case each will be exported in turn.
  Ardour is supplied with a list of export formats, including:
</p>

<ul>
  <li>Amazon Music</li>
  <li>Apple Music</li>	
  <li>BWAV 24bit</li>
  <li>BWAV 32float</li>
  <li>CD (Red Book)</li>
  <li>FLAC 24 bit </li>
  <li>MP3 (extreme)</li>
  <li>MP3 (medium)</li>
  <li>MP3 (standard)</li>
  <li>Ogg/Vorbis</li>
  <li>Ring Tone</li>
  <li>Soundcloud and Spotify</li>
  <li>Wav (Tagged)</li>
  <li>YouTube and Deezer</li>
</ul>

<p>
  These formats can be edited, or new ones created, with the <a
  href="@@export-format-profiles">"Edit Export Format Profile"</a> dialog, which
  appears when clicking the <kbd class="menu">Edit</kbd> or
  <kbd class="menu">New</kbd> buttons to the right of the drop-down list of
  formats.
</p>

<p>
  Presets can also be created, consisting of one or more formats. Ardour
  provides some ready-made presets, too:
</p>

<ul>
<li>CD + Ogg/Vorbis + FLAC</li>
<li>CD only</li>
<li>DVD-A only</li>
<li>FLAC</li>
<li>Ogg/Vorbis</li>
<li>Ogg/Vorbis + FLAC</li>
<li>Streaming</li>
</ul>

<h2 id="export-location">The location</h2>

<p>
  Aside from providing a way to tell Ardour <em>where</em> to put the created file(s),
  the <dfn>location</dfn> part of the window allows to name the exported files with
  a lot of choice regarding the naming convention, hence blending into the user's
  workflow, and providing a clean way to keep the export folders from being cluttered
  with poorly named files.
</p>
<p>
  The name of the file(s) can optionally be made of:
</p>

<ul>
  <li>The session or snapshot's name</li>
  <li>A custom label (i.e., any text)</li>
  <li>A revision number</li>
  <li>The name of the timespan (see below)</li>
  <li>A date (in multiple formats)</li>
  <li>A time (also in multiple format).</li>
</ul>

<p class="note">
  As in the screenshot above, when writing a file could erase a present file with
  the same name, Ardour shows a yellow warning line in the bottom of the window, and
  a button to list all the files that would be erased and replaced.
</p>

<h2 id="export-overwrite">Overwriting Files</h2>

<p>
  Ardour checks whether exporting will overwriting existing files. If such
  files are discovered, it will display a warning in the lower right corner
  of the window. Clicking the <kbd>List files</kbd> button next to the message
  will display the list of file that will be overwritten.
</p>

<figure>
  <img class="hdimage" src="/images/export-overwrite-files.png" alt="List of files to be overwritten">
  <figcaption>
    List of files to be overwritten
  </figcaption>
</figure>

<h2 id="export-analyze">Analyze exported audio</h2>

<figure>
  <img class="hdimage"
    src="/images/export-report-analysis.png"
    alt="The Export Report/Analysis window"
    width="50%" >
  <figcaption>
    The Export Report/Analysis window
  </figcaption>
</figure>

<p>
  Checking <kbd class="option">Analyze Exported Audio</kbd> shows the Export Report/Analysis
  window. This provides a lot of useful information about the exported file:
</p>
<ul>
  <li>the file name and location</li>
  <li>its format</li>
  <li>its channel count</li>
  <li>its sample rate</li>
  <li>its duration and timecode.</li>
</ul>
<p>
  It also allows to <kbd class="menu">Play</kbd> the file, and the <kbd class="menu">
  Open Folder</kbd> button gives a quick access to the place where it has been created.
</p>
<p>
  The most prominent feature though, are the two generated views of the audio file
  in time (waveform) and frequency (sonograph) domain, and the loudness
  analysis, giving:
</p>
<ul>
  <li>the Peak value</li>
  <li>the True Peak value (to take inter sample peaks into account)</li>
  <li>the Normalization Gain (if it has been applied)</li>
  <li>the Integrated Loudness</li>
  <li>the loudness range</li>
  <li>a graph of the multiplicity of the peaks at the different loudness levels.</li>
</ul>

<h2 id="export-timespan">Time Span</h2>

<figure>
  <img class="hdimage" src="/images/export-dialog-timespan.png" alt="The Time Span tab">
  <figcaption>
    The Time Span tab
  </figcaption>
</figure>

<p>
  This tab allows to select the range (or ranges) of the timeline to export. By default, "session" is
  enabled&mdash;this will export the whole session from the start marker to the end marker.
  Any loop or range present in the session can be chosen, or a combination thereof.
</p>
<p>
  The realtime checkboxes allow to export audio as it is played,
  and not freewheeling to render the file as fast as Ardour can. This can prevent
  odd behaviours from some plugins (reverbs, etc...). This can be chosen globally
  (with the <kbd class="option">Realtime Export</kbd> checkbox at the top) or individually on a per time span basis, with
  the <kbd class="option">RT</kbd> checkbox next to each time span.
</p>

<h2 id="export-channels">Channels</h2>

<figure>
  <img class="hdimage" src="/images/export-dialog-channels.png" alt="The Channels tab">
  <figcaption>
    The Channels tab
  </figcaption>
</figure>

<p>
  This tab decides which outputs (tracks or busses) should be sent to the exported
  file. By default, only the Master Bus is sent.
</p>