Managing Audacity Projects

From Audacity Development Manual
Revision as of 13:29, 8 July 2020 by PeterSampson (talk | contribs) (Opening an Audacity project: Orphan blockfiles (if any) are deal with "silently")
Jump to: navigation, search
Editors BEWARE - this page has a DISPLAYTITLE
Other languages
Peter 26Jun20: ToDo-1 this will need updating for .aup3 Unitary Project format.
All editing in Audacity is done as a project. It is important to note that a project is not a single audio file but a complex set of files managed by Audacity.
  • Audacity projects have a top-level AUP file and a related folder containing the sound files (the audio data). The AUP is not a sound file, it is merely a list of instructions that tell Audacity how to construct the project from the sound files in the folder. Audacity projects can only be used by Audacity.
  • To make an audio file (such as WAV or MP3) for playing on your music player, or for use in other applications, use one of the Export Audio commands, available from the File > Export menu.

Contents

  1. Structure of an Audacity project
  2. Saving an Audacity Project
  3. Saving copies of projects
  4. Opening an Audacity Project
  5. Moving or sending an Audacity project
  6. Backing up Audacity projects
  7. Deleting an Audacity project
  8. Recovery
  9. Disk space usage


Structure of an Audacity project

The Audacity Project Format stores all Audacity tracks and clips, labels, amplitude envelope points, gain and pan data, together with other project data. The audio can be a recording, imported files, generated audio or a mixture of any of those.

Projects are a convenient way to save your work and come back to it later exactly as you left off.

Each Audacity project is stored in its own SQLite database with the extension .aup3.

Audacity's project format is not compatible with and cannot be opened in any other audio application.


Saving an Audacity Project

A saved Audacity Project can only be opened and used by Audacity. If you want an audio file that will play on your music player or to burn a CD, use an Export command.

Tip You are strongly advised not to save your active project to an external USB stick/disk or networked or cloud storage as it is unlikely to be fast enough for satisfactory recording and editing.

There is no need to Save a project, unless required, as it is possible to work with temporary project files and then just use File > Export > Export Audio... to export the required audio files. If the project is not saved, the necessary audio data is stored in the temporary folder specified in the Directories section of Preferences until exiting the application. At that point, Audacity offers the choice of saving a project or not.

There are three main commands for saving projects

  • File > Save Project > Save Project saves a standard project as an AUP3 project file (a file with ".aup3" after its name). If the project does not have any unsaved changes (for example, if you just saved it), "Save Project" will be grayed out.
  • File > Save Project > Backup Project... similarly saves a standard project as an AUP3 file. It is for saving an existing Project to a new name to make a copy of the project in its current state (for example as a staged safety backup copy of your project in a known state) The current project will remain open for you to continue working on it.
  • File > Save Project > Save Project As... similarly saves a standard project. It is useful for saving an empty project or to save an existing Project to a new name. Unlike the Backup Project Audacity will close the current project in its last closed state and open the new project in the current state.

As with saving any type of file, certain characters cannot be used in the name of the AUP3 file if they are reserved for the operating system. See our information on forbidden characters. When saving an Audacity project it is normally easiest to use the File > Save Project command, which has a default shortcut of Ctrl + S (or ⌘ + S on Mac). If you save a project again having made further changes to it, "Save Project" then updates the AUP3 file silently without bothering you with prompts.

Long projects contain a lot of data. Ensure the project is fully saved before exiting Audacity or shutting down the computer. If there is a progress dialog for saving the project, wait for it to complete before shutting down.

The Status Bar at the bottom shows a message when the project has been saved.

Tip The benefits of saving an Audacity Project are:
  • Saving a project lets you save unfinished work and re-open it later in Audacity exactly as it was, with all edits and recorded/imported tracks preserved. Note carefully that the Undo history is not saved with the project and so the project history starts afresh when you re-open the project later.
  • Audio data is always preserved in lossless quality. This is useful if you have already exported to a lossy audio format like MP3 but decide to edit the project further. Editing and re-exporting the project saves the additional quality loss of re-editing the previously exported MP3.
  • No need to re-import or re-record files
  • Fast loading, even of multiple long tracks.


Saving copies of projects

Backup Project

Accessed by: File > Save Project > Backup Project...

This similarly saves a standard project as an AUP3 file. It is the safe and recommended way to make a safety backup copy of a project as you work on it. This could serve either as a single backup copy of the project, or as one of several incremental copies of the project in the state it had at a particular date and time. Unlike "Save As..." using this command will leave your current project open enabling you to continue working on it.

Tip The wise user also knows that hard drives can crash destroying all data and makes regular backups to external storage.
  • The cautious user makes duplicate backups to at least two different external storage devices.
  • The extremely cautious user ensures that at least one of those backups is held off-site.

Save Project As

Accessed by: File > Save Project > Save Project As...

This is a way to make a copy of a project with a new name or location. If you "Save Project As" with a new name, the project window then displays the project name you just "saved as". The project window displaying the project as previously named is closed in its last saved state, but can be reopened as required.

