]> Shamusworld >> Repos - ardour-manual/blob - include/cleaning-up-sessions.html
Update Lua doc for 7.1
[ardour-manual] / include / cleaning-up-sessions.html
1
2 <p>
3   Recording and editing any serious session might leave the session with some
4   unused or misplaced files here and there. Ardour can help deal with this clutter
5   thanks to the tools located in the <kbd class="menu">Session &gt; Clean-up</kbd>
6   menu.
7 </p>
8
9 <h2 id="bring_all_media_into_session_folder">Bring all media into session folder</h2>
10
11 <p>
12   When <a href="@@adding-pre-existing-material">importing media files</a>, if
13   the <kbd class="option">Copy files to session</kbd> has not been checked, Ardour
14   uses the source file from its original destination, which can help avoiding file
15   duplication. Nevertheless, when the session needs to be archived or transferred
16   to another computer, moving the session folder will not move those
17   <em>external</em> files as they are not in the folder, as seen in <a
18   href="@@backup-and-sharing-of-sessions">Backup and sharing of sessions</a>.
19 </p>
20
21 <p>
22   Using the <kbd class="menu">Bring all media into session folder</kbd> menu
23   ensures that all media files used in the session are located inside the
24   session's folder, hence avoiding any missing files when copied.
25 </p>
26
27 <h2 id="reset_peak_files">Reset Peak Files</h2>
28
29 <p>
30   Ardour represents audio waveforms with peak files, that are graphical images
31   generated from the sound files. This generation can be time and CPU consuming,
32   so it uses a cache of the generated images to speed up the display process. To
33   watch for files modification, Ardour relies on the file-modification time. If an
34   external file is embedded in the session and that file changes, but the
35   system-clock is skewed or it is stored on an external USB disk (VFAT), Ardour
36   can't know the change happened, and will still use its deprecated peak files.
37 </p>
38
39 <p>
40   Using the <kbd class="menu">Reset Peak Files</kbd> menu allows to reset this
41   cache, which frees up disk space, and forces the re-creation of the peak files
42   used in the session. It can prove useful if some waveforms are not used anymore,
43   or if a graphical or time glitch happens.
44 </p>
45
46 <h2 id="clean_up_unused_sources">Clean-up Unused Sources&hellip;</h2>
47
48 <p>
49   Recording usually leaves a lot of unused takes behind, be it in midi or audio
50   form, that can clutter the Region List, and eat up a lot of hard drive space.
51   While its generally a good practice to keep as many things as possible while
52   recording, when transferring or archiving the session, some clean up can help a
53   lot in reducing the sessions clutter and size.
54 </p>
55
56 <p>
57   Selecting <kbd class="menu">Clean-up Unused Sources&hellip;</kbd> will force
58   Ardour to detect those unused waveforms by looking for unused regions, and
59   (through a prompt) for unused playlists. The media files will not be destroyed,
60   though. At this stage, they are just copied in a particular place of the session
61   path (namely, in the <code>dead sounds/</code> sub-folder).
62 </p>
63
64 <h2 id="flush_wastebasket">Flush Wastebasket</h2>
65
66 <p>
67   Although Ardour is a <em>non-destructive</em> audio-editor, it allows for a
68   very careful destruction of unused media materials. This function is closely
69   linked to the previous one. When the unused sources have been cleaned up and
70   quarantined, the <kbd class="menu">Flush Wastebasket</kbd> menu will allow for
71   their physical destruction.
72 </p>
73
74 <p>
75   As a safeguarding mechanism though, Flushing the wastebasket in impossible
76   in the same working session as the Cleaning up of unused sources: the user needs
77   to close the session and reload it before flushing. It allows to test the
78   playback of the session and ensure both that Ardour did not commit any mistake
79   (unlikely, but better safe than sorry), and that the user is absolutely sure of
80   what he does.
81 </p>
82
83 <p class="warning">
84   All media destroyed this way is not sent to the system's <em>trash can</em> but
85   permanently deleted. If a file is mistakenly destroyed this way, the user will
86   have to rely on data recovery techniques to try getting it back.
87 </p>
88