3 An Ardour session is stored in a single folder on the computer's filesystem.
4 This makes <dfn>backup</dfn> very easy: any tool capable of backing up a
5 folder can be used to backup a session. The location of a session is picked when
6 it is created —by default it will be in the default session location,
7 which can be altered via <kbd class="menu">Edit > Preferences > General >
11 The single folder approach also makes sharing a project easy. Simply copy the
12 session folder (onto a storage device, or across a network) and another Ardour
13 user (on any platform) will be able to use it.
16 There is one complication in both cases: a session may reference media files that are stored
17 outside of the session folder, if the user has opted not to select
18 <kbd class="optoff">Session > Import > Copy to Session</kbd> during import.
19 Backing up a session with embedded files will not create a copy of the session
20 containing those files. To bring those external files to the session folder,
21 the <a href="@@cleaning-up-sessions"><kbd class="menu">Session > Clean-up >
22 Bring all media into session folder</kbd> menu</a> can be used.
25 <h2>Using the dedicated Zip/Archive Current Session tool</h2>
28 <img src="/images/archive-session.png" alt="The Zip/Archive Current Session window">
30 The Zip/Archive Current Session window
35 The <kbd class="menu">Zip/Archive Current Session</kbd> tool is located in the
36 <kbd class="menu"> File > Archive…</kbd> menu.
39 It allows to create a single file containing everything usefull in the session,
40 to share it or back it up, conveniently compressed to a session-archive which
41 is a zip-file (tar.xz to be specific) containing all the audio, MIDI,
42 plugin-settings,... and the currently active session. Ardour can also extract
43 those bundles (<kbd class="menu">Session > Open…</kbd>).
46 As opposed to zipping the entire session-folder manually,
49 <li>the session-archive only contains the current session-snapshot and only
50 files which are used</li>
51 <li>externally referenced files are included in the archive.</li>
57 The window shows the following options:
60 <dt><dfn>Archive Name</dfn></dt><dd>The name of the archive file, defaulting to
61 the name of the session followed by the date and time</dd>
62 <dt>a dropdown extension selector</dt><dd>allowing to choose between different kind or
63 compressed archive file types</dd>
64 <dt><dfn>Target directory/folder</dfn></dt><dd>defining where in the filesystem
65 the archive file will be generated</dd>
66 <dt><dfn>Audio Compression</dfn></dt><dd>a dropdown menu allowing to compress
67 the audio files themselves by using an audio-tailored compression format, more
69 <dt><dfn>Exclude unused audio sources</dfn></dt><dd>a checkbox to drop every
70 audio that is in the session, but not actually used in the editor</dd>
74 The <kbd class="menu">Audio Compression</kbd> selection accepts any of:
82 Encoding the audio sources to <abbr title="Free Lossless Audio Codec">FLAC</abbr> allows for a good size reduction of the session.
83 It should be noted though that FLAC is a fixed-point format, meaning that if the
84 audio in the session is in a floating-point format, this conversion will loose
85 some information on the samples values that are rounded, though usually, this
86 lost information cannot be perceived. Choosing "<em>None</em>" for Audio
87 Compression does not compress the audio to FLAC, hence preserving the floating-point
88 data at the cost of a bigger file size. Notice also that converting to FLAC
89 automatically normalizes the audio.
92 Using the <kbd class="option">Exclude unused audio sources</kbd> option allows
93 to only keep the files actually used in the session, which can be useful to leave
94 any unused take or reference material out of the backup, reducing the archive's