===== Output Path Template ===== [[cuetools]] output path templates are based on [[http://wiki.hydrogenaudio.org/index.php?title=Foobar2000:Titleformat_Reference|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