# Preferences - Cue Sheets

Yate supports the importing of metadata from Discogs and MusicBrainz to existing cue sheets and/or to a CUESHEET UDTI. It also supports the creation of cue files from the UI and via the Create Cue File action statement. These created cue files describe multiple files each containing a single track.

This preference section provides options to support the above functionality.

A good summary of the format and supported tags in cue sheets can be found on Wikipedia. The standard cue sheet tags are: CATALOG, CDTEXTFILE, FILE, FLAGS, INDEX, ISRC, PERFORMER, POSTGAP, PREGAP, REM, SONGWRITER, TITLE and TRACK. The REM tag is used to provide documentation and extensibility to a cue sheet.

When importing from Discogs or MusicBrainz, it is assumed that the cue sheet was initially constructed when a CD was first ripped. For this reason, the FLAGS, INDEX, POSTGAP, PREGAP and TRACK tags are always preserved. These items represent the reality of the file being processed. All other tags may be removed or modified by the import.

The following settings are supported when importing cue sheets:

Metadata Source
  This setting controls where the Discogs and MusicBrainz wizards looks for the cue sheet source. The choices are:
  None
    The importing to cue sheet source is disabled.
  Cue File
    The source must be a file of the same name as the single selected file with a .cue extension.
  CUESHEET Tag
    The source is a CUESHEET UDTI.
  Cue File or CUESHEET Tag
    The source can be a file or tag but a file's contents has higher priority.
  CUESHEET Tag or Cue File
    The source can be a file or tag but a tag's contents has higher priority.
Save to
  This setting controls where the imported results are written. The choices are:
  Cue File
    The results are written to a file of the same name as the single selected file with a .cue extension.
  Cue Sheet Tag
    The results are written to a Cue Sheet UDTI.
  Cue File and Cue Sheet Tag
    The results are written to a file and tag.
  Cue File, Remove Cue Sheet Tag
    The results are written to a file any existing Cue Sheet tag is removed.
  Cue Sheet Tag, Remove Cue File
    The results are written to tag and any existing cue file is removed.
Remove CDTEXTFILE
  This tag which describes a path to a file containing CD-Text info is generated by some CD rippers. If the option is enabled the CDTEXTFILE tag will be removed when the file is rewritten.
Remove REM DISCID
  This tag is generated by some rippers to contain a value computed from a CD's TOC to be used for freeDB lookups. If the option is enabled, the REM DISCID tag will be removed when the file is rewritten.
Remove REM COMMENT
  These tags contain descriptive text. If the option is specified all REM COMMENT tags will be removed when the file is rewritten.
Remove unhandled REM commands
  The REM commands are used for extensibility. If the option is specified all REM tags which are not in the following list will be removed when the file is rewritten.
  COMPOSER, DATE, DISCID, GENRE, REPLAYGAIN_ALBUM_GAIN, REPLAYGAIN_ALBUM_PEAK, REPLAYGAIN_TRACK_GAIN, REPLAYGAIN_TRACK_PEAK, YATE_RG
  The handling of the tags in the above list is either inherently handled by the import or is controlled by other settings.
Offset REPLAYGAIN tags by value LUFS
  This option is only used if the Do not process REM REPLAYGAIN tags option is not enabled. If your CD ripper is not using the same LUFS value as is your preference, you can use this option to offset the values. Note, if you import from Discogs or MusicBrainz to a cue file and gain tags are offset, the offset functionality will be disabled for subsequent imports to the same cue file. If this was not done and you updated the metadata more than once, the gain values would be successively modified. The cue file will contain a comment line as follows which Yate uses to detect that offsetting has already occurred:
  REM COMMENT Yate RG

The following settings are used when importing and creating cue sheets:

Do not process REM REPLAYGAIN tags
  Extended tags named: REM REPLAYGAIN_ALBUM_GAIN, REM REPLAYGAIN_ALBUM_PEAK, REM REPLAYGAIN_TRACK_GAIN and REM REPLAYGAIN_TRACK_PEAK are used to represent replay gain parameters. If this option is not enabled, existing ReplayGain tags will be retained when importing. When creating a cue file, if ReplayGain metadata is available, the tags will be written. If this option is enabled, existing ReplayGain tags will be removed when importing. When creating a cue file ReplayGain metadata will not be written.
Write Composer metadata to SONGWRITER / REM COMPOSER
  The cue file specification describes a SONGWRITER tag. However, many players and rippers use an alternate REM COMPOSER tag. This option allows you to choose which tag to use.
Replace double quote character (") with sequence
  The ASCII double quote character (") is used to enclose various items in a cue sheet. You can specify the character(s) to be substituted when a double quote character is found in metadata being added. Note that leading and trailing spaces are ignored. An empty field will result in a Unicode Right Double Quotation Mark character (” U+201D), being substituted. Note that some readers of cue files may accept two adjacent ASCII double quote characters (") to represent a single double quote.

An attempt is always made to write the following Tags: TITLE (album and track), PERFORMER (album and track), CATALOG (barcode), REM GENRE (genre), REM DATE (year) and ISRC. Additionally the Composer metadata is written to one of the SONGWRITER tag or a REM COMPOSER tag. When importing, older occurrences of the preceding tags are always removed.

Additional Information

Importing Metadata to Single File Cue Sheets

Creating Cue Sheets from the UI

Create Cue File action statement