# Create Cue File

This function is used to produce a cue file describing the selected tracks.

A good summary of the format and supported tags in cue sheets can be found on Wikipedia. Various settings are available for the function in Preferences - Cue Sheets.

The supplied fields may contain any of the escape sequences described in Escape Sequences.

You can specify or choose the location of the path to the file being created. The resultant file path may be absolute (/), relative to the Home folder (~/) or relative to the first track's containing folder (./) or (../). If the specified path does not exist, it will be created.

You can optionally specify a title. If specified, the main TITLE tag in the cue file will use it. If not specified, the main TITLE tag will be given the album name, if it is consistent across all selected files.

Note that if all selected files are in the same folder and the cue file is being placed in that folder, the FILE tags will be simple filenames. If the previous conditions are not met, the FILE tags will be full paths to the files.

Tracks in the cue file are sequentially numbered from 1 in the order of the selected files.

This statement is not valid when executing grouped.

The action test state is set to true if the file is written, otherwise it is set to false.

Tip: if you want the cue file to have the album name and all files are in the same folder, the following path specification will work:

> ./\[Album].cue