Mp3tag for Mac on Mp3tag: the universal Tag Editor for Mac

About

Mon, 01 Jan 0001 00:00:00 +0000

Hi, I’m Florian Heidenreich, an Indie Software Developer living in Dresden, Germany.

When I started working on Mp3tag for Windows more than 20 years ago, I loved the idea of creating software and giving back to the community. Over the years, this initial intention hasn’t changed. In addition, I’ve got to know many people from all around the world who enjoy using Mp3tag and get value out of it. This gives me a ton of motivation.

Beta

Mon, 01 Jan 0001 00:00:00 +0000

You’re reaching this page because the beta program for Mp3tag for Mac has now ended. I’m confident, that Mp3tag for Mac is now in good shape and I’ve just released it to the Mac App Store.

Thank you

If you participated in the alpha or beta testing phase, I want to thank you for your support! It’s been marvelous to see how you’re using Mp3tag and what features you value most. Mp3tag for Mac is at this stage also because of your helpful bug reports and feedback.

Changelog

Mon, 01 Jan 0001 00:00:00 +0000

Mp3tag 1.13.1

Jun 21 2026

Fixed

Regression where directly editing metadata via the File List did not continue editing when navigating via Return or Tab keys.

Mp3tag 1.13.0

Jun 20 2026

New

Added support for RF64 WAV files > 4GB.
Added action type to remove Where From extended filesystem attributes.
Added support for file_xattr_where_froms information field, which contains extended filesystem attribute data describing where the file was obtained from.

Changed

Disabled the action groups toolbar menu segment if no action groups are available to choose from.

Fixed

Cover changes made in the Tag Panel were discarded if Extended Tags was used before saving.
Unsaved Tag Panel changes could be ignored when using Cover Search, Tag Sources, Converters, Auto-Numbering, or Actions before saving.
Regression where decimal BPM values were no longer truncated to integers when writing MP4 tags, which resulted in a user-defined TEMPO field being written.
MP4 atoms with empty content could not be modified or removed.
Using text-only toolbar items did not work as expected.

Mp3tag 1.12.2

May 14 2026

Fixed

Large integer metadata values were truncated to the preferred storage width when writing MP4 atoms like ITUNESCATALOGID.

Mp3tag 1.12.1

May 6 2026

New

Added support for specifying complete file paths for export and playlist filenames.

Fixed

Function SayFormat from Web Sources Framework did not support the documented optional second parameter.

Mp3tag 1.12.0

Apr 1 2026

New

Added support for Liquid Glass and other improvements on macOS 26 Tahoe.
Added Manage Covers… (⇧⌘C) to the Covers menu, allowing you to add, remove, replace, adjust, and reorder embedded cover art for one or multiple files.
Added Edit → Covers menu for cover-related functions.
Added ⇧⌘A keyboard shortcut for adding covers.
Added View → Quick Look with keyboard shortcut ⌘Y.
Added Quick Look to the context menu..

Fixed

Fixed an issue where Quick Look failed due to a sandboxing error if files were not explicitly opened via File → Open.
Fixed a regression where unknown MP4 atoms were removed during rewrites if the configuration option Settings → Advanced → Reuse unmodified MP4 atoms was not enabled.

Mp3tag 1.11.0

Feb 27 2026

New

Added support for cover-only search via Tag Sources.
Added an advanced configuration option to reuse unmodified ID3v2 frames.
Added an advanced configuration option to reuse unmodified MP4 atoms.
Added an advanced configuration option to use a single MP4 atom for multiple values.
Added support for MP4 H.266 and VP9 video codecs.
Added support for creating multiple field values using the multiple fields delimiter \\ at action Import Tag Fields.

Fixed

Folder separator / in field values created folders when renaming files based on tags in some cases.
Folders ending with a supported file extension were listed as pseudo-files in the File List.
Regression where validation for MP4 data atoms of type UTF-8 was too strict and did not allow trailing NULLs anymore.

Mp3tag 1.10.3

Jan 9 2026

New

Added Ukrainian localisation.

Changed

Added writing of all cover types to Apple MP4 metadata.
Added support for writing covers of type Artist, Media, and Icon for MP4 via Nero tags to improve compatibility with other apps.

Mp3tag 1.10.2

Dec 30 2025

Fixed

Writing MP4 tags to specific fragmented/streaming MP4 files is no longer refused.

Mp3tag 1.10.1

Dec 28 2025

Fixed

Fixed cover thumbnails with width greater than height could overlap in the next File List column.
Fixed writing MP4 tags to specific fragmented/streaming MP4 files corrupted the file and now simply refuses to tag the file.

Mp3tag 1.10.0

Dec 21 2025

New

Added a Customize… entry to the context menu when right-clicking the File List column header.
Added a configuration option to change drag-and-drop behaviour to add files to the File List by default.
Added keyboard shortcut ⌘↓ to show the history helper menu when the focus is on the input field.
Added keyboard shortcut ⌘+ to show the placeholder helper menu when the focus is on the input field.
Added keyboard shortcut ↓ to show the history and placeholder drop-down menus when the focus is on the menu buttons.
Added wildcard support * and ? at action Import Cover.
Added placeholder support when setting descriptions via action Set Cover Properties.
Added support for user-defined cover filename presets for saving artwork from the Tag Panel.
Added a Reset to defaults option in Preferences.
Added support for removing history entries for the Replace and Replace with Regular Expression actions.
Added support for exporting and importing action groups.
Added the $list() scripting function.
Added an option to include or exclude subfolders when loading files.
Added support for managing secure folder access in Settings → General.
Added the Insert, SayVar, Use, and UseFormat commands to the Web Sources Framework.
Added support for sorting tracks and files by clicking table columns in the Tag Sources results dialog.
Added Russian localisation.

Changed

Preserved selection when sorting list of Tag Sources search results.
Visualised placeholders for fields Value, Field, and Sort by in Settings → File List.
Added format-string helper menus for fields Value, Field, and Sort by in Settings → File List.
Updated json_select_array in the Web Sources Framework to support JSON arrays as an unnamed root element.
Improved control widths in Settings → Export.

Fixed

Fixed an issue where the Tag Sources tracks table occasionally reset its size.
Fixed an issue where informational properties (height, width, and color depth) were not written for FLAC pictures.
Fixed incorrect bitrate reporting for very short MP3 tracks (under one second).

Mp3tag 1.9.13

Nov 11 2025

Changed

Minor adjustments to function SayFormat from Web Sources Framework.

Fixed

MP4 mean atoms with uncommon namespaces were no longer displayed (since v1.9.7).

Mp3tag 1.9.12

Nov 8 2025

New

Added mp4_creation_time, mp4_creation_time_raw , mp4_modification_time, and mp4_modification_time_raw information fields to display MP4 mvhd creation and modification dates.
Added scripting function $dedup(x,y,c) to remove duplicated strings from x, separated by y, optionally using case-insensitive comparison if c is set to 1.
Added support for importing COMPOSER from extra artist role Music-By for Discogs Tag Sources.
Added function SayFormat to Web Sources Framework

Mp3tag 1.9.11

Oct 28 2025

New

Added support for Traditional Chinese localization.

Fixed

Performance improvements at Convert → Text - Tag with large amounts of text.
Enabled option to replace invalid NTFS characters also replaced slash character / in %_folderpath when constructing file names via Convert → Tag - Filename.
Scrolling to the end of a Tag Panel field with content exceeding the visible range wasn’t possible via Cmd+Right Arrow after saving tags.
Premature end of processing Tag Sources when condition for while loops wasn’t satisfied.

Mp3tag 1.9.10

Sep 24 2025

Fixed

MP4 gnre atom for GENRE used type identifier that was incompatible with Apple Music so that Unknown Genre was displayed instead of the actual genre (since v1.9.7).

Mp3tag 1.9.9

Sep 23 2025

New

App icon for macOS 26 Tahoe including dark, tinted, and clear variants.

Fixed

MP4 fields TOTALTRACKS and TOTALDISCS were not written, if accompanied TRACK and DISC were not changed (since v1.9.7).

Mp3tag 1.9.8

Sep 16 2025

Changed

Save toolbar button and menu item are now always enabled when files are selected.

Fixed

Added a workaround for an issue where toolbar symbols did not immediately update their enabled state on macOS 26 Tahoe when the File List selection was changed using the mouse.

Mp3tag 1.9.7

Sep 12 2025

New

Added Remove Tag toolbar icon (available via Customize Toolbar…).

Changed

Use the parent directory in File → Open… if the last opened directory is no longer available.
Added tag version display to Extended Tags when viewing individual files.
Modified Extended Tags column sizing so the Field column only uses the necessary width.
Adjusted control sizes for compatibility with macOS 26 Tahoe.
When a Nero tag needs to be written for MP4, a minimal version is now used without duplicating other global metadata.
Added a workaround for an issue on certain NAS systems (e.g., ReadyNAS) where file descriptors can become invalid (EBADF, error 9). The workaround can be enabled by setting NetworkFileLockingEnabled -bool no via defaults.

Fixed

Internal changes to ensure fields for format strings work with macOS 26 Tahoe.
Scripting function $num(x,y) did not preserve a negative sign for the first parameter.

Mp3tag 1.9.6

May 17 2025

Changed

After opening Quick Look with the space bar, you can now navigate to the previous or next file using the up and down arrow keys without needing to refocus the file list.

Fixed

Tag Sources functions SayNextNumber, SayDate, and SayDuration were too forgiving on some inputs.

Mp3tag 1.9.5

May 7 2025

Fixed

Previous inputs for Original and Replace were not stored in dropdown-history menus for action Replace.
Previous inputs for Regexp and Replace were not stored in dropdown-history menus for action Replace with Regular Expression.
Some dropdown-history menus used a font different from the regular system font.
Using a negative parameter at Tag-Sources function SayNChars did not work correctly.
If the search string used for Tag-Sources function FindInLine was not found, the internal index was at the last character of the line instead of past the last character of the line.

Mp3tag 1.9.4

Apr 29 2025

Fixed

Files located within folders that share the same name as the file were not handled correctly.

Mp3tag 1.9.3

Apr 15 2025

New

Added scripting function sort to sort parts of a given string delimited by a given delimiter string.
Added Matroska mappings for CATALOGNUMBER, ENCODERSETTINGS, TVEPISODE, TVNETWORK, TVSEASON, and TVSHOW.
Added using Discogs Release ID from clipboard when searching via Discogs Release ID Tag Source.
Added option to stop, skip, and retry with apply to all on errors when deleting files.

Changed

Added deletion of files if trashing is not supported by the underlying file system.
Changed to use T=50 Album als default target type for MKV Matroska video files.
Improved calculation of bitrate for CBR MP3 files with a Xing Info header.
Added removing of trailing empty data that is not part of the RIFF file structure when saving WAV files.
Updated Danish localization.

Fixed

Fixed error when writing WAV files that have trailing garbage data that is not part of the RIFF file structure.

Mp3tag 1.9.2

Mar 14 2025

Changed

Further improved focus and default-button handling in Tag Sources search window.
Improved performance when selecting many files, which might be especially noticeable on files from network shares.
Added detection of invalid ID3v2.2 frames in ID3v2.3 and ID3v2.4 tags and translation to target revision if possible.

Mp3tag 1.9.1

Feb 18 2025

Fixed

Check for minimum required version of Mp3tag for a Tag Source resulted in misleading error messages since the previous version.

Mp3tag 1.9.0

Feb 18 2025

New

Added support for Matroska with MKA, MKV, and WebM.
Added support for replacing displayed cover via Tag Panel.
Added option to revert edits in Tag Panel fields by pressing Esc.
Added scripting function $uuid() to create a 128-bit universally unique identifier (UUID).
Added support for Danish localization.