Peter 07Jul20: ToDo-1 You appear to be able to use the OS's file manager to successfully copy projects. Only tested on Windows and Mac for now.
Advice You should never use the operating system's copy and paste to make a copy of the project AUP file and _data folder in the same folder as the original project. If you must make a copy by hand, save and close the project first then copy the AUP file and _data folder and paste these into a different folder. This ensures the original file and folder names are retained.


Opening an Audacity project

When opening an Audacity project always use File > Open or File > Recent Files to open the "my_project.aup3".

Audio which was not saved as an Audacity Project will need to be imported using File > Import or by dragging the file in. The Import command is used to import audio data into an already open project.

Peter 07Jul20: ToDo-1 I'm suspecting we will break compatibility with 1.2.6 project files with UP-3.0.0
Tip Older Projects
  • Audacity can usually open AUP files created in legacy Audacity 1.2.x, but saving the project will prevent it opening again in 1.2.x. Before opening the legacy AUP file, copy it and its _data folder and paste them into a different folder to make a backup. If necessary you can open the backup in Audacity 1.2.x, export each track as WAV then import the WAV files into current Audacity.
  • Projects created in legacy Audacity 1.1.x or earlier can only be opened by exporting each audio track as WAV in the legacy version of Audacity, then import the WAV files into the current version of Audacity.


Moving, renaming or sending an Audacity project

Moving or renaming Audacity projects is simple now that Audacity has a unified project structure in a single .aup3file.

  • It can be difficult to email complex projects to others because of the size of the project data. Note that ZIP formats do not support reliable character encoding, so for the name of the project, labels, track names or metadata, only use A to Z or a to z characters, whole numbers (0 to 9), underscore or hyphen-minus (or use the NUMPAD_SUBTRACT key).

See also Sending your work to others and this FAQ.


Backing up Audacity projects

Regular backups should if possible be made to one or two devices other than the device the current project is stored on, as computer hard drives can fail, destroying all data. For example, backups could be made to another internal drive on the computer, or ideally to an external USB drive or uploaded to an online (cloud) storage service.

For advice on backing up Audacity projects please see this FAQ.

Tip If you have just made a recording it is strongly recommended that you immediately export your audio using File > Export > Export Audio... to WAV or AIFF (ideally to an external drive) as a safety copy before you start editing the project.


Deleting an Audacity project

There is no File > Delete Project command in Audacity.

Therefore to delete a project to free up disk space it is necessary to make the deletion manually. You just need to delete the AUP3 file.

This will not remove the listing of your project under File > Recent Files.... After deleting the project you can choose the AUP3 entry for that project in the Recent Files list in order to remove the entry.


Recovery

Following an Audacity crash you can just relaunch Audacity and re-open your project. It will be recovered to tha last database "snapshot", you may lose what you were last doing when the crash occurred.

Peter 27Jun20: ToDo-1 This form of auto recovery is likely to disappear with the UP project - SQLite handles this apparently.

As soon as you open a project window and change the window contents, whether this is a previously saved project or you are creating a new project, Audacity writes a temporary reference file for that project called an ".autosave" file. This allows Audacity to automatically recover unsaved changes in the event of a crash or power loss.

When you use Save Project, Save Lossless Copy of Project... or Save Project As... there are no longer unsaved changes, so the ".autosave" file is deleted until fresh unsaved changes are made. The file is stored in the "AutoSave" folder inside Audacity's folder for application data. The file is of identical internal structure to an AUP project file, but is not readable by a text editor.

Most changes you make to the audio data, such as adding or removing audio or applying an effect to it, trigger writing the ".autosave" file. A change to the position of the selection or editing cursor does not write to the ".autosave" file, and is not captured when closing the project, unless the project is already "dirty" (as shown by Save Project in the submenu being not grayed out and being clickable).


Disk space usage

This can be particularly important if you are editing a large project.

Audacity references the original audio material until you actually perform some kind of edit on it, such as cutting a piece away or using any effect on it. So if you Edit > Duplicate a selection, this doesn't actually increase the number of block files in the project file and doesn't increase disk space usage. Edit > Copy though, for example, does increase the number of block files and thus the size of the project file but this is so these files can be retained separately on the Audacity clipboard for Edit > Paste.

Once you perform an edit, the original unchanged audio is retained, along with the changed audio. This is so you can use Edit > Undo and Edit > Redo to try out edits and undo them if they do not sound as you wanted.

If you edit just a small selection in a track, only that small selection of changed data is written to disk. Nonetheless, this still represents a doubling of disk space usage for that selection, and a further edit on that selection (unless you first undo the previous edit) adds the same amount again, and so on. For example, a five minute stereo recording at default quality settings takes 100 MB of space. If you edit the whole length of that recording, disk space usage will increase to 200 MB.

If disk space is a problem while working on a project, you can use View > History... to discard Undo levels and reclaim disk space. Note that once you close the project by using File > Close or exiting Audacity, the audio data needed for Undo/Redo is discarded, so as to make project storage as economical as possible.