3 <img src="/images/edit-export-format-profile.png" alt="The 'Edit Export Format Profile' dialog">
5 The 'Edit Export Format Profile' dialog
10 An Export Format Profile specifies the file format in which Ardour will export
11 audio files, and also other audio file export options.
14 Export Format Profiles are edited via the <kbd class="menu">Edit Export Format
20 The <kbd class="menu">Label</kbd> field allows to choose the name which will be
21 shown for this format in the drop-down list of export formats in the
22 'File Formats' tab of the <a href="@@export-dialog">Export dialog</a>.
27 If enabled, levels of exported files will be normalized to the level chosen here.
28 The normalization can be either:
32 <li>Peak, which adjusts the gain to bring the highest signal peak to the
33 chosen level (in <acronym title="decibels relative to full scale">dBFS</acronym>),
35 <li>Loudness, which adjusts the gain to bring the average amplitude to the
36 chosen level (in <acronym title="loudness units relative to full scale">LUFS</acronym>),
37 without exceeding the chosen true-peak value (in
38 <acronym title="decibels true peak">dBTP</acronym>).
39 EBU R128 is only available for mono or stereo sounds while true-peak works
40 for any channel layout.
44 <h3>Trim silence at start/end</h3>
46 These checkboxes allow to remove any part Ardour considers silent (< −90dB),
47 at the beginning or/and end of each exported track.
50 <h3>Add silence at start/end</h3>
52 These checkboxes allow to add silence at the beginning or/and end of each
53 exported track. The duration of the added silence can be manually fixed in the
54 adjacent 'timer' input fields.
59 This section adds watermarks to the exported audio (e.g. for limited/demo
60 distribution), by overwriting part of the audio with white noise in the
64 Both the <dfn>Mode</dfn> (how often and how long) and <dfn>Noise Level</dfn>
65 (how loud) can be set.
70 <h3>Compatibility</h3>
72 Selecting an item in the 'Compatibility' emphasizes the settings in the other
73 columns that are compatible with the selected standard, by turning incompatible
74 options red. When an incompatible quality/format/sample rate is selected, the
75 compatibility column checkbox disappears.
80 The appropriate item in the 'Quality' column will be highlighted when a file format
81 is chosen. At the moment, selecting a Quality setting does not show the
82 compatible File formats.
87 This column contains a list of Ardour's supported export file types. Selecting
88 one updates the options underneath it.
91 Note: For mp3 export ardour relies on ffmpeg to encode the file. This comes bundled
92 with the video-tools (and is always available when you install the official Ardour
98 A specific sample rate can be chosen for the exported files, or the current session's
99 sample rate (by choosing 'Session rate'), without sample rate conversion.
104 Options relevant to the chosen file format will appear just to the right of the
105 Compatibility/Quality/File format/Sample rate table.
108 <h3>Sample rate conversion quality</h3>
110 In case the chosen sample rate does not match the current session's sample rate,
111 the sample rate conversion quality can be chosen here. Better quality options are
117 These options are presented whatever the chosen format is:
120 <h3>Tag file with session's metadata</h3>
122 If the exported file format supports metadata (e.g. FLAC, Ogg Vorbis), use data
123 entered in the <a href="@@metadata">Session Metadata</a> window to tag the
127 <h3>Create CUE/TOC/chapter mark file</h3>
129 As well as exporting an audio file, Ardour can create a file (in CUE, TOC or MP4ch format
130 respectively) containing CD track information, as defined in the
131 <a href="@@the-ranges-and-marks-lists">Ranges & Marks List</a>.
132 Those files can then be used to either burn a CD or DVD, or to create "chapters"
133 inside a compatible mp4 video container.
137 If this is not blank, it is considered as a command to be run after the export
138 of each file. Either the command must exist in $PATH, or an absolute path to
139 an executable file can be specified here.
143 Certain sequences are allowed here to stand for the exported file name and
144 various parameters. Currently these are:
148 <li><dfn>%a</dfn>: Artist name</li>
149 <li><dfn>%b</dfn>: File's base-name</li>
150 <li><dfn>%c</dfn>: Copyright</li>
151 <li><dfn>%d</dfn>: File's directory</li>
152 <li><dfn>%f</dfn>: File's full absolute path</li>
153 <li><dfn>%l</dfn>: Lyricist</li>
154 <li><dfn>%n</dfn>: Session name</li>
155 <li><dfn>%o</dfn>: Conductor</li>
156 <li><dfn>%t</dfn>: Title</li>
157 <li><dfn>%z</dfn>: Organization</li>
158 <li><dfn>%A</dfn>: Album</li>
159 <li><dfn>%C</dfn>: Comment</li>
160 <li><dfn>%E</dfn>: Engineer</li>
161 <li><dfn>%G</dfn>: Genre</li>
162 <li><dfn>%L</dfn>: Total track count</li>
163 <li><dfn>%M</dfn>: Mixer</li>
164 <li><dfn>%N</dfn>: Timespan name</li>
165 <li><dfn>%O</dfn>: Composer</li>
166 <li><dfn>%P</dfn>: Producer</li>
167 <li><dfn>%S</dfn>: Disc subtitle</li>
168 <li><dfn>%T</dfn>: Track number</li>
169 <li><dfn>%Y</dfn>: Year</li>
170 <li><dfn>%Z</dfn>: Country</li>
174 Any part of the command-line enclosed in double-quotes (") will be used as-is.
178 For example, exporting an mp3 file can be done by inserting <code>lame -b320 %f</code>
179 which will convert the exported audio file ('%f') to a 320 kbs mp3 using the lame encoder
180 (provided lame is installed first on the system).