Changed

Use search button as initial default button at Tag Sources search window and next button as default after results have been queried.
Improved tab order at Tag Sources search window.
If an undo operation in a Tag Panel field restores the original value, the change won’t trigger automatic saving of metadata.
Multiple genre fields are written using the respective MP4 atom identifiers and not as custom fields to improve compatibility with other apps.
ID3v2.4 frames with incorrect encoding of unsynced integers are read.

Fixed

Undoing adding, pasting, or removing a cover did undo the previous action.
Unsaved changes in the Tag Panel are preserved when renaming files via Convert → Tag - Filename.
Unsaved changes from Tag Panel are used for Convert → Tag - Tag and Convert → Assign Track Numbers.
Unsaved changes from Tag Panel are used when displaying Extended Tags.

Mp3tag 1.8.27

Oct 22 2024

Fixed

Choosing Open With from the context menu opened only one file in the target app even if multiple files were selected.

Mp3tag 1.8.26

Oct 11 2024

Fixed

Reloading tags of individual files via File → Refresh Tag or ⌥⌘R resulted in app not responding.

Mp3tag 1.8.25

Sep 30 2024

Fixed

Workaround for infinite backtracking had unwanted side-effects for matching of patterns ending with characters that are reserved in regular expressions.

Mp3tag 1.8.24

Sep 30 2024

New

Added option to stop, skip, and rename with apply to all on errors when renaming files via actions.

Changed

Attempting to delete a file which was already deleted externally resulted in an unnecessary error message.

Fixed

Choosing Skip and checking Apply to All on errors when writing tags did not skip subsequent files that produced an error.
Format string field menu buttons could not be accessed via VoiceOver modifier key for Export and Filename to Tag.
Update 32-bit MP4 stco chunk-offset atoms to 64-bit co64 chunk-offset atoms if referenced sizes are exceeding the unsigned int 32-bit range.
Added a workaround for possible hangs caused by infinite backtracking of the regex engine when importing a large number of tags from text files and the format didn’t match the input.
Resolved high memory usage when determining cover sizes of huge covers when loading a large amount of files.

Mp3tag 1.8.23

Jul 16 2024

New

Added Show in Finder to main menu.
Added column with cover dimensions to list of query results for Discogs Tag Sources.
Added support for renaming LRC and CDG along with corresponding audio files.
Added support for ©enc MP4 atom which is mapped to ENCODEDBY.
Added support for sdes MP4 atom which is mapped to STOREDESCRIPTION.
Added support for detection of AV1 video tracks in MP4.
Added support for Opus in MP4.

Changed

Internal changes to parts that are responsible for reading and writing MP4 metadata.
Updated to FLAC 1.4.3.
Updated to Opus 1.5.1.

Fixed

Filtering based on format string did not always work when format string contained filter operators.
Format string field menu buttons could not be accessed via VoiceOver modifier key.
Selecting an item from the fields menu via keyboard or VoiceOver added it at the beginning of the format string field instead of the current cursor position.

Mp3tag 1.8.22

May 10 2024

Fixed

Renaming folders to nested subfolders via action Format Tag Field for _DIRECTORY on multiple files was applied on already renamed folder in some cases.
JSON-related functions json_foreach and json_foreach_end of Web Sources Framework reverted back to root object and not to previously selected object.

Mp3tag 1.8.21

Apr 11 2024

Changed

Added support to add multiple values for fields from Tag Sources.
Improved compatibility of Web Sources Framework function RegexpReplace with CR characters (carriage return) in input data.

Mp3tag 1.8.20

Mar 28 2024

Fixed

Occasional crash due to concurrent read/write access to internal storage.
Tag Sources with Windows line breaks CR LF produced extra empty line for each line break.

Mp3tag 1.8.19

Mar 25 2024

Fixed

Resolved high memory usage when applying a quick action of type Adjust Cover on a large amount of files.
Copying many files to the clipboard could result in a huge delay on quit.
Nero MP4 cdec atom for encoder settings was not preserved when writing tags.

Mp3tag 1.8.18

Mar 19 2024

Fixed

Addressed an occasional crash when dragging cover art from the Tag Panel.
Addressed an occasional crash when fields were deselected (via Cmd+Click) from some of lists for field selection.
Addressed a rare crash when calculating totals of lengths and size of selected files shown in the status bar.

Mp3tag 1.8.17

Mar 11 2024

Fixed

Further refinements regarding accessing files in the recommended way of encoding Unicode file names of the underlying file system.

Mp3tag 1.8.16

Mar 11 2024

Fixed

Added workaround for macOS caching issue on ExFAT file systems related to file names in Unicode NFC form.

Mp3tag 1.8.15

Feb 21 2024

Fixed

Removed normalization of linebreaks when reading ID3v2 frames USLT (UNSYNCEDLYRICS) and COMM (COMMENT) to prevent display problems in Music.app.
Prevented accidental drop and resulting duplicate of own dragged image when dragging cover art.

Mp3tag 1.8.14

Feb 20 2024

Fixed

Images added from Firefox via drag and drop could not be saved.
Using a negative value for maximum number of items to select at json_select_many resulted in a crash.

Mp3tag 1.8.13

Jan 23 2024

New

Added option to stop, skip, and rename with apply to all on errors when renaming files.
Added option to stop, skip, and retry with apply to all on errors when writing files.
Added option to stop, skip, and replace with apply to all on errors when copying and moving files.
Added support for Dutch localization.

Fixed

File permissions and ACLs were not preserved in some cases if writing tags involved temporary files.

Mp3tag 1.8.12

Jan 04 2024

Fixed

Using Web Sources Framework function findinline on strings with non-ASCII characters could in certain situations result in an application crash.

Mp3tag 1.8.11

Nov 29 2023

Fixed

Check for minimum required version of Mp3tag for a Tag Source did not compare all version segments numerically, which resulted in misleading error messages since the last version.

Mp3tag 1.8.10

Nov 28 2023

New

Added support for removing only duplicate fields that have the same content at action Remove duplicate fields.

Fixed

Changes that were made in individual files via navigation in Extended Tags were written to a different file in rare cases.

Mp3tag 1.8.9

Nov 6 2023

Changed

Added workaround for WordSeparator configuration setting misspelled as WordSeperator in Tag Sources.

Fixed

Leading and trailing quotes were accidentally removed from parameters of Web Sources Framework functions which resulted in unstable behaviour of certain Tag Sources.

Mp3tag 1.8.8

Oct 27 2023

New

Added function SayDate to Web Sources Framework.
Added support to reference contents of output buffers via %output% in string parameters of Web Sources Framework functions.

Changed

Added special handling for iTunEXTC field name for MP4.

Fixed

ID3v2 UFID was not always correctly detected as binary or text-only frame.
Cover dimensions on Tag Panel were reported as larger size in some rare cases.

Mp3tag 1.8.7

Sep 27 2023

Changed

Updated for macOS Sonoma.
Menu items File → Copy to… and File → Move to… were also enabled if no files were selected.
Extended JSON-related functions json_select_many and json_select_many_count of web sources framework with optional parameter to include result entries for non-existent items.

Mp3tag 1.8.6

Sep 11 2023

Fixed

Using web sources framework function findinline on empty input could result in an application crash.

Mp3tag 1.8.5

Sep 4 2023

Fixed

Fetching cover thumbnails via Tag Sources resulted in a blocked user interface, if the server terminated the connection prematurely.

Mp3tag 1.8.4

Aug 18 2023

New

Added support for localization of Tag Source configuration settings.

Mp3tag 1.8.3

Aug 17 2023

Fixed

Tag Source configuration settings were not saved, because required file settings.json wasn’t automatically created on first use.

Mp3tag 1.8.2

Aug 15 2023

New

Added support for editing Tag Sources configurations via the Tag Sources menu.
Added functions IfVar and IfNotVar to Web Sources Framework to check configuration settings from Tag Sources.
Added new key [Settings]=Tag Source Configuration.settings to provide a settings schema for Tag Sources.
Added new key [MinAppVersionMac] to require a minimum version of Mp3tag for a Tag Source to be used.
Added support for audio MD5 via %_md5audio% for WavPack.

Fixed

Composing URLs in Web Sources Framework did not use Encoding and WordSeparator values from Tag Source definition

Mp3tag 1.8.1

Jul 21 2023

New

Added scripting function fmtDuration to create a formatted duration string based on numerical input.
Added function SayDuration to Web Sources Framework.
Added JSON-related function json_select_many_count to Web Sources Framework.
Added JSON-related function json_foreach_counter to Web Sources Framework.
Added JSON-related function json_foreach_reverse to Web Sources Framework.

Changed

Extended json_select_many with optional parameters for last item separator and max items to select.

Mp3tag 1.8.0

Jun 29 2023

New

Added navigation to next and previous files from extended tags dialog.
Added support for copying files.
Added support for moving files.

Changed

Added auto-selection of newly added files when loading files.
Added a confirmation prompt in case the extended tags dialog is dismissed with pending changes.

Fixed

Resolved high memory usage when applying an action of type Adjust Cover on a large amount of files.

Mp3tag 1.7.8

May 4 2023

Fixed

Preview at Convert → Tag - Tag automatically resized window to fit preview text, which could exceed screen width.

Mp3tag 1.7.7

Mar 28 2023

Fixed

Fixed regression from previous version where selecting a search result at Custom Tag Sources had no effect.

Mp3tag 1.7.6

Mar 25 2023

New

Added support for file matching via %_filename_ext% and %_path% when importing tags from text file.

Changed

Parsing text to tags allowed to create fields starting with an underscore.

Fixed

Selecting a word via double-click when editing filenames in the File List instead selected the whole base filename without extension under macOS Monterey.
Progress dialog wasn’t dismissed automatically if search via Tag Sources returned no results.

Mp3tag 1.7.5

Feb 7 2023

Fixed

Error message when writing files on network shares with certain file systems and where the target file size exceeded the original file size.

Mp3tag 1.7.4

Feb 6 2023

Fixed

Last line of script was omitted when parsing Custom Tag Sources.
Command KillTag at Custom Tag Sources wasn’t supported yet.

Mp3tag 1.7.3

Jan 27 2023

Changed

BPM field for MP4 now only displays the bpm value without extra formatting.
Added support for Zero Width Joiner (ZWJ) and Zero Width Non-Joiner (ZWNJ) Unicode characters when renaming files from tags.

Fixed

Action import tag fields did not match multiline input.
Using the red close button to close certain action configuration windows locked the app.

Mp3tag 1.7.2

Jan 16 2023

Fixed

Last character was truncated when writing ID3v1 fields in some cases.

Mp3tag 1.7.1

Jan 7 2023

New

Added format string history for Preferences Playlist Filename.
Added format string history for Preferences Export Filename.
Added format string history for Preferences Copy Format
Added format string history to Export Cover action dialog.
Added format string history to Import Cover action dialog.
Added format string history to Import Text File action dialog.

Fixed

Last used Tag Source was triggered only via menu item but not via keyboard shortcut ⌘I
ID3v2 WXXX frames with user-defined descriptions could not be added.

Mp3tag 1.7.0

Dec 16 2022

New

Added support for multiline text fields on Tag Panel.
Added format string history to Export dialog.
Added preferences setting for Export filename.
Added preferences setting for Playlist filename.
Added preferences setting for Copy Format used when copying a textual representation via ⌘C to the clipboard.

Changed

Improved detection and importing of COMPOSER from Discogs.
Improved keyboard navigation for settings window.

Mp3tag 1.6.7

Nov 9 2022

Fixed

