# Audacity Projects

### From Audacity Manual

Audacity projects store information about the entirety of the project such as the number of tracks and their time positions, details of clips within the tracks, amplitude envelope points, labels and gain and pan data.

- Audacity projects can only be used by Audacity. To save audio for use in other programs, such as WAV or MP3, use one of the export audio commands.

## Overview of an Audacity project

The Audacity Project Format stores all Audacity tracks and clips, labels, envelope points and other project data. The audio can be a recording, imported files, generated audio or a mix of any of those. Projects are a convenient way to save your extended multi-track piece and come back to it later exactly as you left off.

If coming back to your project later, it's always a sensible precaution to export a lossless backup WAV or AIFF file of the mix before you quit.

When importing uncompressed audio files, Audacity has an import preference that lets you save disk space and edit the files almost immediately by reading them directly from their original source location, rather than copying them into the project.

- If you read the files directly, you must not rename, move, delete or overwrite those original source files. See the Dependencies section for more information.

The structure of a saved Audacity project is:

- An AUP project file - the name of the project followed by ".aup", for example "my_song.aup"
- A _data folder with the same project name and in the same folder as the .aup file, for example "my_song_data"
- Within that _data folder, a sub-folder structure with lots of little AU files which are individual segments of the audio data.

  Note that default behaviour on Windows and Mac is to hide certain file extensions ; if this applies, the .aup file will only appear as "my_song" in the computer. On Windows, the .aup extension will be hidden if Audacity was installed from the .exe installer and "Hide file extensions for known file types" remains checked in Windows Explorer.

| Audacity's project format is not compatible with and should not be opened in any other audio program.

The project file describes how Audacity links these AU files together to make up the clips and tracks in the project; it also contains gain, pan and envelope information, data to manage the waveform display and carries links to any dependent audio files being read directly from their source location.

The AUP file is in XML format and can be opened in a text editor if required. The AU files are stored in a lossless, uncompressed format. Their default size is 1 MB or less. This Audacity Project Format is designed to make editing audio faster in Audacity. By updating individual AU files during editing, Audacity can change audio or move it around in the project without copying large quantities of data from one place to another.

The four rules for keeping your Audacity Project happy:

1. When importing an uncompressed audio file with the "Read uncompressed file directly from the original (faster)" option checked in Import / Export Preferences never move, rename or delete that file unless you first copy it into the Audacity project. See File > Check Dependencies for more information.
2. Never move, delete or rename any of the files or folders inside the _data folder.
3. Never rename the AUP file or the _data folder.

If you want to rename your project (for example, to save a snapshot at a particular point), use the File > Save Project As... command.

4. Always keep the AUP file and the _data folder together in the same directory (folder).

## Opening an Audacity project

When opening an Audacity project always use File > Open or File > Recent Files to open the "my_song.aup". Do not attempt to open, import or manipulate any individual AU files.

| Audacity can open .aup files created in 1.2 versions of Audacity, but if you save the file after opening it, it will no longer open in 1.2. Projects created by Audacity 1.1.x or earlier are no longer supported. To opens such projects in Audacity, export each audio track as WAV using the appropriate legacy version of Audacity, then import the WAV files into the current version of Audacity.

Audio which was not saved as an Audacity Project will need to be imported using File > Import, File > Open or by dragging the file in. The Import command is used to import audio data into an already open project, whereas the Open command used on an external audio file either imports the file into the current project if it never contained any other tracks, otherwise imports it into a new project window. See Importing Audio for more information.

## Dependencies

Depending on the Import / Export Preferences settings, when an uncompressed audio file such as WAV or AIFF is imported or opened, Audacity may save time by not making a copy of the file and in that case will refer externally to the original file as it manipulates the audio data within the project (while not ever making any changes to that audio file unless it is told to do so).

On the first use of the File > Import > Audio command to import un-compressed audio, the preference is set to "copy in" and a dialog is presented explaining the difference between copy-in and read-directly and asking which method should be used. See Warnings Preferences for an example of the warning dialog.

When a project is saved, and the "faster" option has been chosen in Import / Export Preferences, Audacity will display a dialog box showing these dependencies and give the option of copying all of the audio data into the project making it independent of external audio files and making it safe to delete, move or modify the original audio files if necessary. The Projects Preferences settings can be modified so that Audacity will not ask but will always either "never copy" the dependent audio files, or "always copy" them into the project on exit from Audacity.
At any time it is possible to click on File > Check Dependencies... to see if the project depends on any external files.

