<p>
-When you have finished mixing your session, you probably want to export it to a sound
-file to burn to a CD, upload to the web, or whatever. <kbd class="menu">Session > Export > Export to Audio file(s)…</kbd>
-shows the Export Dialog to do this.
-
-</p>
-<p>
-You can also export the outputs of multiple tracks & busses all at once via
-<kbd class="menu">Session > Export > Stem Export…</kbd>.
+ 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 > Export >
+ Export to Audio file(s)…</kbd>.
</p>
+<figure class="right">
+ <img width="50%" src="/images/export-dialog-file-format.png" alt="The Export window">
+ <figcaption>
+ The Export window
+ </figcaption>
+</figure>
+
<h2>File Format</h2>
-<img src="/images/export-dialog-file-format.png" />
+
<p>
-This tab contains controls for the format of the exported audio file.
-You can enable more than one format here, in which case each will be exported in turn.
-Ardour is supplied with a list of export formats, including:
+ 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>CD (Red Book)</li>
-<li>DVD-A</li>
-<li>FLAC 24 bit </li>
-<li>FLAC 24 bit (tagged)</li>
-<li>Ogg_Vorbis</li>
-<li>Ogg_Vorbis (tagged)</li>
-<li>Ring Tone</li>
+ <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>
-You can edit these formats, or create your own, with the <a href="@@export-format-profiles">"Edit Export Format Profile"</a> dialog, which
-appears when you click the "Edit" or "New" button to the right of the drop-down list of formats.
+
+<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>
-You can also create a 'Preset' consisting of one or more formats. Ardour provides some ready-made presets, too:
+ Presets can also be created, consisting of one or more formats. Ardour
+ provides some ready-made presets, too:
+</p>
<ul>
-<li>CD + DVD-A</li>
-<li>CD + FLAC</li>
-<li>CD + FLAC (tagged)</li>
-<li>CD + Ogg_Vorbis + FLAC (tagged)</li>
-<li>CD + Ogg_Vorbis</li>
-<li>CD + Ogg_Vorbis (tagged)</li>
+<li>CD + Ogg/Vorbis + FLAC</li>
<li>CD only</li>
<li>DVD-A only</li>
<li>FLAC</li>
-<li>FLAC (tagged)</li>
-<li>Ogg_Vorbis + FLAC</li>
-<li>Ogg_Vorbis + FLAC (tagged)</li>
-<li>Ogg_Vorbis </li>
-<li>Ogg_Vorbis (tagged)</li>
+<li>Ogg/Vorbis</li>
+<li>Ogg/Vorbis + FLAC</li>
+<li>Streaming</li>
</ul>
-</p>
-<h3>Soundcloud upload</h3>
+<h2>The location</h2>
+
<p>
-When 'Upload to Soundcloud' is ticked on in any format's tab, a pane containing fields
-to enter in Soundcloud account details (email and password), and what should happen
-to the uploaded files will become visible.
+ 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>
-<img src="/images/soundcloud-upload.png" />
<p>
-<dl>
-<dt>Make files public</dt><dd>Choose whether to make uploaded files available to anyone via the Soundcloud web site.</dd>
-<dt>Open uploaded files in browser</dt><dd>Open each file on soundcloud in your browser after upload.
-If you don't enable this, you can still see the URLs in the <a href="">Log window</a>.</dd>
-<dt>Make files downloadable</dt><dd>Choose whether to allow downloading of files uploaded to Soundcloud.</dd>
-</dl>
+ 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>Analyze exported audio</h2>
+<figure>
+ <img width="50%" src="/images/export-report-analysis.png" alt="The Export Report/Analysis window">
+ <figcaption>
+ The Export Report/Analysis window
+ </figcaption>
+</figure>
-<h2>Time Span</h2>
-<img src="/images/export-dialog-timespan.png" />
<p>
-This tab allows you to select the range (or ranges) of the timeline to export. By default, "session" is
-enabled—this will export the whole session from the start marker to the end marker.
+ 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>Time Span</h2>
-<h2>Channels</h2>
-<img src="/images/export-dialog-channels.png" />
+<figure>
+ <img width="50%" 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—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>
-Here you can choose which outputs (tracks or busses) should be sent to the exported file.
+ 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>Stem Export</h2>
-<img src="/images/export-dialog-stem-export.png" />
+<h2>Channels</h2>
+
+<figure>
+ <img width="50%" src="/images/export-dialog-channels.png" alt="The Channels tab">
+ <figcaption>
+ The Channels tab
+ </figcaption>
+</figure>
+
<p>
-If you chose 'Stem Export', the 'Channels' tab appears slightly differently:
-in this case each chosen channel (track or bus) is exported to its own file,
-instead of all channels being mixed together into a single file. You can
-choose to export either the region contents or the track output here in this
-case.
+ This tab decides which outputs (tracks or busses) should be sent to the exported
+ file. By default, only the Master Bus is sent.
</p>
projects / ardour-manual / blobdiff