File Name Pattern Elements

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

Pregap

%pre%:pre_

It will be processed as if option to save pre-gaps as a separate tracks is enabled and it's a pre-gap track then [%pre%:pre_] will be replaced with value pre_ if option to save pre-gaps as a separate tracks is enabled and it's not a pre-gap track then [%pre%:pre_] will be discarded if option to save pre-gaps as a separate tracks is not enabled then [%pre%:pre_] will be discarded pre_ can be any value, but it must not contain spaces

Lossy/Lossless

[%lossy%:lossy:lossless]

It will be processed as if the input audio is lossy, the value between 1st and 2nd colon will be used if the input audio is lossless, the value after and 2nd colon will be used values for losless or lossy can also be left empty (see examples below)

Lossy/Lossless Examples

[%lossy%:lossy:losless]\%filename%	if the input audio is lossy, the output path will be defined_output_path\lossy\output_file_name if the input audio is lossless, the output path will be defined_output_path\lossless\output_file_name
[%lossy%:lossy:]\%filename%	if the input audio is lossy, the output path will be defined_output_path\lossy\output_file_name if the input audio is lossless, the output path will be defined_output_path\output_file_name
[%lossy%::lossless]\%filename%	if the input audio is lossy, the output path will be defined_output_path\lossy\output_file_name if the input audio is lossless, the output path will be defined_output_path\output_file_name

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

Examples

%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