View source for Talk:FAQ:Errors on opening or recovering an Audacity project

__NOTOC__
==AUP errors==

{{ednote|'''Peter 20Feb21:''' The following are residual messages from 2..4.2 and earlier AUP project format - so commented out for 3.0.0
#[[#not-well-formed|Error Opening Project: not well-formed (invalid token) at line x]]
#[[#invalid|Error Opening Project: Reference to invalid character number at line x]]
#[[#corrupt|Error Opening File or Project: File may be invalid or corrupted]]
#[[#mismatched|Error Opening Project: mismatched tag at line x]] 
#[[#missing|Warning - Missing Audio Data Block File(s)]] 
#[[#orphans|Warning - Orphan Block File(s)]] 
#[[#others|Other errors opening project]] }}


{{ednote|1=
'''Peter 20Feb21:''' The following are residual messages from 2..4.2 and earlier AUP project format - so commented out for 3.0.0
<div id="not-well-formed"></div>

==Error Opening Project: not well-formed (invalid token) at line x==
This usually means that when reopening the AUP [[Audacity Projects|project file]] normally, Audacity finds an unexpected non-English, accented or control character at the line quoted in the error message. There are two main causes of this.  
* The project contains '''imported files whose [[Glossary#metadata|metadata]] (like artist or genre) contains control characters.''' This mostly occurs with Apple Music/iTunes files on Mac where the project was created in an older version of Audacity. 
* The project was saved containing '''non-English or accented characters''' using an old ANSI build of Audacity for Windows. ANSI builds are not properly [http://en.wikipedia.org/wiki/Unicode Unicode] aware, so do not support non-English or accented characters. 
** The [http://www.audacityteam.org/download/windows latest version of Audacity] will always fully support Unicode. You can check your Audacity version at {{menu|Help > [[Help Menu#about_audacity|About Audacity...]]}} ''(or {{menu|Audacity > About Audacity}} on Mac)''. 

If Audacity or the computer crashed, Audacity will try to [[Recovery|recover]] the project from its [[Audacity Projects#autosave|AUTOSAVE]] file, but the crash may have created a redundant line near the end of the file that triggers the token error. Very occasionally, the AUP file may become corrupted by one or more redundant lines, giving a token error even if there was no apparent crash. To correct this, see [[Error: not well-formed (invalid token) at line x#autosave|remove redundant lines in an AUTOSAVE or AUP file]]. 

For details of how to fix this please see [[Error: not well-formed (invalid token) at line x]]

[[#top|back to top]]


<div id="invalid"></div>

== Error Opening Project: Reference to invalid character number at line x ==
This error message usually means that when reopening the AUP [[Audacity Projects|project file]] normally, Audacity finds an unexpected non-English, accented or control character at the line quoted in the error message. There are three main causes of this.  
* The project contains imported files whose '''''[[Glossary#metadata|metadata]]''''' contains symbols that Audacity cannot display. This may create either the "(invalid token)" or "invalid character number" error
* The project was saved containing '''non-English or accented characters''' using an old ANSI build of Audacity for Windows. ANSI builds are not properly [http://en.wikipedia.org/wiki/Unicode Unicode] aware, so do not support non-English or accented characters. 
** The [http://www.audacityteam.org/download/windows latest version of Audacity] will always fully support Unicode. You can check your Audacity version at {{menu|Help > [[Help Menu#about_audacity|About Audacity...]]}} ''(or {{menu|Audacity > About Audacity}} on Mac)''.  

For details of how to fix this please see [[Error Opening Project: Reference to invalid character number at line x]].

[[#top|back to top]]



<div id="corrupt"></div>

== Error Opening File or Project: File may be invalid or corrupted ==
This error is seen if the file is completely empty (0 kB) or for some cases of partial corruption of the file syntax. If the file is 0 kB, try to use any [[FAQ:Opening_and_Saving_Files#backup|backup]] you created, such a different AUP file for an earlier stage of the project, or an exported '''''[[Glossary#wav|WAV]]''''' file. 

If the file is non-zero size, you can try backing up the AUP file to another location, then open the file in [https://notepad-plus-plus.org/ Notepad++] for Windows (or [http://brackets.io/ Brackets] or [http://www.barebones.com/products/bbedit/ BBEdit] for Mac) and examine if the syntax of the file is consistent and if the file is complete as expected. Compare with a known good AUP file to see what the AUP contents should look like. 

[[#top|back to top]]


<div id="mismatched"></div>

==Error Opening Project: mismatched tag at line x==
This error usually means that for some reason, an opened tag in the XML did not have the same name as the tag that was opened, or a nested tag (inside the tag) was not closed correctly.

Examples:

'''Wrong - the closing tag is "tag" instead of "tags" to match the tag that was opened:'''
{{code|1='''<tags><br>&nbsp;&nbsp;&nbsp;<tag name="ARTIST" value="Elton"/><br></tag>'''}} 

 
'''Wrong - the closing "/" after "Elton" is missing:'''
{{code|1='''<tags><br>&nbsp;&nbsp;&nbsp;<tag name="ARTIST" value="Elton"><br></tags>'''}}


'''Correct!'''
{{code|1='''<tags><br>&nbsp;&nbsp;&nbsp;<tag name="ARTIST" value="Elton"/><br></tags>'''}}

[[#top|back to top]]

 
<div id="missing"></div>
==Warning - Missing Audio Data Block File(s)==
'''Block files:''' Audacity stores the audio data in multiple short sections or block files (normally six seconds long). For details please see For details please see [[Audacity Projects#AUP|Structure of an Audacity project]].

This warning message will be shown when you attempt to open an Audacity project which has audio data missing for some reason. 

For further details and remedial action please see [[Warning - Missing Audio Data Block Files]].

[[#top|back to top]]


<div id="orphans"></div>

==Warning - Orphan Block File(s)==
'''Block files:''' Audacity stores the audio data in  multiple short sections or block files (normally six seconds long). For details please see [[Audacity Projects#AUP|Structure of an Audacity project]]. 

This warning message will be shown when you attempt to open an Audacity project which has audio data which does not appear in any of the tracks in the project.

For further details and remedial action please see [[Warning - Orphan Block Files]].

[[#top|back to top]]



<div id="others"></div>

== Other errors opening project==  
There are a number of other errors that you might see relating to the syntax of the AUP file not being quite correct, such as: 
* '''unclosed token at line x''' (for example, the final </project> tag is missing its ending ">"
* '''no element found at line x''' (for example, the final </project> tag is missing in an otherwise correct file)
* '''junk after document element at line x'''
The best advice in these cases is to examine the line quoted carefully, and don't manually edit the AUP file unless it is unavoidable.

}}