Fixed occasional crash at searching via Custom Tag Sources for direct album and multiple search parameters.

Mp3tag 1.6.6

Oct 26 2022

New

Added support for macOS 13 Ventura.
Added support for importing COMPOSER from Discogs.
Added $strrstr(x,y) scripting function, which finds the last occurrence of string y in string x.

Mp3tag 1.6.5

Oct 20 2022

Changed

Information field %_id3v2_unknown_frames% now reports the ID3v2 frame identifiers.

Fixed

Fixed occasional crash when selecting parts of the filename while editing in the File List.

Mp3tag 1.6.4

Oct 5 2022

Changed

Performance improvements when parsing data for Custom Tag Sources.

Fixed

Fixed Help → Mp3tag Help showed no help error message for some dialogs.
Fixed error messages at Custom Tag Sources used line numbers from input instead of Tag Source which made it hard to analyze potential issues.
Fixed findinline at Custom Tag Sources didn’t move position at end of line if text wasn’t found.

Mp3tag 1.6.3

Sep 20 2022

Changed

Updated to libFLAC 1.4.0.

Fixed

Fixed two potential crash issues at Custom Tag Sources.

Mp3tag 1.6.2

Sep 14 2022

New

Added information field %_id3v2_unknown_frames% to identify files with unsupported ID3v2 frames.

Fixed

Using URL as search term at Custom Tag Source to directly jump to result didn’t work due to wrong encoding of URL.

Mp3tag 1.6.1

Sep 1 2022

New

Added support for music player app Doppler so that changes made Mp3tag are reflected back in Doppler after saving.

Changed

Added auto-conversion of HTTP to HTTPS for Custom Tag Sources.

Mp3tag 1.6.0

Aug 25 2022

New

Support for Custom Tag Sources.

Mp3tag 1.5.2

Jul 15 2022

Fixed

Progress dialog didn’t close when querying Tag Sources and none of the results had cover art.

Mp3tag 1.5.1

Jul 14 2022

New

Added Discogs Tag Source for querying by free text.
Added Discogs Tag Source for querying by artist and track title.
Added support for WavPack.

Changed

Changed order of search fields for Tag Sources to be consistent.

Fixed

Non-deterministic behavior in filter operator precedence.
Filter operators EQUAL, GREATER, and LESS didn’t support negative operands.
error when renaming directory to child directory of source directory.
ID3v1 genre number in ID3v2 TCON frame was not translated for ID3v2.4.
Removing APEv2 tags from Musepack had no effect.

Mp3tag 1.5.0

May 27 2022

New

Added cover thumbnails to list of Tag Sources search results.
Added support for importing via direct text input at converter Text file - Tag.
Added action type Convert Codepage.
Added action type Import Text File.
Added action type Set Cover Properties.
Added support for MP4 .m4r files.

Changed

Added support for editing action groups also when no files are selected.
Changed to use placeholders for current cover at action Export Cover.

Fixed

Fixed an issue where clipped toolbar items were always disabled.
Added a workaround to collect all files when loading via Open with… even if system sends open notifications in multiple runs.

Mp3tag 1.4.4

Apr 26 2022

New

Added support for importing .mta action groups from Mp3tag for Windows.

Mp3tag 1.4.3

Apr 21 2022

New

Added support for importing ISRC — International Standard Recording Codes — via MusicBrainz tag source.
Added BARCODE and CATALOGNUMBER to default list of fields.

Changed

Changed Discogs and MusicBrainz tag sources to use CATALOGNUMBER instead of CATALOGID to improve compatibility with other software.
Added workaround for non-null padding bytes for INFO subchunks in WAV and AIF.

Fixed

Action case conversion had no effect on directory name.
Externally renamed folders with capitalization-only changes used previous capitalization on reload.

Mp3tag 1.4.2

Mar 15 2022

New

Added support for .paths files.
Added support for loading files via paste ⌘V

Changed

Added workaround for MP4 data atoms with superfluous trailing null byte.
Filter GREATER and LESS didn’t treat numerical strings as numbers.

Mp3tag 1.4.1

Feb 18 2022

New

Added support for multi-value MP4 fields written as multiple data atoms.
Added internal mapping for MUSICBRAINZ_TRACKID field.
Added information field %_cover_description% which provides the description of the first cover art in the tag of the file.
Added option to reorder fields and columns via keyboard ⌘↑ ⌘↓ at Preferences.
Added option to reorder files via keyboard ⌘↑ ⌘↓ at Tag Sources results window.

Changed

Added reporting of unsupported or corrupted file structure as error to ‘Tag’ column.
Added workaround for missing padding bytes for INFO subchunks in WAV and AIF.
Ensured that characters with accents or umlauts are using the Unicode Normalization Form C when querying Tag Sources.
Ensured characters with accents or umlauts are imported using the Unicode Normalization Form C from filenames.

Mp3tag 1.4.0

Jan 25 2022

New

Added option for adjusting cover to not crop but resize.
Added display of target file size when adjusting cover.
Added preferences setting for file list size.

Changed

Changed default cover size for MusicBrainz tag source to 1200 px.
Changed Tag Sources results table to have focus after searching.
Changed smaller font sizes used in some windows to standard system font size.

Fixed

File creation date wasn’t preserved if temporary files are involved when writing changes.
Replace with regular expression for _FILENAME allowed to remove file extension.
Changing enabled state of fields at Tag Sources result via Option + Click didn’t change all fields in some cases.
Added workaround for a write error when trying to perform changes to a file under /System/Volumes/Data/.

Mp3tag 1.3.2

Dec 10 2021

New

Added Tag Panel toolbar item.
Added support for undo when editing via extended tag dialog.
Added support for importing remix artists via Discogs tag source.

Changed

Confirming when editing via extended tag dialog is now also possible via ⌘⏎.
Added progress reporting when downloading cover art via Tag Sources.
Changed progress to be no longer based on macOS alert.

Fixed

Formatstring placeholders did not match empty sequences, e.g., when importing tags from text files.
Dynamically created menus (actions, sort by, tag sources) were only visible to the system after first use.
Action groups menu items were active even if no file was selected.
Removed empty parentheses from MEDIATYPE when importing from Discogs and format had no descriptions.
Field enabled state for Tag Sources was reset when cancelling on search result.

Mp3tag 1.3.1

Nov 22 2021

New

Added support for user-defined field mappings.
Added support for refreshing tags from files without reloading directories via ⌥⌘R.
Added support for setting cover type for varying covers.
Added support for setting cover description for varying covers.
Added support for adjusting image format and size for varying covers.

Fixed

Metadata field tool was lost when writing MP4.
Delete menu item was active even if no file was selected.

Mp3tag 1.3.0

Nov 2 2021

New

Added support for macOS Monterey.
Added support for Swedish localization.
Added detection and removal of ID3v1 in FLAC.
Added support for MP4 fields NARRATOR and PUBLISHER.
Added support for APEv2 cover types other than Front and Back.

Changed

WAV and AIFF files with extra null bytes at end of RIFF chunks are now read despite these inconsistencies.
Removed duplicate media types from MusicBrainz search results.

Fixed

Channel count was not correctly reported in all cases for MP4 with AC3.
Writing cover art of the same type resulted in identical APEv2 field names which are not allowed according to the specification.

Mp3tag 1.2.3

Jul 19 2021

Changed

FLAC VorbisComment block is now always written before Picture block to increase compatibility.

Fixed

Copy and paste metadata from files to other files via internal clipboard did not work reliably in rare cases.

Mp3tag 1.2.2

Jun 29 2021

New

Added action groups and action categories to toolbar menu item.
Added action groups and action categories to main menu.
Added keyboard shortcuts to jump between Tag Panel and File List.
Added option to rewrite tags also if no input has changed.
Added support for FLAC in MP4.

Changed

Preserve selection when filtering the file list.
Combined last used Tag Source and Tag Sources menu toolbar items.
Added special handling for ID3v2 comment descriptions were case needs to be preserved.
Changed keyboard shortcut for filtering the file list to ⌘F.

Fixed

Previous selection was not restored correctly if file list is reloaded and file list changes.
Added workaround for crash on invalid JPEGs.

Mp3tag 1.2.1

Jun 15 2021

New

Added preferences setting to preserve modification date.
Added support for Polish localization.

Changed

Preserve file order when loading M3U playlists.
Double click on cover to display Quick Look preview.
Automatically select file if only one file is loaded.
Keyboard shortcut to remove tags is now ⌥⌘⌫ because ⌘⌫ is usually used to delete text from start to cursor.
Possibility to cancel at batch processing errors.
Improved filtering performance.

Fixed

ID3v2 cover art with descriptions containing umlauts or other special characters were not read correctly.
Crash at $rg2sc() scripting function.

Mp3tag 1.2.0

May 19 2021

New

Added support for reading M3U playlists.
Added support for creating M3U playlists.
Added support for exporting to text and CSV files.
Added support for complex filter expressions.

Changed

Added recently used filters to filter field menu.
Improved message that requests permission to access files and folders.

Fixed

Renaming _DIRECTORY via action Format Tag Field prevented subsequent renames of _FILENAME in same action group.
Text in Filter field was not scrollable.

Mp3tag 1.1.4

May 1 2021

New

Added an alternative distribution method that doesn’t require the Mac App Store.
Added randomize sorting option when clicking on first column header in file list.

Changed

Apply is now the default action on the Action Groups window so actions can be applied by pressing Return key.

Fixed

Renaming _DIRECTORY via action Format Tag Field failed if target directory already existed.

Mp3tag 1.1.3

Apr 20 2021

Changed

Navigate to next/previous rows via Tab and Shift+Tab keys after last/first editable column in file list is reached.
Added detection of macOS App Translocation for trial version and ask to move the app to Application to prevent all sorts of random issues.

Fixed

Copying from temporary to original file failed on network drives in some cases if file was opened by an external process.
Collecting user-defined fields at input didn’t prevent duplicates in fields list in all cases.

Mp3tag 1.1.2

Apr 12 2021

New

Added support for Japanese and Brazilian Portuguese localization.
Added support for MP4 fields DIRECTOR, ITUNESALBUMID, ITUNESARTISTID, ITUNESCOMPOSERID, ITUNESCOUNTRYID, ITUNESGENREID, and XID.

Changed

Detect unmounted network volumes to prevent waiting for timeout if set as startup folder
Not using ID3v2 unsynchronization scheme anymore when writing ID3v2.4 due to compatibility reasons with apps that don’t implement the standard.
Acquiring advisory lock when writing files.

Mp3tag 1.1.1

Mar 30 2021

New

Added support for Spanish localization.

Changed

Changed imported tags from converter Text file - Tag to be merged with existing tags.

Fixed

CRLF newline characters resulted in empty lines at import from text file.
External changes on filenames were not reflected in the file list in some cases.

Mp3tag 1.1.0

Mar 26 2021

New

Added converter Text file to Tag to import tags from text files.
Added option to Merge tag-sources results to existing tags which also keeps existing covers.
Added synchronized selection for tracks and files table at Tag Sources results.
Added synchronized scrolling for tracks and files table at Tag Sources results.
Added support to enable or disable all fields in Tag Sources result via Option + Click.
Added context-menu item on file list header to auto-size current column.
Added context-menu item on file list header to auto-size all columns.

Changed

Changed Show in Finder context-menu item to also select all files in Finder and open more than one Finder window if necessary.
Changed focus to be at first empty search field or search button at Tag Sources search window.
Improved accessibility for helper buttons in formatstring fields.
Changed to use a minimum window size.

Fixed

Write error message due to sandboxing issue on some external thumb drives if temporary files were involved.

Mp3tag 1.0.4

Mar 11 2021

New

