CUETools Templates

From CUETools wiki
(Redirected from Cuetools templates)
Jump to: navigation, search

CUETools output path templates are based on foobar2000 title formatting syntax.

Contents

Variables

  •  %music% is replaced by current user's 'My Music' folder.
  •  %artist% is replaced by the artist name
  •  %album% is replaced by the album name
  •  %year% is replaced by the album date
  •  %discnumber% is replaced by the disc number in a multidisc release
  •  %totaldiscs% is replaced by the total number of discs in a multidisc release
  •  %unique% is replaced by the number starting from 1, and increased until the output path is unique.
  • All other variable names, e.g. %edition%, are considered tag names, and are replaced by value of the corresponding tag

Conditional section

  • Text encolosed in brackets is removed if variables inside it are undefined. For example, "[%year% - ]%album%" evaluates to "1973 - Dark Side Of The Moon" if the date is specified in CUE Sheet or tags, else it evaluates to "Dark Side Of The Moon".

Functions

  • $len(a) calculates the length of given text (in characters)
  • $max(x,y) calculates the maximum of two numbers
  • $ifgreater(x,y,a,b) evaluates to "a" if x > y, else it evaluates to "b".
  • $iflonger(a,b,c,d)
  • $ifequal(a,b,c,d)
  • $if(a,b,c)
  • $if2(a,b)
  • $if3(a,b,...)

Quotation Mark

  • Text enclosed in single quotation marks, e.g. '(%)' is inserted bypassing syntax processing; allows special characters such as %,$,[,] to be inserted. In order to insert a quotation mark character, use '' (two single quotation marks).

Examples

 %music%\Converted\%artist%\[%year% - ]%album%[ - %edition%]
 $ifgreater($max(%discnumber%,%totaldiscs%),1, - cd %discnumber%,)
 [' ('%unique%')']\%artist% - %album%[ - %edition%].cue

This default template can produce the following:

 C:\Users\johndoe\My Music\Converted\Pink Floyd\1973 - The Dark Side Of The Moon\Pink Floyd - The Dark Side Of The Moon.cue

If such file already exists, than %unique% variable will be set to 1 and the following output be produced:

 C:\Users\johndoe\My Music\Converted\Pink Floyd\1973 - The Dark Side Of The Moon (1)\Pink Floyd - The Dark Side Of The Moon.cue

If edition tag is set e.g. to CP35-3017, this will produce

 C:\Users\johndoe\My Music\Converted\Pink Floyd\1973 - The Dark Side Of The Moon - CP35-3017\Pink Floyd - The Dark Side Of The Moon - CP35-3017.cue

If %discnumber% or %totaldiscs% is greater than 1, " - cd %discnumber%" section will be activated:

 C:\Users\johndoe\My Music\Converted\Pink Floyd\1969 - Ummagumma - cd 1\Pink Floyd - Ummagumma.cue
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox