Converters to rename files or to import tags

[Florian]

Mp3tag provides a variety of possibilities to get tag information from parts of the filename or rename files based on the information stored in the tag of a file.

The base concept behind all converters in Mp3tag is the so called format string, which describes a pattern (or template) of a filename or a line in a tag-list file.

A format string consists of any characters and predefined placeholders or scripting functions. Every placeholder begins with the percent sign %, followed by a tag field name and ends with the percent sign.
For example, the placeholder %album% refers to the Album field.

• How to rename files based on tags (Tag to Filename)?

• How to create directory structures based on the tags and move the files (Tag to Directory)?

• How to import parts of the filename into the tag (Filename to Tag)?

• How to import parts of the folder structure into the tag (Directory to Tag)?

[Florian]

How to rename files based on tags?

Renaming files, creating folders and complete directory structures from tags can be done by using the Converter > Tag - Filename with a format string. A format string is used to describe the structure of the desired filename.

Besides using normal placeholders (such as %artist%, %title%, ...) and arbitrary text (e.g., Music) it also allows for separating folders with the backslash \ character.

Here is an example that renames the file based on the tags using the Tracknumber. Title format:
$num(%track%,2). %title%
Please note, that the $num scripting function is used to ensure double-digit track numbers.

How to create directory structures based on the tags and move the files?

When you're using a backslash in a format string, Mp3tag will create a directory from the part of the format string in front of a backslash.

Here is an example that creates new directories under D:\Music:
D:\Music\$left(%artist%,1)\%artist%-%year%-%album%\$num(%track%,2). %title%
The same is also possible using relative path names (instead of an absolute path in the example above) which creates the new directory below the current working directory:
%artist%-%year%-%album%\$num(%track%,2). %title%

Please note, that the whole range of Mp3tag's Scripting Functions can be used in the format string.

[Florian]

How to import parts of the filename into the tag?

Importing tags from filenames and directory names can be done by using the Converter > Filename - Tag.

The basic concept is the notion of a format string which describes the structure of the name to import from. The format string is built of either standard text (e.g., Music), placeholders (such as %artist%, %title%, ...), or backslash characters \ that denote directory structures.

Here is an example that imports tags from a file name 02. Four Ton Mantis.mp3
%track%. %title%

Please note how the format string completely resembles the structure of the file name.

How to import parts of the folder structure into the tag?

It's also possible to import information from the directory structure of the file path where the backslash character is used to mark the different folders.

For example, the information from the path
Amon Tobin\[2000] supermodified\02 - For Ton Mantis.mp3
can be imported using
%artist%\[%year%] %album%\%track% - %title%

Of course, sometimes it's also needed to omit some information that should not imported to the tag. This can be done using the %dummy% placeholder for the unneeded part of the file path.