Added support for Czech, French, Italian, and Simplified Chinese localization.

Changed

Renaming files now replaces slash character / if none is used in formatstring.

Fixed

Crash at pasting copied tag data if different files were loaded in the meantime.
Quick Look on file list also displayed cover when switching to textual Tag Panel fields.
Write error message due to sandboxing issue on some external thumb drives if temporary files were involved.

Mp3tag 1.0.3

Mar 3 2021

Changed

Changed encoding of ID3v2 cover description back to ISO-8859-1.

Mp3tag 1.0.2

Mar 2 2021

New

Added Quick Look preview to cover art window.

Changed

Removed auto-replacing reserved characters to underscore on field-lookup when renaming files.
Changed default button title text at edit extended tag dialog.

Fixed

Accessing of files and folders via secure bookmarks failed in some cases.
Action adjust cover rounded 1 pixel off when calculating new image size in some cases.
ID3v2 cover description only supported characters of ISO-8859-1.

Mp3tag 1.0.1

Feb 26 2021

Changed

Alignment of fields of type Check in Tag Panel now more in line with Text fields.
Auto-completion of Genre field in Tag Panel now uses suggested capitalization.

Fixed

Add files and folders button in toolbar didn’t add the files and instead had the same functionality as Open files and folders.
File associations for MP4 and M4V were accidentally set to default.

Mp3tag 1.0.0

Feb 18 2021

New

Added trial version.

Changed

Close app when window is closed.

Mp3tag 1.0.0-beta.13

Feb 11 2021

Fixed

Regression from beta 12 where menu at Preferences → Tag Panel → Type had no label texts.

Mp3tag 1.0.0-beta.12

Feb 10 2021

Changed

Cleanup of localization resources.

Fixed

Temporary files and folders were not always removed if MP4 files cannot be written on external or network drives.

Mp3tag 1.0.0-beta.11

Feb 7 2021

Changed

Changed edit extended tag dialog to be vertically resizable.
Changed edit extended tag dialog to have scrollbar.
Added accessibility field names when editing in the file list.

Fixed

Performing changes that require temporary files left name of temporary file in file list in rare cases.
Crash at displaying error message when running action export cover.
Ensure file list has focus after removing all files.

Mp3tag 1.0.0-beta.10

Feb 3 2021

Fixed

Regression from beta 9 where top-level action groups were not loaded correctly.

Mp3tag 1.0.0-beta.9

Feb 3 2021

New

Added Delete as alternate command for Remove menu item in main menu and file list contextual menu.
Added message alerts when deleting action groups or actions.

Changed

Accessibility improvements for Tag Panel fields.

Fixed

Crash when using single / as format string for converter Filename to Tag.
Root level action categories were always nested on reload.
Regression from beta 6 where some logical scripting functions could not be nested correctly.

Mp3tag 1.0.0-beta.8

Jan 26 2021

New

Added alternating row background colors to tracks and files tables for Tag Sources results.

Changed

Changed to expand ~/ to home directory when importing, exporting, or renaming files.
Changed to use localized display name for folders at Preferences → General → Startup folder.

Fixed

Crash when removing selection from Tag Sources tracks table.
Action Import Cover failed silently if sandbox access to image file was missing.
Folders loaded via System Services were not added to recent folders and secure bookmarks.
Not all fields were displayed at Tag Sources result in some cases.

Mp3tag 1.0.0-beta.7

Jan 19 2021

New

Added Copy, Cut, and Paste to contextual menu of file list.
Added Open in Mp3tag system service to folders and supported files.
Added support for sorting the Tag Sources results table.

Changed

Changed toolbar symbols to be slightly bigger.

Fixed

Crash at duplicating actions of type Import tag fields.
Crash when reading invalid UTF-8 from FLAC, Ogg, or Opus.
Using Tag Sources on a filtered result also used some of the unfiltered files.

Mp3tag 1.0.0-beta.6

Jan 16 2021

New

Added support to copy, cut, and paste tags from files to other files.
Added support to copy selected files externally.
Added support to copy textual representation of selected files.
Added menu View → Sort By.
Added option to randomize file list sorting via menu View → Sort by.

Changed

Changed fields with multiline contents visually more distinctive in both file list and extended tags dialog.
Changed format string token fields to scroll in single-line mode.
Changed scroll to insert location after adding fields to format string via fields menu.
Changed to always show minutes and seconds in formatted lengths.
Changed keyboard shortcut for Quick Actions to ⌥⌘6.

Fixed

File list column width was not preserved if changed via double click between column headers.
Regression where selection in file view via ⌘ and drag did not work anymore.
Copying format strings to pasteboard sometimes contained superfluous slash characters.
Format string bracket-lookup notation didn’t work if field placeholder was part of function parameter.

Mp3tag 1.0.0-beta.5

Jan 9 2021

New

Added action Adjust Cover to adjust album cover image format and size.
Added action Import tag fields (aka Guess values).
Added action Merge duplicate fields.
Added action Split field by separator.
Added action Remove duplicate fields.
Added option to Adjust Cover to cover window context menu.
Added support for reordering of files via drag and drop.
Added support for %_counter% and %_counter_total% dynamic information fields.
Added import of secondary images from Discogs in case no primary images is available.
Added option to replace invalid NTFS characters when renaming files.
Added common links and feedback option to help menu.

Changed

Changed toolbar symbols to be slightly bigger.
Changed supported file types to be individually reported to the system.

Fixed

Regression where file extension was not omitted from selection when renaming files in file list.
Cover Window still lost focus after performing changes via contextual menu in some cases.

Mp3tag 1.0.0-beta.4

Dec 28 2020

New

Added support for index tracks and subtracks to Discogs tag source.
Added information fields to format string fields menus.
Added functions to format string fields menus.

Changed

Added normalization of Discogs artist names that removes disambiguation numbers.
Changed to use folder.ext as default cover filename for drag and drop.
Changed cover export via drag and drop to use actual cover file type and data instead of conversion to PNG.
Changed default ID3v2 version to write to ID3v2.3 with UTF-16 for new installations.
Changed tokens and field names in format string fields menus to be lowercase.

Fixed

Removed trailing spaces at artist field when importing from Discogs.
Removed misleading error message that tag could not be read after removing tags.

Mp3tag 1.0.0-beta.3

Dec 22 2020

New

Added support for importing metadata and cover art via Discogs.
Added support for importing metadata and cover art via Discogs Release ID.
Added tag sources popup toolbar button to choose tag source to import from.
Added tag source toolbar button to import via last used tag source.

Changed

Improved Tag Panel layout.

Fixed

Preview at converter Tag - Tag used replacement of invalid path characters.

Mp3tag 1.0.0-beta.2

Dec 15 2020

Changed

Added word wrapping to extended tags edit dialog.
Added workaround for drag’n’drop of folders from Finder alternatives.
Changed quick actions window to be resizable.

Fixed

Blocking when writing ID3v2 TIPL (INVOLVEDPEOPLE) and TMCL (MUSICIANCREDITS) fields.
Crash when adding new field to Tag Panel via Preferences that was neither in the list of standard nor custom tag fields.
Editing mode sometimes chose previous field when adding custom fields.
Editing mode sometimes chose previous field when adding custom genres.
Error on attempting to write to locked files produced invalid program state.
File list did not have focus after saving tags by removing file selection.
File list sometimes did not have focus after loading files.
Numeric checkbox had no effect when editing preferences of file list.
Startup folder configured via „Other“ was sometimes not remembered.

Mp3tag 1.0.0-beta.1

26.02.2021

New

Added action Import Cover to import cover from file.
Added action Export Cover to export cover to file.
Added removing of ID3v2 tags from FLAC files.

Changed

Changed Tag Panel field auto-complete to allow for changing case only.

Fixed

MP3 VBRI and LAME headers were not read correctly in some cases.

Mp3tag 1.0.0-alpha.21

Dec 7 2020

Changed

Performance improvements when selecting large amounts of files.

Fixed

Writing to Ogg files failed if file couldn’t be edited inplace.

Mp3tag 1.0.0-alpha.20

Dec 2 2020

Changed

Excluded files from last used items that are opened on startup.
Excluded files from recent documents menu.

Fixed

Visual glitches at Preferences → File List under Big Sur.

Mp3tag 1.0.0-alpha.19

Nov 29 2020

Fixed

Renaming files and folders via actions and converter did not work due to sandbox restrictions in some cases.

Mp3tag 1.0.0-alpha.18

Nov 28 2020

Changed

Improved file-writing performance.

Fixed

Crash at applying imported data from tag sources in some cases.

Mp3tag 1.0.0-alpha.17

Nov 19 2020

New

Added support for Musepack.

Fixed

Regression from previous version where file loading wasn’t possible in some cases.

Mp3tag 1.0.0-alpha.16

Nov 18 2020

Fixed

Prevent file loading while other operations are running.
Menu item to add files was enabled during reading of files.

Mp3tag 1.0.0-alpha.15

Nov 13 2020

New

Updated user interface for macOS Big Sur.
Updated app icon for macOS Big Sur.
Added support for native arm64 on Apple Silicon M1.
Added ⌘D keyboard shortcuts to duplicate actions and action groups.

Changed

Changed to use joinphrase from API to concatenate multiple artists in MusicBrainz tag source.

Fixed

Startup Folder popup at Preferences → General was too wide for long folder names.

Mp3tag 1.0.0-alpha.14

Nov 6 2020

New

Added support for importing metadata and cover art via MusicBrainz.
Added support for duplicating actions and action groups.

Fixed

Action Format value for field _DIRECTORY did not work.
Action Format Value for field _FILENAME with folder specification only performed renaming if folder was created or filename was changed.
Converter Tag to Filename created empty filenames on format strings that produced an empty string.
Click on fields menu via + required format string field to have focus.
Click on format string history menu button required format string field to have focus.

Mp3tag 1.0.0-alpha.13

Oct 17 2020

New

Added support for checkbox fields on Tag Panel (e.g., COMPILATION).

Fixed

Possible crash if one or more Tag Panel items were deactivated in configuration.
Choosing quick action via return was not possible if quick action list has focus.

Mp3tag 1.0.0-alpha.12

Oct 11 2020

New

Added Quick Look preview to follow selection in file list.
Added preferences option to choose startup folder.
Added preferences option to open previous folders on startup.
Added preferences option to use, collect, and manage custom user-defined genres.
Added preferences option to hide standard genres.
Added preferences option to use, collect, and manage user-defined field names.
Added preferences option to hide standard field names.

Changed

Changed file list to enter editing mode on delayed double click.
Changed to use fields from Tag Panel als default fields in converter fields menus.
Changed Tag Panel auto-complete to be case-insensitive.
Changed Tag Panel drop-down lists to be sorted.
Changed to use monospaced digits font in file list.

Fixed

Default genres were not listed for files with empty Genre field.
Loading files after changing file list columns via preferences wasn’t possible until restart.
ID3v2 POPULARIMETER fields were not read correctly.
ID3v2 POPULARIMETER playcount was not written correctly.

Mp3tag 1.0.0-alpha.11

Oct 4 2020

New

Added Action Groups feature to run multiple actions on selected files.
Added Quick Look preview to play files from file list.
Added Dark Mode cover placeholder image.
Added < blank > option to Tag Panel field combo list to remove fields when saving tags.
Added string comparison scripting functions $strcmp() and $stricmp().

Changed

Logical scripting functions used case-sensitive comparison if parameters were strings.

Fixed

Temporary directories from creating temporary files on network drives were note removed.
Crash when double-clicking on empty space in extended tags dialog.
Toolbar and menu buttons were disabled after exporting cover art from Tag Panel.
Adding new fields to Tag Panel via Preferences didn’t focus name text field.
Adding new columns to File List via Preferences didn’t focus name text field.
Action Remove Fields checkbox Remove covers didn’t update OK button state.

