Customization of Tag Panel and File List

Mp3tag supports flexible tagging, which means that the tag fields available on the Tag Panel on the left and as columns in the File List are not fixed. While you can reference any field which is, e.g., listed in the extended tag dialog as name via a placeholder %name% in Mp3tag, it's also possible to customize the UI using these placeholders.

Customizing the Tag Panel

The Tag Panel is the sidebar on the left of the File List that shows the fields to enter metadata. Besides the standard fields, you can add user-defined tag fields to the Tag Panel via Preferences → Tag Panel. Here, you can add and remove fields via the + and - buttons below the fields list.

To configure a field, you need to provide a Name, which is the label text that appears on the Tag Panel. The Field is the actual tag-field name. This can be any of the pre-defined fields chosen from the drop-down list, e.g., ISRC or a custom user-defined field identifier like MYCUSTOMFIELD1.

Width allows for configuring the size of the field on the Tag Panel. Type can be either Text (most commonly used) or Check, which represents a boolean value 0 (unchecked) or 1 (checked).

Finally, individual fields can be temporarily hidden by unchecking Active.

To change the position of any of the fields, you can use drag and drop to arrange them in the field list.

Customizing the File List

The File List is the main list that lists the files loaded with Mp3tag. While it already provides a range of different columns to display file information, it can be extended and adapted to your needs via Preferences → File List. Here, you can add and remove columns via the + and - buttons below the columns list.

To configure a column, you need to provide a Name, which is the text that appears on the column header in the File List.

Value is required and denotes the content displayed in this column. It usually contains a placeholder, sometimes combined with scripting functions.

A simple example would be %ISRC%, the placeholder for the ISRC tag field. Another example would be $metasep(artist,\\), a format string that displays all existing ARTIST fields separated by Mp3tag multi-field separator \\

Field usually contains a placeholder that is used for editing the content of the field through the File List. Please note that if this field is empty, the column is write-protected. You can only use placeholders for tag fields (e.g. %ISRC%) as well as %_filename_ext% and %_filename% here.

If Sort by is empty, Mp3tag uses the contents of Value for sorting. Otherwise, the evaluated content of this field is used.

The Numeric checkbox affects the sorting of the column and determines if the column contents are aligned left or right.

Finally, individual columns can be temporarily hidden by unchecking Active. Showing and hiding columns is also possible via the right-click context menu on the File List column header.

To change the position of any of the columns, you can use drag and drop to arrange them in the columns list or directly by dragging the column header in the File List.

Further Reading

1 Like