Mp3tag provides a variety of actions, which can be applied to filenames and tags. The actions are grouped together into named sets (action groups), which can be applied independently via Actions Alt+6. If you do not want to create a reusable action group for applying one single action, the Actions (Quick) toolbar button or keyboard shortcut Shift+Alt+6can be used.
You can create, edit, duplicate, and delete action groups using the buttons on the right
or the context menu.
The up/down arrow buttons allow for rearranging the order of the selected action group.
If you're pressing the Alt key while moving actions, the
selected action group is moved to the top/bottom.
The button Utils allows for saving the current selection state to a file using the Save selection... menu item. These are then listed in the menu and can be later restored by clicking on the configuration name. The Save menu item saves the current selection state directly (this is only necessary if you choose to not exit the dialog via the OK button).
F2 | Rename action group |
F4 | Edit action (group) |
Insert | New action (group) |
Delete | Delete action (group) |
Space | Enable action group |
Ctrl+A | Select all action groups |
Ctrl+Shift+A | Invert selection of action groups |
Ctrl+E | Enable all action groups |
Ctrl+D | Disable all action groups |
Ctrl+S | Save current order and enabled state of action groups |
Alt+Up | Move action group up |
Alt+Down | Move action group down |
Alt+Page Up | Move action group to beginning of list |
Alt+Page Down | Move action group to end of list |
Allows for resizing and/or changing the image format of embedded cover art. You can choose between Original, JPEG, and PNG image formats where Original just keeps the image format of the embedded cover.
Max. Size is the maximum width and height in pixels of the embedded cover image. If the cover is smaller than the size provided, the size of the cover is not changed. Resizing the image keeps the aspect ratio.
Changes upper and lower case of selected tag fields (ARTIST, TITLE, ...) or the filename (_FILENAME) or even field names (_FIELDNAME).
The field Words begin after any of specifies some characters which are marking the beginning of a new word.
_FIELDNAME applies the case conversion settings to the field names of the files (which of course makes only sense with APEv2 or VorbisComments).
If you have problems displaying tags with characters from other charsets (like Cyrillic) in Mp3tag, the tags are probably stored in a system codepage instead of Unicode or ISO-8859-1. To convert these tags from a specific codepage to Unicode, simply create a new action Convert codepage, select the appropriate tag field(s) and choose the codepage from the drop-down list.
Please see Options > Export
Important note: Export actions are always executed after all other actions regardless of their position in the actions list.
Exports the cover art from the tag of the file to the relative or absolute filename specified by the format string. You can use placeholders like %artist% and %album% in the format string.
Formats tag fields by other fields content, i.e., this action can also be used for copying the
content of one tag field to another tag field.
You can use placeholders for any tag field and scripting functions
as format string to format the content of the field specified.
Example: to copy the content of the comment field to the encodedby field, set the
field to ENCODEDBY and the format string to %comment%.
Imports tag fields from a specified source format string.
This action type is useful if you want to split the content of one tag field to multiple other fields
(e.g. the title "Artist / Title" to the appropriate fields using %title% as source format
and %artist% / %title% as guessing pattern.
Imports the cover art specified by the absolute or relative filename into the tag of the file. You can use placeholders like %artist% or %album%.
Imports the contents of the text file specified by the absolute or relative
filename into the specified tag field. You can use placeholders like %artist%
or %album% within file name.
Example: to copy the content of the file lyrics.txt to the lyrics field,
set the field to UNSYNCEDLYRICS and the format string to lyrics.txt.
If you're choosing a file name using the file open dialog, any characters that have special functionality in Mp3tag's scripting language are automatically escaped. If you're manually entering such file names, you need to take this into account.
This action type merges duplicate tag fields (e.g. three artist fields) to one field.
The contents of the duplicate fields in the new field are separated by the specified separator string.
This action type removes duplicate tag fields (e.g. three artist fields) and leaves the first field from the tag.
This action type removes the fields entered in the edit field (e.g. COMMENT;PICTURE).
Please use PICTURE as field name if you want to remove cover art from the tags.
This action type keeps the fields entered in the edit field and removes all other tag fields from the tag (e.g. ALBUM;ARTIST;COMMENT;GENRE;TRACK;YEAR).
Please use PICTURE as field name if you want to preserve embedded cover art.
This action replaces (or removes) a given string from the selected field (e.g., album or filename)
by replacing the string specified under Original by the string specified under Replace with.
If only as whole word is enabled, Mp3tag replaces Original only
when it is matched as whole word and not as part of a word. In addition to whitespace characters,
word boundaries are defined by any of . , ; : ! ?
This action uses regular expressions when replacing strings in the specified field. Regular expressions is a formal language that is used to find strings or parts of strings that match a specific pattern. This pattern is defined in the field Regular expression and matches are replaced by the given replacement string. Please note that matches can be referenced (see Parenthesis below).
Examples of regular expressions that are useful in the context of Mp3tag can be found at the Regular Expressions topic on the Mp3tag Forums.
Note: At this action _FILENAME applies to the whole file name including its extension.
All characters except . | * ? + ( ) { } [ ] ^ $.
These characters are literals when preceded by a "\".
The dot character "." matches any single character.
* |
repeated any number of times including zero |
+ |
repeated any number of times, but at least once |
? |
repeated zero or one times only |
a{n} |
is the letter "a" repeated exactly n times |
a{n,} |
represents the letter "a" repeated at least n times with no upper limit |
a{n,m} |
represents the letter "a" repeated between n and m times |
Non-greedy repeats are possible by appending a '?' after the repeat; a non-greedy repeat is one which will match the shortest possible string.
Parentheses serve two purposes, to group items together into a sub-expression, and to mark what generated the match. $N Expands to the text that matched sub-expression N in Replace matches with.
Alternatives occur when the expression can match either one sub-expression or another, each alternative is separated by a "|".
^ | matches the start of a line |
$ | matches the end of a line |
[abc] |
will match either of "a", "b", or "c" |
[^abc] |
will match any character other than "a", "b", or "c" |
[a-z] |
will match any character in the range "a" to "z" |
[^A-Z] |
will match any character other than those in the range "A" to "Z" |
\w |
Any word character - all alphanumeric characters plus the underscore |
\s |
Any whitespace character. |
\d |
Any digit (0-9) |
\l |
Any lower case character |
\u |
Any upper case character |
\W |
non-word character |
\S |
non-whitespace character |
\D |
no digit |
\L |
non-lower case character |
\U |
non-upper case character |
\t |
Tab |
\n |
New line |
\r |
Carriage Return |
\r\n |
Windows style line break |
\xnn |
char with unicode hex value nn |
\x{nnnn} |
char with unicode hex value nnnn |
\b |
matches a word boundary (the start or end of a word) |
\B |
matches only when not at a word boundary |
Allows for setting of cover type and/or cover description of embedded cover art. If you remove the content from the description field, the description of embedded cover art will also be removed.
You can choose to apply this action only to covers of a specific type or all covers.
This action type splits the content of a tag field into multiple separate tag fields based on a given separator character.
Made with love in Dresden. Copyright © 1999-2021 Florian Heidenreich. All rights reserved.