Mp3tag 1.0.0-alpha.10

Aug 21 2020

New

Added Quick Actions feature to run single action on selected files.
Added action Replace to replace text in tags and filenames.
Added action Replace with Regular Expression to replace text in tags and filenames using regular expressions.
Added action Case Conversion to change upper and lower case in filenames and tags.
Added action Format value to copy and compose tag fields or filenames by other fields content.
Added action Remove Fields to remove selected fields from tags.
Added action Remove Fields Except to remove all fields except selected fields from tags.

Fixed

Creating temp files on external drives fails if files were loaded individually.
Pasting cover art from file names (e.g., from Finder) only added file icon instead of image.
External changes in filename case were not reflected in the file list.
Copy and paste of folder names with umlauts to format string fields did truncate the string in some cases.

Mp3tag 1.0.0-alpha.9

Jul 29 2020

New

Added dummy field to Filename to Tag converter field list.

Fixed

Crash at converter Filename to Tag when adding fields via menu to a format string that contains unparsed tokens.
Externally renamed folders were not updated in the file list.
Externally renamed files were not always updated in file list if filter was active.
Loading files was not possible anymore after attempting a tag change on a non-existing file.

Mp3tag 1.0.0-alpha.8

Jul 16 2020

New

Added support for Direct Stream Digital Audio (*.dsf).

Changed

Improved progress reporting to be more responsive when renaming files.
Changed to use directory of current file when adding cover art from file.
Changed to use directory of current file when saving cover art to file.
Changed to use „folder“ as default cover file name when saving cover art to file.
Tag to Tag converter did not remember window position.

Fixed

Renaming huge amounts of files reached sandbox limit and showed allow access dialog for each file.
Folders loaded via drag’n’drop were not added to the recent files list.
Reloading the file list did not sort files according to current sort descriptor.
Added files were not sorted according to current file list sorting criteria.
Adding and loading files did not always update status bar summary.
Formatstrings at converter Tag to Filename could be removed from history.
Formatstrings at converter Tag to Tag could not be removed from history.
Renaming field in Extended Tags dialog did not remove original field.

Mp3tag 1.0.0-alpha.7

Jul 4 2020

Fixed

Regression from alpha.6 where file list was not always refreshed to display latest contents and which resulted in all kinds of random behaviour.

Mp3tag 1.0.0-alpha.6

Jul 3 2020

New

Added adjusting of column width by double-clicking on column separator.
Added continue editing in next or previous file list row via Return and Shift+Return.
Added file size and track length of selected and total files to file list status bar.
Added detection of Opus in Ogg container.
Added Extended Tags toolbar item.

Changed

Added preserving selection while sorting.
Cover added via drag and drop is now stored as JPEG in case TIFF data is provided.
Added converter Tag to Tag to file list context menu.
Added expansion tooltips for truncated values in file list.
Added padding to file list status bar.

Fixed

Cover art image dimension were not calculated correctly in some cases.
Previous selection was preserved when loading new files.

Mp3tag 1.0.0-alpha.5

Jun 26 2020

New

Added converter Tag to Tag.

Changed

Improved default sorting so that files are added sorted by path and filename and only then the custom sorting column is applied.

Fixed

Editing Tag Panel fields with unsaved changes removed Tag Panel contents.

Mp3tag 1.0.0-alpha.4

Jun 17 2020

New

Added progress for renaming via converter Tag to Filename.

Changed

Improved performance of UI refresh at batch-renaming of files.
Improved performance when editing file list preferences if files are displayed.
Improved selection behavior when removing files

Fixed

Cancelling loading files prevented subsequent loading of files (since alpha.3).
Write operations that require temporary files failed if files were on different devices.
Files with non-lowercase file extensions were omitted from loading.
Files with invalid streams were not added to the file list when loading files.
ID3v1 tags with special chars are not read correctly.
Registered as Default app for some file types where Alternate app was intended.

Mp3tag 1.0.0-alpha.3

Jun 8 2020

New

Added creating of directories at converter Tag to Filename.
Added support for removing of tags via ⌘ + forward delete key.
Added support for removing of files via forward delete key.

Changed

Add field button in converters now inserts field at current cursor position.
Changed to omit file extension from initial selection when renaming files in file list.
Changed to use option modifier key for adding files.
Cover Window lost focus after performing changes via contextual menu.
Contextual menu actions were performed on selected file and not on clicked file.
Preserve visible state of Tag Panel.

Fixed

Remove cover menu button was enabled after startup even if no file was selected.
Cover paste menu item was enabled also if no file was selected.
Rename button at converter Tag to Filename was initially enabled even if no formatstring was provided.
Convert button at converter Filename to Tag was initially disabled even if formatstring matched.
Converter Filename to Tag omitted trailing characters if filename contained Unicode chars.
Multi-line field content was rendered unreadable in file list.
Potential crash due to race condition on concurrent file loads.
Potential crash due to race condition on concurrent sort operations.
Potential crash due to race condition when updating files that were renamed externally.
Wrong German localization for Tag to Filename context menu entry.

Mp3tag 1.0.0-alpha.2

Jun 1 2020

New

Added ‘Save’ button to toolbar.
Added ‘Add files or folders’ button to toolbar.
Added context menu to file list.
Added support to load folders via dropping the folder on the Mp3tag Dock icon.
Added support to add files to the file list via drag and drop by using the Shift modifier key.
Added support to open multiple files via Finder → Open With.
Registered with the system to support opening of audio files.

Changed

Previously used format strings are now prefilled at converters.
Scrolling in file list now uses a predominant axis.
Adding Tag Panel fields via Preferences gave duplicate field error alert too often.
Added default genres to Tag Panel field.

Fixed

Random crashes when editing format strings.
Tag Panel showed contents of previously selected files after files were removed from file list.
Extended Tag window displayed wrong field content after adding fields in some cases.
Tag Panel field layout was broken by newline characters in metadata content.
Visual glitch with the file list upper border.
Closing the main window gave no option to restore the window.
Keyboard navigation on Tag Panel wasn’t possible anymore after modifying fields via Preferences.
German localization used instead of on Tag Panel.
ID3v2 WXXX and UFID frames were not read correctly.

Mp3tag 1.0.0-alpha.1

May 24 2020

New

Initial release, everything is new :)

Changelog

Mon, 01 Jan 0001 00:00:00 +0000

Mp3tag 1.13.1

Jun 21 2026

Fixed

Regression where directly editing metadata via the File List did not continue editing when navigating via Return or Tab keys.

Mp3tag 1.13.0

Jun 20 2026

New

Added support for RF64 WAV files > 4GB.
Added action type to remove Where From extended filesystem attributes.
Added support for file_xattr_where_froms information field, which contains extended filesystem attribute data describing where the file was obtained from.

Changed

Disabled the action groups toolbar menu segment if no action groups are available to choose from.

Fixed

Cover changes made in the Tag Panel were discarded if Extended Tags was used before saving.
Unsaved Tag Panel changes could be ignored when using Cover Search, Tag Sources, Converters, Auto-Numbering, or Actions before saving.
Regression where decimal BPM values were no longer truncated to integers when writing MP4 tags, which resulted in a user-defined TEMPO field being written.
MP4 atoms with empty content could not be modified or removed.
Using text-only toolbar items did not work as expected.

Mp3tag 1.12.2

May 14 2026

Fixed

Large integer metadata values were truncated to the preferred storage width when writing MP4 atoms like ITUNESCATALOGID.

Mp3tag 1.12.1

May 6 2026

New

Added support for specifying complete file paths for export and playlist filenames.

Fixed

Function SayFormat from Web Sources Framework did not support the documented optional second parameter.

Mp3tag 1.12.0

Apr 1 2026

New

Added support for Liquid Glass and other improvements on macOS 26 Tahoe.
Added Manage Covers… (⇧⌘C) to the Covers menu, allowing you to add, remove, replace, adjust, and reorder embedded cover art for one or multiple files.
Added Edit → Covers menu for cover-related functions.
Added ⇧⌘A keyboard shortcut for adding covers.
Added View → Quick Look with keyboard shortcut ⌘Y.
Added Quick Look to the context menu..

Fixed

Fixed an issue where Quick Look failed due to a sandboxing error if files were not explicitly opened via File → Open.
Fixed a regression where unknown MP4 atoms were removed during rewrites if the configuration option Settings → Advanced → Reuse unmodified MP4 atoms was not enabled.

Mp3tag 1.11.0

Feb 27 2026

New

Added support for cover-only search via Tag Sources.
Added an advanced configuration option to reuse unmodified ID3v2 frames.
Added an advanced configuration option to reuse unmodified MP4 atoms.
Added an advanced configuration option to use a single MP4 atom for multiple values.
Added support for MP4 H.266 and VP9 video codecs.
Added support for creating multiple field values using the multiple fields delimiter \\ at action Import Tag Fields.

Fixed

Folder separator / in field values created folders when renaming files based on tags in some cases.
Folders ending with a supported file extension were listed as pseudo-files in the File List.
Regression where validation for MP4 data atoms of type UTF-8 was too strict and did not allow trailing NULLs anymore.

Mp3tag 1.10.3

Jan 9 2026

New

Added Ukrainian localisation.

Changed

Added writing of all cover types to Apple MP4 metadata.
Added support for writing covers of type Artist, Media, and Icon for MP4 via Nero tags to improve compatibility with other apps.

Mp3tag 1.10.2

Dec 30 2025

Fixed

Writing MP4 tags to specific fragmented/streaming MP4 files is no longer refused.

Mp3tag 1.10.1

Dec 28 2025

Fixed

Fixed cover thumbnails with width greater than height could overlap in the next File List column.
Fixed writing MP4 tags to specific fragmented/streaming MP4 files corrupted the file and now simply refuses to tag the file.

Mp3tag 1.10.0

Dec 21 2025

New

Added a Customize… entry to the context menu when right-clicking the File List column header.
Added a configuration option to change drag-and-drop behaviour to add files to the File List by default.
Added keyboard shortcut ⌘↓ to show the history helper menu when the focus is on the input field.
Added keyboard shortcut ⌘+ to show the placeholder helper menu when the focus is on the input field.
Added keyboard shortcut ↓ to show the history and placeholder drop-down menus when the focus is on the menu buttons.
Added wildcard support * and ? at action Import Cover.
Added placeholder support when setting descriptions via action Set Cover Properties.
Added support for user-defined cover filename presets for saving artwork from the Tag Panel.
Added a Reset to defaults option in Preferences.
Added support for removing history entries for the Replace and Replace with Regular Expression actions.
Added support for exporting and importing action groups.
Added the $list() scripting function.
Added an option to include or exclude subfolders when loading files.
Added support for managing secure folder access in Settings → General.
Added the Insert, SayVar, Use, and UseFormat commands to the Web Sources Framework.
Added support for sorting tracks and files by clicking table columns in the Tag Sources results dialog.
Added Russian localisation.

Changed

Preserved selection when sorting list of Tag Sources search results.
Visualised placeholders for fields Value, Field, and Sort by in Settings → File List.
Added format-string helper menus for fields Value, Field, and Sort by in Settings → File List.
Updated json_select_array in the Web Sources Framework to support JSON arrays as an unnamed root element.
Improved control widths in Settings → Export.

Fixed

Fixed an issue where the Tag Sources tracks table occasionally reset its size.
Fixed an issue where informational properties (height, width, and color depth) were not written for FLAC pictures.
Fixed incorrect bitrate reporting for very short MP3 tracks (under one second).

Mp3tag 1.9.13

