Shamusworld >> Repos - ardour-manual/blob - include/backup-and-sharing-of-sessions.html

   1
   2 <p>
   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 &mdash;by default it will be in the default session location,
   7   which can be altered via <kbd class="menu">Edit &gt; Preferences &gt; General &gt;
   8   Session</kbd>.
   9 </p>
  10 <p>
  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.
  14 </p>
  15 <p>
  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 &gt; Import &gt; 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 &gt; Clean-up &gt;
  22   Bring all media into session folder</kbd> menu</a> can be used.
  23 </p>
  24
  25 <h2>Using the dedicated Zip/Archive Current Session tool</h2>
  26
  27 <figure>
  28   <img src="/images/archive-session.png" alt="The Zip/Archive Current Session window">
  29   <figcaption>
  30     The Zip/Archive Current Session window
  31   </figcaption>
  32 </figure>
  33
  34 <p>
  35   The <kbd class="menu">Zip/Archive Current Session</kbd> tool is located in the
  36   <kbd class="menu"> File &gt; Archive&hellip;</kbd> menu.
  37 </p>
  38 <p>
  39   It allows to create a single file containing everything useful 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&hellip;</kbd>).
  44 </p>
  45 <p>
  46   As opposed to zipping the entire session-folder manually,
  47 </p>
  48 <ol>
  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>
  52 </ol>
  53
  54 </p>
  55
  56 <p>
  57   The window shows the following options:
  58 </p>
  59 <table class="dl">
  60   <tr><th><dfn>Archive Name</dfn></th><td>The name of the archive file, defaulting to
  61   the name of the session followed by the date and time</td></tr>
  62   <tr><th>a dropdown extension selector</th><td>allowing to choose between different kind or
  63   compressed archive file types</td></tr>
  64   <tr><th><dfn>Target directory/folder</dfn></th><td>defining where in the filesystem
  65   the archive file will be generated</td></tr>
  66   <tr><th><dfn>Audio Compression</dfn></th><td>a dropdown menu allowing to compress
  67   the audio files themselves by using an audio-tailored compression format, more
  68   on that below</td></tr>
  69   <tr><th><dfn>Exclude unused audio sources</dfn></th><td>a checkbox to drop every
  70   audio that is in the session, but not actually used in the editor</td></tr>
  71 </table>
  72
  73 <p>
  74   The <kbd class="menu">Audio Compression</kbd> selection accepts any of:
  75 </p>
  76 <ul>
  77   <li>None</li>
  78   <li>FLAC 16bit</li>
  79   <li>FLAC 24bit</li>
  80 </ul>
  81 <p>
  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 lose
  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.
  90 </p>
  91 <p>
  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
  95   global file size.
  96 </p>
  97