### Import settings: "faster" versus "safer"

There are two settings available to control the manner in which the File > Import command operates.

The faster option: When this option is selected Audacity can use its On-Demand Loading to operate faster and save disk space. Import of the audio will usually be faster, but Audacity will depend on the audio file remaining accessible and having the same name and location as when you imported it. The audio file is not actually imported or copied into the project in this case, rather it is accessed as an external file by Audacity.

The safer option: This is the more secure option to choose, meaning that Audacity will always have its own copy of imported files to work with. Choose this option if the Audacity project file is required to be opened on another computer, or to be sent to someone else. This option need not be chosen if an exported audio file like an MP3 or WAV file is to be sent to someone else.

| It is important to understand the implications of using the faster import setting; if this is selected then it is crucial that any uncompressed audio file on which your project depends is not moved, deleted or renamed. If plenty of disk space is available and the time taken to make the full import is not an issue, then it is strongly recommended that this Preference be set to the safer option. This way the project will then always remain independent of external audio files.

## Saving an Audacity Project

Saving an Audacity 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. When saving an Audacity project always use the File > Save Project or the File > Save Project As... command to save the <my_project_name>.aup.

There is no need to save a project, unless required, as it is possible to work with temporary project files and then just 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 program. At that point, Audacity offers the choice of saving a project or not.

The temporary folder uses the same format as the _data folder that you get when you Save a project. In addition to being the working folder for an un-saved project, the temporary folder is also used for the autosave file from which the project can be automatically recovered if your computer crashed while recording or editing an Audacity project.

Some benefits of saving a project:

- No need to re-import or re-record files
- Fast loading, even of multiple long tracks
- Audio data 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.

## Exporting Audio

Neither the .aup project file or the .au files in the _data folder can be used in other programs or devices. To use the project's audio outside Audacity, choose File > Export... which brings you to the File Export dialog. Here you can choose from various standard audio file formats according to your purpose. The two most common formats which can be played almost anywhere are

- WAV: a lossless format giving perfect quality, ideal for burning to Audio CDs
- MP3: a lossy format, but small enough to send over the internet or store on portable devices.

To export as MP3, don't forget to add the LAME MP3 library to your computer. Add the FFmpeg library to your computer to export to AAC or WMA which are used in iTunes and Windows Media Player respectively.

## How to move an Audacity Project

Moving Audacity projects can be tricky due to their complex structure as described above. Any project can be moved on the same computer by making a copy of the project with the File > Save Project As... command.

### Simple Projects

For a simple single track project (that does not have gain or pan settings, or use an envelope to adjust the volume) one possible solution is to not to move the project. Instead, use the File > Export command to export a WAV file. This WAV file can then be copied to another computer, then the File > Import command can be used to load the WAV file into an Audacity project. Alternatively the WAV file can be sent by e-mail or via a file sharing web site to someone else who can import it into an Audacity project on their computer.

### Complex Projects

For a project that has multiple tracks, or a single-track project that has gain or pan settings or uses an envelope to adjust the volume of the track, the entire project will need to be moved. To do that it is necessary to move the AUP file <my_project_name>.AUP and the _data folder <my_project_name>_data either to a second computer or to a different location on the existing computer. Ensure that the .aup file and _data folder remain together in the same folder.

As noted above, any project can be moved to a different location on the same computer using the File > Save Project As... command.

If you want to move a project to a different computer the project must not depend on external audio files. Use the File > Check Dependencies... command to check whether the project depends on any external files. If it does, the dialog box will give you the option to make a copy of those files within the project.

It can be difficult to e-mail complex projects to other users; to do so it is necessary to zip up the entire project structure and e-mail or share that zip file. The reason for zipping up the project is to make sure the project structure remains intact during the transfer, not to save space. A zip archive of a project is likely to be about 10% smaller than the unzipped project.

External files have absolute references in the AUP file and thus it is difficult to move an Audacity project that depends on external files to another computer but relatively easy to move a project to a different location on the same computer. See this article in the Wiki on Sending your work to others.

## 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 will need to delete both the AUP file and its associated, identically named _data folder.

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

##### Views

##### Help Location

- Local manual in use
- Internet manual