Nov 11 2025

Changed

Minor adjustments to function SayFormat from Web Sources Framework.

Fixed

MP4 mean atoms with uncommon namespaces were no longer displayed (since v1.9.7).

Mp3tag 1.9.12

Nov 8 2025

New

Added mp4_creation_time, mp4_creation_time_raw , mp4_modification_time, and mp4_modification_time_raw information fields to display MP4 mvhd creation and modification dates.
Added scripting function $dedup(x,y,c) to remove duplicated strings from x, separated by y, optionally using case-insensitive comparison if c is set to 1.
Added support for importing COMPOSER from extra artist role Music-By for Discogs Tag Sources.
Added function SayFormat to Web Sources Framework

Mp3tag 1.9.11

Oct 28 2025

New

Added support for Traditional Chinese localization.

Fixed

Performance improvements at Convert → Text - Tag with large amounts of text.
Enabled option to replace invalid NTFS characters also replaced slash character / in %_folderpath when constructing file names via Convert → Tag - Filename.
Scrolling to the end of a Tag Panel field with content exceeding the visible range wasn’t possible via Cmd+Right Arrow after saving tags.
Premature end of processing Tag Sources when condition for while loops wasn’t satisfied.

Mp3tag 1.9.10

Sep 24 2025

Fixed

MP4 gnre atom for GENRE used type identifier that was incompatible with Apple Music so that Unknown Genre was displayed instead of the actual genre (since v1.9.7).

Mp3tag 1.9.9

Sep 23 2025

New

App icon for macOS 26 Tahoe including dark, tinted, and clear variants.

Fixed

MP4 fields TOTALTRACKS and TOTALDISCS were not written, if accompanied TRACK and DISC were not changed (since v1.9.7).

Mp3tag 1.9.8

Sep 16 2025

Changed

Save toolbar button and menu item are now always enabled when files are selected.

Fixed

Added a workaround for an issue where toolbar symbols did not immediately update their enabled state on macOS 26 Tahoe when the File List selection was changed using the mouse.

Mp3tag 1.9.7

Sep 12 2025

New

Added Remove Tag toolbar icon (available via Customize Toolbar…).

Changed

Use the parent directory in File → Open… if the last opened directory is no longer available.
Added tag version display to Extended Tags when viewing individual files.
Modified Extended Tags column sizing so the Field column only uses the necessary width.
Adjusted control sizes for compatibility with macOS 26 Tahoe.
When a Nero tag needs to be written for MP4, a minimal version is now used without duplicating other global metadata.
Added a workaround for an issue on certain NAS systems (e.g., ReadyNAS) where file descriptors can become invalid (EBADF, error 9). The workaround can be enabled by setting NetworkFileLockingEnabled -bool no via defaults.

Fixed

Internal changes to ensure fields for format strings work with macOS 26 Tahoe.
Scripting function $num(x,y) did not preserve a negative sign for the first parameter.

Mp3tag 1.9.6

May 17 2025

Changed

After opening Quick Look with the space bar, you can now navigate to the previous or next file using the up and down arrow keys without needing to refocus the file list.

Fixed

Tag Sources functions SayNextNumber, SayDate, and SayDuration were too forgiving on some inputs.

Mp3tag 1.9.5

May 7 2025

Fixed

Previous inputs for Original and Replace were not stored in dropdown-history menus for action Replace.
Previous inputs for Regexp and Replace were not stored in dropdown-history menus for action Replace with Regular Expression.
Some dropdown-history menus used a font different from the regular system font.
Using a negative parameter at Tag-Sources function SayNChars did not work correctly.
If the search string used for Tag-Sources function FindInLine was not found, the internal index was at the last character of the line instead of past the last character of the line.

Mp3tag 1.9.4

Apr 29 2025

Fixed

Files located within folders that share the same name as the file were not handled correctly.

Mp3tag 1.9.3

Apr 15 2025

New

Added scripting function sort to sort parts of a given string delimited by a given delimiter string.
Added Matroska mappings for CATALOGNUMBER, ENCODERSETTINGS, TVEPISODE, TVNETWORK, TVSEASON, and TVSHOW.
Added using Discogs Release ID from clipboard when searching via Discogs Release ID Tag Source.
Added option to stop, skip, and retry with apply to all on errors when deleting files.

Changed

Added deletion of files if trashing is not supported by the underlying file system.
Changed to use T=50 Album als default target type for MKV Matroska video files.
Improved calculation of bitrate for CBR MP3 files with a Xing Info header.
Added removing of trailing empty data that is not part of the RIFF file structure when saving WAV files.
Updated Danish localization.

Fixed

Fixed error when writing WAV files that have trailing garbage data that is not part of the RIFF file structure.

Mp3tag 1.9.2

Mar 14 2025

Changed

Further improved focus and default-button handling in Tag Sources search window.
Improved performance when selecting many files, which might be especially noticeable on files from network shares.
Added detection of invalid ID3v2.2 frames in ID3v2.3 and ID3v2.4 tags and translation to target revision if possible.

Mp3tag 1.9.1

Feb 18 2025

Fixed

Check for minimum required version of Mp3tag for a Tag Source resulted in misleading error messages since the previous version.

Mp3tag 1.9.0

Feb 18 2025

New

Added support for Matroska with MKA, MKV, and WebM.
Added support for replacing displayed cover via Tag Panel.
Added option to revert edits in Tag Panel fields by pressing Esc.
Added scripting function $uuid() to create a 128-bit universally unique identifier (UUID).
Added support for Danish localization.

Changed

Use search button as initial default button at Tag Sources search window and next button as default after results have been queried.
Improved tab order at Tag Sources search window.
If an undo operation in a Tag Panel field restores the original value, the change won’t trigger automatic saving of metadata.
Multiple genre fields are written using the respective MP4 atom identifiers and not as custom fields to improve compatibility with other apps.
ID3v2.4 frames with incorrect encoding of unsynced integers are read.

Fixed

Undoing adding, pasting, or removing a cover did undo the previous action.
Unsaved changes in the Tag Panel are preserved when renaming files via Convert → Tag - Filename.
Unsaved changes from Tag Panel are used for Convert → Tag - Tag and Convert → Assign Track Numbers.
Unsaved changes from Tag Panel are used when displaying Extended Tags.

Mp3tag 1.8.27

Oct 22 2024

Fixed

Choosing Open With from the context menu opened only one file in the target app even if multiple files were selected.

Mp3tag 1.8.26

Oct 11 2024

Fixed

Reloading tags of individual files via File → Refresh Tag or ⌥⌘R resulted in app not responding.

Mp3tag 1.8.25

Sep 30 2024

Fixed

Workaround for infinite backtracking had unwanted side-effects for matching of patterns ending with characters that are reserved in regular expressions.

Mp3tag 1.8.24

Sep 30 2024

New

Added option to stop, skip, and rename with apply to all on errors when renaming files via actions.

Changed

Attempting to delete a file which was already deleted externally resulted in an unnecessary error message.

Fixed

Choosing Skip and checking Apply to All on errors when writing tags did not skip subsequent files that produced an error.
Format string field menu buttons could not be accessed via VoiceOver modifier key for Export and Filename to Tag.
Update 32-bit MP4 stco chunk-offset atoms to 64-bit co64 chunk-offset atoms if referenced sizes are exceeding the unsigned int 32-bit range.
Added a workaround for possible hangs caused by infinite backtracking of the regex engine when importing a large number of tags from text files and the format didn’t match the input.
Resolved high memory usage when determining cover sizes of huge covers when loading a large amount of files.

Mp3tag 1.8.23

Jul 16 2024

New

Added Show in Finder to main menu.
Added column with cover dimensions to list of query results for Discogs Tag Sources.
Added support for renaming LRC and CDG along with corresponding audio files.
Added support for ©enc MP4 atom which is mapped to ENCODEDBY.
Added support for sdes MP4 atom which is mapped to STOREDESCRIPTION.
Added support for detection of AV1 video tracks in MP4.
Added support for Opus in MP4.

Changed

Internal changes to parts that are responsible for reading and writing MP4 metadata.
Updated to FLAC 1.4.3.
Updated to Opus 1.5.1.

Fixed

Filtering based on format string did not always work when format string contained filter operators.
Format string field menu buttons could not be accessed via VoiceOver modifier key.
Selecting an item from the fields menu via keyboard or VoiceOver added it at the beginning of the format string field instead of the current cursor position.

Mp3tag 1.8.22

May 10 2024

Fixed

Renaming folders to nested subfolders via action Format Tag Field for _DIRECTORY on multiple files was applied on already renamed folder in some cases.
JSON-related functions json_foreach and json_foreach_end of Web Sources Framework reverted back to root object and not to previously selected object.

Mp3tag 1.8.21

Apr 11 2024

Changed

Added support to add multiple values for fields from Tag Sources.
Improved compatibility of Web Sources Framework function RegexpReplace with CR characters (carriage return) in input data.

Mp3tag 1.8.20

Mar 28 2024

Fixed

Occasional crash due to concurrent read/write access to internal storage.
Tag Sources with Windows line breaks CR LF produced extra empty line for each line break.

Mp3tag 1.8.19

Mar 25 2024

Fixed

Resolved high memory usage when applying a quick action of type Adjust Cover on a large amount of files.
Copying many files to the clipboard could result in a huge delay on quit.
Nero MP4 cdec atom for encoder settings was not preserved when writing tags.

Mp3tag 1.8.18

Mar 19 2024

Fixed

Addressed an occasional crash when dragging cover art from the Tag Panel.
Addressed an occasional crash when fields were deselected (via Cmd+Click) from some of lists for field selection.
Addressed a rare crash when calculating totals of lengths and size of selected files shown in the status bar.

Mp3tag 1.8.17

Mar 11 2024

Fixed

Further refinements regarding accessing files in the recommended way of encoding Unicode file names of the underlying file system.

Mp3tag 1.8.16

Mar 11 2024

Fixed

Added workaround for macOS caching issue on ExFAT file systems related to file names in Unicode NFC form.

Mp3tag 1.8.15

Feb 21 2024

Fixed

Removed normalization of linebreaks when reading ID3v2 frames USLT (UNSYNCEDLYRICS) and COMM (COMMENT) to prevent display problems in Music.app.
Prevented accidental drop and resulting duplicate of own dragged image when dragging cover art.

Mp3tag 1.8.14

Feb 20 2024

Fixed

Images added from Firefox via drag and drop could not be saved.
Using a negative value for maximum number of items to select at json_select_many resulted in a crash.

Mp3tag 1.8.13

Jan 23 2024

New

Added option to stop, skip, and rename with apply to all on errors when renaming files.
Added option to stop, skip, and retry with apply to all on errors when writing files.
Added option to stop, skip, and replace with apply to all on errors when copying and moving files.
Added support for Dutch localization.

Fixed

File permissions and ACLs were not preserved in some cases if writing tags involved temporary files.

Mp3tag 1.8.12

Jan 04 2024

Fixed

Using Web Sources Framework function findinline on strings with non-ASCII characters could in certain situations result in an application crash.

Mp3tag 1.8.11

Nov 29 2023

Fixed

Check for minimum required version of Mp3tag for a Tag Source did not compare all version segments numerically, which resulted in misleading error messages since the last version.

Mp3tag 1.8.10

Nov 28 2023

New

Added support for removing only duplicate fields that have the same content at action Remove duplicate fields.

Fixed

Changes that were made in individual files via navigation in Extended Tags were written to a different file in rare cases.

Mp3tag 1.8.9

Nov 6 2023

Changed

Added workaround for WordSeparator configuration setting misspelled as WordSeperator in Tag Sources.

Fixed

