View source for Audacity 2.x AUP Projects


:<span title="This page is a Work in Progress">[[Image:WIP.png|center|frame|Work in Progress...|link=]]</span>

__NOTOC__
{{intro|1=
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 '''''[[Glossary#audacity_project_format|AUP]]''''' file and a related folder containing the sound files ''(the audio data)''. The '''''[[Glossary#audacity_project_format|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  '''''[[Glossary#wav|WAV]]''''' or '''''[[Glossary#mp3|MP3]]''''') for playing on your music player, or for use in other applications, use one of the [[File Menu: Export#exports|Export Audio]] commands, available from the {{menu|File > [[File Menu: Export|Export]]}} menu.  
}}

==Contents==
#[[#AUP|Structure of an Audacity 2.x Project]]
#[[#save|Saving an Audacity Project]]
#[[#copies|Saving copies of projects]]
#[[#open|Opening an Audacity Project]]
#[[#move|Moving or sending an Audacity project]]
#[[#backup|Backing up Audacity projects]]
#[[#delete|Deleting an Audacity project]]


<div id="AUP"></div>

== Structure of an Audacity 2.x Project ==
The Audacity '''''[[Glossary#audacity_project_format|Project Format]]'''''  stores all Audacity [[Tracks|tracks]] and [[Audacity Tracks and Clips|clips]], [[Label Tracks|labels]], [[Envelope Tool|amplitude envelope points]], '''''[[Glossary#gain|gain]]''''' and '''''[[Glossary#pan|pan]]''''' data, together with other project data. The audio can be a [[Playing_and_Recording#Recording|recording]], [[Importing Audio|imported files]], [[Generate Menu|generated audio]] or a mixture 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.

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

'''The structure of a saved Audacity project is:'''
*An '''''[[Glossary#audacity_project_format|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 '''''[[Glossary#au|AU]]''''' block files which are individual segments of the audio data. 
:''Note that default behavior on Windows and Mac is to hide certain file [[Glossary#extension|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. You can unhide extensions on Windows by following [http://www.bleepingcomputer.com/tutorials/how-to-see-hidden-files-in-windows/ these instructions]. 

The project file describes how Audacity links these AU block files together to make up the clips and tracks in the project. It also contains gain, pan and envelope information, data to manage the  [[Audacity Waveform|waveform]] display.

The AUP file is in XML format and can be opened in a text editor if required. The AU block files are stored in a '''''[[Glossary#lossless|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 block 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.

<div id="4rules"></div>
{{note|1=
'''The four rules for keeping your Audacity Project happy:'''
#When importing an uncompressed audio file with the "Read uncompressed file directly from the original (faster)" option checked in [[Import - Export Preferences|Import / Export Preferences]] '''never move, rename or delete that file''' unless you first copy it into the Audacity project. See {{menu|Help > Diagnostics > [[Help Menu: Diagnostics#check_dependencies|Check Dependencies...]]}} for more information.
#'''Never''' move, delete or rename any of the block files or folders inside the _data folder.
#'''Never''' rename the AUP file or the _data folder by hand.
#:If you want to rename your project (for example, to save a snapshot at a particular point), use one of the {{menu|File > Save Project > [[File Menu: Save Project#save_lossless_copy_of_project|Save Lossless Copy of Project...]]}} or {{menu|File > Save Project > [[File Menu: Save Project#save_project_as|Save Project As...]]}} commands.
#'''Always''' keep the AUP file and the _data folder together in the same directory (folder).
}}


<div id="save"></div>

== [[File Menu: Save Project|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 [[File Export Dialog|Export]] command. 

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, Redo and History|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


There is no need to [[#save|Save]] a project, unless required, as it is possible to work with temporary project files and then just use {{menu|File > Export > [[File Menu: Export#exportaudio|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 Preferences|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:'''
*{{menu|File > Save Project > [[File Menu: Save Project#save_project|Save Project]]}} saves a standard project as an '''AUP''' project file (a file with ".aup" after its name) and a '''_data''' folder containing the actual audio. If the project does not have any unsaved changes (for example, if the project is empty or you just saved it), "Save Project" will be grayed out.

*{{menu|File > Save Project > [[File Menu: Save Project#save_lossless_copy_of_project|Save Lossless Copy of Project...]]}} similarly saves a standard project as an AUP file and _data folder. 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.
  
*{{menu|File > Save Project > [[File Menu: Save Project#save_project_as|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 '''Save Lossless Copy''' 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 AUP file if they are reserved for the operating system. See our information on [[FAQ:Opening_and_Saving_Files#illegal|forbidden characters]]. 
When saving an Audacity project it is normally easiest to use the {{menu|File > [[File Menu#save_project|Save Project]]}} command, which has a default shortcut of {{shortcut|Ctrl + S}} (or {{shortcut|Cmd + S}} on Mac). If you save a project again having made further changes to it, "Save Project" then updates the AUP file and _data folder silently without bothering you with prompts. 
{{note|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.}}       


<div id="copies"></div>
== Saving copies of projects ==
=== [[File Menu: Save Project#save_lossless_copy_of_project|Save Lossless Copy of Project]] ===
Accessed by: {{menu|File > Save Project > [[File Menu: Save Project#save_lossless_copy_of_project|Save Lossless Copy of Project...]]}}

This 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.

=== [[File Menu: Save Project#save_project_as|Save Project As]] ===
Accessed by: {{menu|File > Save Project > [[File Menu: Save Project#save_project_as|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. 
{{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.}}

<div id="compressed"></div>
=== [[File Menu: Save Project#save_compressed_copy_of_project|Save Compressed Copy of Project]] ===
If you need to save space (for example to send a project over the internet) you can save a compressed version of your project by using {{menu|File > Save Project > [[File Menu: Save Project#save_compressed_copy_of_project|Save Compressed Copy of Project...]]}}.  

This will save a copy of your project in the '''''[[Glossary#lossy|lossy]]''''', '''''[[Glossary#compressed_format|compressed]]''''' '''''[[Glossary#ogg|Ogg Vorbis]]''''' format, each track being saved as a separate OGG file. 


<div id="open"></div>
==Opening an Audacity project==
When opening an Audacity project always use {{menu|File > [[File Menu#open|Open]]}} or {{menu|File > [[File Menu#recentfiles|Recent Files]]}} to open the '''"my_song.aup"'''.  Do not attempt to open, import or manipulate any individual '''AU''' block files. 

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

{{tip|1='''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 [https://code.google.com/archive/p/audacity/downloads?page=6 Audacity 1.2.x], export each track as WAV then [[Importing Audio|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.}}

===Missing or orphan block files===
Occasionally when a project is opened Audacity will find that there may be some missing data ([[#AUP|block files]]) or some additional extraneous data not needed for the project.  

This is normally caused by a system or application crash but sometimes can be down to ''(as yet undiscovered bugs)''.

If this happens warning messages will be displayed:
*[[Warning - Missing Audio Data Block Files]]
*[[Warning - Orphan Block Files]]
The above links explain the possible remedial actions you can take in these circumstances.


<div id="move"></div>

== Moving, renaming or sending an Audacity project ==
Moving or renaming Audacity projects can be tricky due to their complex structure as described above.  Any project can be moved on the same computer, or renamed, by making a copy of the project with either the {{menu|File > Save Project > [[File Menu: Save Project#save_lossless_copy_of_project|Save Lossless Copy of Project...]]}} or the {{menu|File > Save Project > [[File Menu: Save Project#save_project_as|Save Project As...]]}} command.

*Sending somebody just an '''''[[Glossary#audacity_project_format|AUP]]''''' file does '''not''' send them an Audacity project - to do that you would need to send the _data folder containing the small AU files too.

*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 move the project. Instead, use the {{menu|File > Export > [[File Menu: Export#exportaudio|Export Audio...]]}} command to export a WAV file. This WAV file can then be copied to another computer (such as by using a USB flash drive), then the {{menu|File > [[File Menu#Import|Import]]}} command can be used to load the WAV file into an Audacity project. Alternatively the WAV file can be sent by email or via a file sharing website (if the WAV is not too large for email) to someone else who can import it into an Audacity project on their computer.

*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. <p>To move to a different location on the same computer, use {{menu|File > Save Project > [[File Menu: Save Project#save_project_as|Save Project As...]]}}. Save Project As can also be used to transfer the project to another computer on the same network, though this can be slow. If it is necessary to move the project by hand, save and close the project then move the AUP file '''''<my_project_name>.AUP''''' and the _data folder '''''<my_project_name>_data''''' to a different folder or computer. Ensure that the .AUP file and _data folder remain together in the new folder.</p>
  
{{advice|Never rename a project by hand in any folder. Doing so will corrupt the project. }}
*If moving the project to a different computer, the project must not depend on external audio files because the actual (absolute) path to these is stored in the AUP file. Use the {{menu|Help > Diagnostics > [[Help Menu: Diagnostics#check_dependencies|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 email complex projects to others because of the size of the project data and because you must send a ZIP file containing AUP file and _data folder to ensure the project structure remains intact. If you do not mind sending slightly lossy audio in the project, the file size can be greatly reduced by zipping up a [[#compressed|compressed copy of the project]]. 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:Opening and Saving Files#send|FAQ]].
 

<div id="backup"></div>
==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:Opening and Saving Files#backup|FAQ]].
{{tip|If you have just made a [[Record|recording]] it is strongly recommended that you immediately export your audio using {{menu|File > Export > [[File Export Dialog|Export Audio...]]}} to '''''[[Glossary#wav|WAV]]''''' or '''''[[Glossary#aiff|AIFF]]''''' (ideally to an external drive) as a safety copy before you start editing the project.}} 


<div id="delete"></div>
==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 {{menu|File > [[File Menu#recentfiles|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.