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