File Name Pattern Elements

Jump to navigation Jump to search

Elements from file name and/or audio stream

%filename% Output file name (created from the input file name).
%folder% Input file name folder, e.g. audio for file c:\some\folder\audio\file.flac.
%outputfiletype% Output file type, e.g. mp3.
%filetype% The same as %outputfiletype%
%language% Language (for file with multiple audio streams).
%streamid% Audio stream index.
%codec% Input file Codec.
%nchannel% Channel number (used in "Split into file per channel").
%chname% Channel name (used in "Split into file per channel"), e.g. (FL, FR, C, etc).
%channels% Number of channels of the output file.
%originalfilename% Input file name (used in "Split By" file name pattern). Also, if files were added vie CUE file, input file name will be used for output.

Metadata elements

%albumartist% Album artist
%artist% Artist
%album% Album
%track% Track
%track2% 2 digit track number, i.e. values 1-9 will be left-padded with a zero (01, 02, etc.).
%disc% Disc
%disc2% See %track2%
%disc3% The same as %disc%, only if value is 1/1, it will be discarded.
%title% Title
%year% Year
%date% Date
%genre% Genre

Optional parts

Some parts of the Pattern can be marked as optional, which means that if Metadata element in that part is empty, the whole part will be discarded. Optional part is enclosed in brackets [ ]. For example:

%albumartist%[ - %album%]\%track2%. %title% If %album% is empty, then everything, which was enclosed in [ ] will be discarded (including dash and space).
%filename%_(%streamid%[_%language%][%codec%]) Here, if %language% is empty, underscore won't be added to the output file name.
  • It is also possible to add several, comma separated, tag patterns elements in []. In this case the first non-empty value will be used.
[%title%,%album%] If %title% is not empty, it will be used. If %album% is not empty, then it will be used. If both, %title% and %album% are empty, the whole [] block will be discarded.
[%title%,%album%][-%albumartist%,-%performer%] You can use multiple [] blocks. Dash before the pattern element will be retained, if the pattern element is used. Otherwise it will be discarded.

Tags with multiple values

It is possible to access value of the tag by index, e.g. %genre(1)% will return first value.

Case conversion

Is is possible to change case of the Metadata elements using the following:

  • To have element in UPPER case, either add a prefix U to it (e.g. %Utitle%, %Ufilename%) or have it all in uppercase (e.g. %TITLE%, %ALBUM%, %FILENAME%).
  • To have element in lower case, add a prefix L to it (%Ltitle%, %Lfilename%).
  • To have element Capitalized, add a prefix C to it (%Ctitle%, %Cfilename%).

Date conversion elements (taken from Linux)

%% a literal %
%a locale's abbreviated weekday name (e.g., Sun)
%A locale's full weekday name (e.g., Sunday)
%b locale's abbreviated month name (e.g., Jan)
%B locale's full month name (e.g., January)
%c locale's date and time (e.g., Thu Mar 3 23:05:25 2005)
%C century; like %Y, except omit last two digits (e.g., 20)
%d day of month (e.g., 01)
%D date; same as %m/%d/%y
%e day of month, space padded; same as %_d
%F full date; same as %Y-%m-%d
%g last two digits of year of ISO week number (see %G)
%G year of ISO week number (see %V); normally useful only with %V
%h same as %b
%H hour (00..23)
%I hour (01..12)
%j day of year (001..366)
%k hour, space padded ( 0..23); same as %_H
%l hour, space padded ( 1..12); same as %_I
%m month (01..12)
%M minute (00..59)
%n a newline
%N nanoseconds (000000000..999999999)
%p locale's equivalent of either AM or PM; blank if not known
%P like %p, but lower case
%r locale's 12-hour clock time (e.g., 11:11:04 PM)
%R 24-hour hour and minute; same as %H:%M
%s seconds since 1970-01-01 00:00:00 UTC
%S second (00..60)
%t a tab
%T time; same as %H:%M:%S
%u day of week (1..7); 1 is Monday
%U week number of year, with Sunday as first day of week (00..53)
%V ISO week number, with Monday as first day of week (01..53)
%w day of week (0..6); 0 is Sunday
%W week number of year, with Monday as first day of week (00..53)
%x locale's date representation (e.g., 12/31/99)
%X locale's time representation (e.g., 23:13:48)
%y last two digits of year (00..99)
%Y year


%filename%_(%streamid%[_%language%][_%stream_name%]) Output file name will be like inputfilename_(1_eng_main track).
0%nchannel%_%filename% Output file name will be like 01_inputfilename, 02_inputfilename, etc.

« Go Back