Translations of this page:

Output Path Template

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

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

cuetools/template.txt · Last modified: 2009/06/25 01:28 by Gregory S. Chudov