Leading and trailing quotes were accidentally removed from parameters of Web Sources Framework functions which resulted in unstable behaviour of certain Tag Sources.

Mp3tag 1.8.8

Oct 27 2023

New

Added function SayDate to Web Sources Framework.
Added support to reference contents of output buffers via %output% in string parameters of Web Sources Framework functions.

Changed

Added special handling for iTunEXTC field name for MP4.

Fixed

ID3v2 UFID was not always correctly detected as binary or text-only frame.
Cover dimensions on Tag Panel were reported as larger size in some rare cases.

Mp3tag 1.8.7

Sep 27 2023

Changed

Updated for macOS Sonoma.
Menu items File → Copy to… and File → Move to… were also enabled if no files were selected.
Extended JSON-related functions json_select_many and json_select_many_count of web sources framework with optional parameter to include result entries for non-existent items.

Mp3tag 1.8.6

Sep 11 2023

Fixed

Using web sources framework function findinline on empty input could result in an application crash.

Mp3tag 1.8.5

Sep 4 2023

Fixed

Fetching cover thumbnails via Tag Sources resulted in a blocked user interface, if the server terminated the connection prematurely.

Mp3tag 1.8.4

Aug 18 2023

New

Added support for localization of Tag Source configuration settings.

Mp3tag 1.8.3

Aug 17 2023

Fixed

Tag Source configuration settings were not saved, because required file settings.json wasn’t automatically created on first use.

Mp3tag 1.8.2

Aug 15 2023

New

Added support for editing Tag Sources configurations via the Tag Sources menu.
Added functions IfVar and IfNotVar to Web Sources Framework to check configuration settings from Tag Sources.
Added new key [Settings]=Tag Source Configuration.settings to provide a settings schema for Tag Sources.
Added new key [MinAppVersionMac] to require a minimum version of Mp3tag for a Tag Source to be used.
Added support for audio MD5 via %_md5audio% for WavPack.

Fixed

Composing URLs in Web Sources Framework did not use Encoding and WordSeparator values from Tag Source definition

Mp3tag 1.8.1

Jul 21 2023

New

Added scripting function fmtDuration to create a formatted duration string based on numerical input.
Added function SayDuration to Web Sources Framework.
Added JSON-related function json_select_many_count to Web Sources Framework.
Added JSON-related function json_foreach_counter to Web Sources Framework.
Added JSON-related function json_foreach_reverse to Web Sources Framework.

Changed

Extended json_select_many with optional parameters for last item separator and max items to select.

Mp3tag 1.8.0

Jun 29 2023

New

Added navigation to next and previous files from extended tags dialog.
Added support for copying files.
Added support for moving files.

Changed

Added auto-selection of newly added files when loading files.
Added a confirmation prompt in case the extended tags dialog is dismissed with pending changes.

Fixed

Resolved high memory usage when applying an action of type Adjust Cover on a large amount of files.

Mp3tag 1.7.8

May 4 2023

Fixed

Preview at Convert → Tag - Tag automatically resized window to fit preview text, which could exceed screen width.

Mp3tag 1.7.7

Mar 28 2023

Fixed

Fixed regression from previous version where selecting a search result at Custom Tag Sources had no effect.

Mp3tag 1.7.6

Mar 25 2023

New

Added support for file matching via %_filename_ext% and %_path% when importing tags from text file.

Changed

Parsing text to tags allowed to create fields starting with an underscore.

Fixed

Selecting a word via double-click when editing filenames in the File List instead selected the whole base filename without extension under macOS Monterey.
Progress dialog wasn’t dismissed automatically if search via Tag Sources returned no results.

Mp3tag 1.7.5

Feb 7 2023

Fixed

Error message when writing files on network shares with certain file systems and where the target file size exceeded the original file size.

Mp3tag 1.7.4

Feb 6 2023

Fixed

Last line of script was omitted when parsing Custom Tag Sources.
Command KillTag at Custom Tag Sources wasn’t supported yet.

Mp3tag 1.7.3

Jan 27 2023

Changed

BPM field for MP4 now only displays the bpm value without extra formatting.
Added support for Zero Width Joiner (ZWJ) and Zero Width Non-Joiner (ZWNJ) Unicode characters when renaming files from tags.

Fixed

Action import tag fields did not match multiline input.
Using the red close button to close certain action configuration windows locked the app.

Mp3tag 1.7.2

Jan 16 2023

Fixed

Last character was truncated when writing ID3v1 fields in some cases.

Mp3tag 1.7.1

Jan 7 2023

New

Added format string history for Preferences Playlist Filename.
Added format string history for Preferences Export Filename.
Added format string history for Preferences Copy Format
Added format string history to Export Cover action dialog.
Added format string history to Import Cover action dialog.
Added format string history to Import Text File action dialog.

Fixed

Last used Tag Source was triggered only via menu item but not via keyboard shortcut ⌘I
ID3v2 WXXX frames with user-defined descriptions could not be added.

Mp3tag 1.7.0

Dec 16 2022

New

Added support for multiline text fields on Tag Panel.
Added format string history to Export dialog.
Added preferences setting for Export filename.
Added preferences setting for Playlist filename.
Added preferences setting for Copy Format used when copying a textual representation via ⌘C to the clipboard.

Changed

Improved detection and importing of COMPOSER from Discogs.
Improved keyboard navigation for settings window.

Mp3tag 1.6.7

Nov 9 2022

Fixed

Fixed occasional crash at searching via Custom Tag Sources for direct album and multiple search parameters.

Mp3tag 1.6.6

Oct 26 2022

New

Added support for macOS 13 Ventura.
Added support for importing COMPOSER from Discogs.
Added $strrstr(x,y) scripting function, which finds the last occurrence of string y in string x.

Mp3tag 1.6.5

Oct 20 2022

Changed

Information field %_id3v2_unknown_frames% now reports the ID3v2 frame identifiers.

Fixed

Fixed occasional crash when selecting parts of the filename while editing in the File List.

Mp3tag 1.6.4

Oct 5 2022

Changed

Performance improvements when parsing data for Custom Tag Sources.

Fixed

Fixed Help → Mp3tag Help showed no help error message for some dialogs.
Fixed error messages at Custom Tag Sources used line numbers from input instead of Tag Source which made it hard to analyze potential issues.
Fixed findinline at Custom Tag Sources didn’t move position at end of line if text wasn’t found.

Mp3tag 1.6.3

Sep 20 2022

Changed

Updated to libFLAC 1.4.0.

Fixed

Fixed two potential crash issues at Custom Tag Sources.

Mp3tag 1.6.2

Sep 14 2022

New

Added information field %_id3v2_unknown_frames% to identify files with unsupported ID3v2 frames.

Fixed

Using URL as search term at Custom Tag Source to directly jump to result didn’t work due to wrong encoding of URL.

Mp3tag 1.6.1

Sep 1 2022

New

Added support for music player app Doppler so that changes made Mp3tag are reflected back in Doppler after saving.

Changed

Added auto-conversion of HTTP to HTTPS for Custom Tag Sources.

Mp3tag 1.6.0

Aug 25 2022

New

Support for Custom Tag Sources.

Mp3tag 1.5.2

Jul 15 2022

Fixed

Progress dialog didn’t close when querying Tag Sources and none of the results had cover art.

Mp3tag 1.5.1

Jul 14 2022

New

Added Discogs Tag Source for querying by free text.
Added Discogs Tag Source for querying by artist and track title.
Added support for WavPack.

Changed

Changed order of search fields for Tag Sources to be consistent.

Fixed

Non-deterministic behavior in filter operator precedence.
Filter operators EQUAL, GREATER, and LESS didn’t support negative operands.
error when renaming directory to child directory of source directory.
ID3v1 genre number in ID3v2 TCON frame was not translated for ID3v2.4.
Removing APEv2 tags from Musepack had no effect.

Mp3tag 1.5.0

May 27 2022

New

Added cover thumbnails to list of Tag Sources search results.
Added support for importing via direct text input at converter Text file - Tag.
Added action type Convert Codepage.
Added action type Import Text File.
Added action type Set Cover Properties.
Added support for MP4 .m4r files.

Changed

Added support for editing action groups also when no files are selected.
Changed to use placeholders for current cover at action Export Cover.

Fixed

Fixed an issue where clipped toolbar items were always disabled.
Added a workaround to collect all files when loading via Open with… even if system sends open notifications in multiple runs.

Mp3tag 1.4.4

Apr 26 2022

New

Added support for importing .mta action groups from Mp3tag for Windows.

Mp3tag 1.4.3

Apr 21 2022

New

Added support for importing ISRC — International Standard Recording Codes — via MusicBrainz tag source.
Added BARCODE and CATALOGNUMBER to default list of fields.

Changed

Changed Discogs and MusicBrainz tag sources to use CATALOGNUMBER instead of CATALOGID to improve compatibility with other software.
Added workaround for non-null padding bytes for INFO subchunks in WAV and AIF.

Fixed

Action case conversion had no effect on directory name.
Externally renamed folders with capitalization-only changes used previous capitalization on reload.

Mp3tag 1.4.2

Mar 15 2022

New

Added support for .paths files.
Added support for loading files via paste ⌘V

Changed

Added workaround for MP4 data atoms with superfluous trailing null byte.
Filter GREATER and LESS didn’t treat numerical strings as numbers.

Mp3tag 1.4.1

Feb 18 2022

New

Added support for multi-value MP4 fields written as multiple data atoms.
Added internal mapping for MUSICBRAINZ_TRACKID field.
Added information field %_cover_description% which provides the description of the first cover art in the tag of the file.
Added option to reorder fields and columns via keyboard ⌘↑ ⌘↓ at Preferences.
Added option to reorder files via keyboard ⌘↑ ⌘↓ at Tag Sources results window.

Changed

Added reporting of unsupported or corrupted file structure as error to ‘Tag’ column.
Added workaround for missing padding bytes for INFO subchunks in WAV and AIF.
Ensured that characters with accents or umlauts are using the Unicode Normalization Form C when querying Tag Sources.
Ensured characters with accents or umlauts are imported using the Unicode Normalization Form C from filenames.

Mp3tag 1.4.0

Jan 25 2022

New

Added option for adjusting cover to not crop but resize.
Added display of target file size when adjusting cover.
Added preferences setting for file list size.

Changed

Changed default cover size for MusicBrainz tag source to 1200 px.
Changed Tag Sources results table to have focus after searching.
Changed smaller font sizes used in some windows to standard system font size.

Fixed

File creation date wasn’t preserved if temporary files are involved when writing changes.
Replace with regular expression for _FILENAME allowed to remove file extension.
Changing enabled state of fields at Tag Sources result via Option + Click didn’t change all fields in some cases.
Added workaround for a write error when trying to perform changes to a file under /System/Volumes/Data/.

Mp3tag 1.3.2

Dec 10 2021

New

Added Tag Panel toolbar item.
Added support for undo when editing via extended tag dialog.
Added support for importing remix artists via Discogs tag source.

Changed

Confirming when editing via extended tag dialog is now also possible via ⌘⏎.
Added progress reporting when downloading cover art via Tag Sources.
Changed progress to be no longer based on macOS alert.

Fixed

Formatstring placeholders did not match empty sequences, e.g., when importing tags from text files.
Dynamically created menus (actions, sort by, tag sources) were only visible to the system after first use.
Action groups menu items were active even if no file was selected.
Removed empty parentheses from MEDIATYPE when importing from Discogs and format had no descriptions.
Field enabled state for Tag Sources was reset when cancelling on search result.

Mp3tag 1.3.1

Nov 22 2021

New

