Cue sheets

From Audacity Wiki
Revision as of 18:03, 30 September 2007 by Andrewtheart (talk | contribs) ('''Issues''')
Jump to: navigation, search

Cue sheets status in Audacity

Audacity cannot currently export Cue Sheets by direct means (although it has been a feature request for some time), but it is possible to follow the below sequence to produce cue sheets indirectly using a open source java tool (label2cue)

Conversion process using the label2cue converter

Split the tracks

Split your recording in Audacity into separate tracks using the method described on this page of the Audacity wiki.

Export the labels

In Audacity, select File > Export Labels and name your exported label file. It will be saved as a plain text document that represents the label positions in seconds (and optionally, the label titles).

Convert label file with label2cue

On Windows, Linux, or any platform supporting Java, use Andrewtheart's java tool label2cue to convert/format the minutes and seconds data in the text label file to minutes, seconds and frames data laid out in cue sheet format.

In Windows, you should be able to simply double click on the label2cue.jar file in the zip folder to run the application, but in Linux, you probably need to execute the following command from the console.

java -jar Label2Cue.jar

(This is related to a work path issue. You can also make a desktop launcher for the program which contains the path to the jar file.)

The converted cue file should output in the same directory as the jar file, not the directory of the text label file.

label2cue information


Due to the fact that precision is gradually lost over time when doing mathematical calculations, some users gave noticed slight errors in the converted results, in which some of the tracks were off by a frame or two.

For example, one user wrote -

The label.txt file had times in seconds, to 6 decimal places--all with 2 decimal digits followed by either 0000, 3333, or 6667. Multiplying any of the decimal parts by 75 gives the frame number. The 0000 endings are exact, the 6667 endings lead to a very slightly larger number which turns out OK, but the 3333 endings lead to a very slightly smaller number,which is truncated to a frame number 1 low. E.g., for 1059.573333, multiply .573333 x 75 = 42.999975 which should be rounded to 43 but is put in the cue sheet as 42 frames.

This will eventually be fixed, but for now is not a high priority issue.

Another bug is that track number 10 will probably not be correctly assigned a title from the label file.


You can modify/improve/redistributed label2cue if you wish, but I (AndrewTheArt, developer) request that you e-mail me with any major changes for my reference and edification. You can find the source and my e-mail address in the zip folder.

System Requirements

This java tool will run on any platform supporting Java (JRE 1.5 and higher specifically. JRE 1.4 will not work!)


label2cue was originally created by AndrewTheArt (Andrew S)

Information about cue sheets in general

You can read more about cue sheets here.

External links