Added support for user-defined field mappings.
Added support for refreshing tags from files without reloading directories via ⌥⌘R.
Added support for setting cover type for varying covers.
Added support for setting cover description for varying covers.
Added support for adjusting image format and size for varying covers.

Fixed

Metadata field tool was lost when writing MP4.
Delete menu item was active even if no file was selected.

Mp3tag 1.3.0

Nov 2 2021

New

Added support for macOS Monterey.
Added support for Swedish localization.
Added detection and removal of ID3v1 in FLAC.
Added support for MP4 fields NARRATOR and PUBLISHER.
Added support for APEv2 cover types other than Front and Back.

Changed

WAV and AIFF files with extra null bytes at end of RIFF chunks are now read despite these inconsistencies.
Removed duplicate media types from MusicBrainz search results.

Fixed

Channel count was not correctly reported in all cases for MP4 with AC3.
Writing cover art of the same type resulted in identical APEv2 field names which are not allowed according to the specification.

Mp3tag 1.2.3

Jul 19 2021

Changed

FLAC VorbisComment block is now always written before Picture block to increase compatibility.

Fixed

Copy and paste metadata from files to other files via internal clipboard did not work reliably in rare cases.

Mp3tag 1.2.2

Jun 29 2021

New

Added action groups and action categories to toolbar menu item.
Added action groups and action categories to main menu.
Added keyboard shortcuts to jump between Tag Panel and File List.
Added option to rewrite tags also if no input has changed.
Added support for FLAC in MP4.

Changed

Preserve selection when filtering the file list.
Combined last used Tag Source and Tag Sources menu toolbar items.
Added special handling for ID3v2 comment descriptions were case needs to be preserved.
Changed keyboard shortcut for filtering the file list to ⌘F.

Fixed

Previous selection was not restored correctly if file list is reloaded and file list changes.
Added workaround for crash on invalid JPEGs.

Mp3tag 1.2.1

Jun 15 2021

New

Added preferences setting to preserve modification date.
Added support for Polish localization.

Changed

Preserve file order when loading M3U playlists.
Double click on cover to display Quick Look preview.
Automatically select file if only one file is loaded.
Keyboard shortcut to remove tags is now ⌥⌘⌫ because ⌘⌫ is usually used to delete text from start to cursor.
Possibility to cancel at batch processing errors.
Improved filtering performance.

Fixed

ID3v2 cover art with descriptions containing umlauts or other special characters were not read correctly.
Crash at $rg2sc() scripting function.

Mp3tag 1.2.0

May 19 2021

New

Added support for reading M3U playlists.
Added support for creating M3U playlists.
Added support for exporting to text and CSV files.
Added support for complex filter expressions.

Changed

Added recently used filters to filter field menu.
Improved message that requests permission to access files and folders.

Fixed

Renaming _DIRECTORY via action Format Tag Field prevented subsequent renames of _FILENAME in same action group.
Text in Filter field was not scrollable.

Mp3tag 1.1.4

May 1 2021

New

Added an alternative distribution method that doesn’t require the Mac App Store.
Added randomize sorting option when clicking on first column header in file list.

Changed

Apply is now the default action on the Action Groups window so actions can be applied by pressing Return key.

Fixed

Renaming _DIRECTORY via action Format Tag Field failed if target directory already existed.

Mp3tag 1.1.3

Apr 20 2021

Changed

Navigate to next/previous rows via Tab and Shift+Tab keys after last/first editable column in file list is reached.
Added detection of macOS App Translocation for trial version and ask to move the app to Application to prevent all sorts of random issues.

Fixed

Copying from temporary to original file failed on network drives in some cases if file was opened by an external process.
Collecting user-defined fields at input didn’t prevent duplicates in fields list in all cases.

Mp3tag 1.1.2

Apr 12 2021

New

Added support for Japanese and Brazilian Portuguese localization.
Added support for MP4 fields DIRECTOR, ITUNESALBUMID, ITUNESARTISTID, ITUNESCOMPOSERID, ITUNESCOUNTRYID, ITUNESGENREID, and XID.

Changed

Detect unmounted network volumes to prevent waiting for timeout if set as startup folder
Not using ID3v2 unsynchronization scheme anymore when writing ID3v2.4 due to compatibility reasons with apps that don’t implement the standard.
Acquiring advisory lock when writing files.

Mp3tag 1.1.1

Mar 30 2021

New

Added support for Spanish localization.

Changed

Changed imported tags from converter Text file - Tag to be merged with existing tags.

Fixed

CRLF newline characters resulted in empty lines at import from text file.
External changes on filenames were not reflected in the file list in some cases.

Mp3tag 1.1.0

Mar 26 2021

New

Added converter Text file to Tag to import tags from text files.
Added option to Merge tag-sources results to existing tags which also keeps existing covers.
Added synchronized selection for tracks and files table at Tag Sources results.
Added synchronized scrolling for tracks and files table at Tag Sources results.
Added support to enable or disable all fields in Tag Sources result via Option + Click.
Added context-menu item on file list header to auto-size current column.
Added context-menu item on file list header to auto-size all columns.

Changed

Changed Show in Finder context-menu item to also select all files in Finder and open more than one Finder window if necessary.
Changed focus to be at first empty search field or search button at Tag Sources search window.
Improved accessibility for helper buttons in formatstring fields.
Changed to use a minimum window size.

Fixed

Write error message due to sandboxing issue on some external thumb drives if temporary files were involved.

Mp3tag 1.0.4

Mar 11 2021

New

Added support for Czech, French, Italian, and Simplified Chinese localization.

Changed

Renaming files now replaces slash character / if none is used in formatstring.

Fixed

Crash at pasting copied tag data if different files were loaded in the meantime.
Quick Look on file list also displayed cover when switching to textual Tag Panel fields.
Write error message due to sandboxing issue on some external thumb drives if temporary files were involved.

Mp3tag 1.0.3

Mar 3 2021

Changed

Changed encoding of ID3v2 cover description back to ISO-8859-1.

Mp3tag 1.0.2

Mar 2 2021

New

Added Quick Look preview to cover art window.

Changed

Removed auto-replacing reserved characters to underscore on field-lookup when renaming files.
Changed default button title text at edit extended tag dialog.

Fixed

Accessing of files and folders via secure bookmarks failed in some cases.
Action adjust cover rounded 1 pixel off when calculating new image size in some cases.
ID3v2 cover description only supported characters of ISO-8859-1.

Mp3tag 1.0.1

Feb 26 2021

Changed

Alignment of fields of type Check in Tag Panel now more in line with Text fields.
Auto-completion of Genre field in Tag Panel now uses suggested capitalization.

Fixed

Add files and folders button in toolbar didn’t add the files and instead had the same functionality as Open files and folders.
File associations for MP4 and M4V were accidentally set to default.

Download

Mon, 01 Jan 0001 00:00:00 +0000

Mp3tag for Mac is available for direct purchase via FastSpring or from the Mac App Store .

I’m offering a free 7-day trial version of Mp3tag for Mac. Only days you’re using the app are counted.

Download Buy
For macOS 10.14.6 Mojave or later. Natively supports Apple Silicon.

Buy on the Mac App Store

For macOS 10.14.6 Mojave or later. Natively supports Apple Silicon.

End User License Agreement

Mon, 01 Jan 0001 00:00:00 +0000

This End User License Agreement applies to the versions of Mp3tag distributed directly through our website. For the license agreement for the version distributed via the Mac App Store, please refer to Apple’s Licensed Application End User License Agreement.

Please read this End-User License Agreement before downloading or using Mp3tag for Mac.

Interpretation and Definitions

Interpretation

The words of which the initial letter is capitalized have meanings defined under the following conditions. The following definitions shall have the same meaning regardless of whether they appear in singular or in plural.

Features

Mon, 01 Jan 0001 00:00:00 +0000

Mp3tag is the universal tag editor for Mac. Its main goal is to make simple tasks easy and complex tasks possible. It provides a common interface to the different supported file types, enabling common workflows for mixed-type music libraries.

macOS

Mp3tag for Mac requires macOS Tahoe, Sequoia, Sonoma, Ventura, Monterey, Big Sur, Catalina, or Mojave. It runs natively on Apple Silicon Macs.

Supported file types

Mp3tag for Mac supports MP3, MP4, M4A, M4B, M4V, MKA, MKV, FLAC, OGG, OPUS, AIF, DSF, MPC, WV, WAV, and WebM.

Imprint

Mon, 01 Jan 0001 00:00:00 +0000

Legal Notice according to § 5 TMG

Florian Heidenreich
Erlenstraße 18
01097 Dresden

Contact:

E-Mail: info@mp3tag.de
Phone: +49 (0) 351 32123216 (please don’t call for → support)

Mon, 01 Jan 0001 00:00:00 +0000

Goodbye!

You’re now unsubscribed from the Mp3tag for Mac Newsletter and will not receive any further updates from me via email.

If this was done by mistake, you can always subscribe again.

Thanks for your support so far!
– Florian

Mon, 01 Jan 0001 00:00:00 +0000

Your email is on the way…

I’m Florian Heidenreich, developer of Mp3tag. A confirmation email will be on its way to your inbox. Watch for it shortly.

You just have 1 thing left to do.

Open the email I just sent you and confirm your email address by doing the following…

Step 1: Open the email with the subject, “Mp3tag Newsletter: Please Confirm Subscription”

It looks like this…

Step 2: Click on the confirmation link in the email.

Mon, 01 Jan 0001 00:00:00 +0000

Thank you and Welcome!

I appreciate you signing up for my newsletter!

This is the place where I spent the most time in communicating all news Mp3tag for Mac to you. It’s also a great way for you to stay in contact with me. So if you have any feedback or open questions regarding Mp3tag, just hit reply on the welcome email I’m sending you in a minute.

Glad to have you on board!
– Florian

Mon, 01 Jan 0001 00:00:00 +0000

Would you like to receive occasional updates on Mp3tag for Mac via email?

I’m writing a low-frequency newsletter where I send you an update whenever I release a new version of Mp3tag, share tips & tricks, and behind-the-scenes information on being an indie developer.

Press Kit

Mon, 01 Jan 0001 00:00:00 +0000

Mp3tag for Mac was released to the Mac App Store on February 18, 2021.

After a long development period starting back in 2017, Mp3tag for Mac is finally available via the Mac App Store and as 7-day trial version from this website. It’s a completely new app, but builds on the experience of 20+ years of development and support of its Windows companion.

Mp3tag — The universal tag editor for Mac

Mp3tag is a powerful and easy-to-use tool to edit metadata of audio files. Musicians, DJs, podcasters, and audio-enthusiasts use it for many different aspects of handling audio files. It is created with the intention to make simple tasks easy and complex tasks possible.

Privacy Policy

Mon, 01 Jan 0001 00:00:00 +0000

1. General information and mandatory information

Data protection

The operators of this website take the protection of your personal data very seriously. We treat your personal data as confidential and in accordance with the statutory data protection regulations and this privacy policy.

If you use this website, various pieces of personal data will be collected. Personal information is any data with which you could be personally identified. This privacy policy explains what information we collect and what we use it for. It also explains how and for what purpose this happens.

Support and Help

Mon, 01 Jan 0001 00:00:00 +0000

Need help figuring out how to get something done?

Mp3tag Community

The Mp3tag Community is the place to get support, give feedback and report issues for Mp3tag. In many cases, the search feature reveals possible answers.

Mp3tag Help

The Mp3tag Documentation can also be a good resource to check if the topic is already covered. I’ve answered some Frequently Asked Questions, let me know if something should be added.

Send Feedback

If you feel it is more appropriate to talk to me directly, or your support request contains sensitive or private info, you can also just send an email via Help → Send Feedback from within Mp3tag.