Version 5.15

Changed

• MP4/M4A : Non-standard fields are now all saved even if you don't provide any namespace.
  • If <field name> is 4 characters or shorter, the field will be persisted as a standard atom;
  • If <field name> is longer than 4 characters
    • If you provide just a bare name (e.g. "MY_CUSTOM_FIELD"), it will be persisted as a ---- custom atom, using the com.apple.iTunes namespace
    • If you provide a namespace using the : separator (e.g. "my.namespace:MY_CUSTOM_FIELD" or "----:my.namespace:MY_CUSTOM_FIELD"), it will be persisted as a ---- custom atom, using the namespace you provided
• MP4/M4A : As a consequence of the above change, all non-standard fields persisted with the com.apple.iTunes namespace are now listed with their bare name (i.e. without their namespace) in AdditionalFields
  • Before v5.15 : AdditionalFields key is ----:com.apple.iTunes:MY_CUSTOM_FIELD
  • Starting from v5.15 : AdditionalFields key is MY_CUSTOM_FIELD
• MP4/M4A : The Conductor metadata is now written to the ©con atom instead of ----:com.apple.iTunes:CONDUCTOR. The latter is still properly read and mapped

Fixed

• APEtag : Properly read lyrics with more than 100 characters
• APEtag : The Publisher metadata is now properly mapped to IMetadata.Publisher and won't appear in AdditionalFields anymore
• Track.CopyMetadataTo doesn't ignore embedded images upon saving anymore

Thanks to @Agagamand for his precious help on these ones 👍

Binaries are available from nuGet

Version 5.14

Fixed

• ID3v2 : Strip BOMs from ID3v.2.2 values
• ID3v2 : Ignore malformed comments
• Fix crash when saving a formerly empty track used as target in a CopyMetadataTo call

Big thanks to @seankearney for testing the v5.x series 👋

Binaries are available from nuGet

Version 5.13

Interface-breaking change

MP4/M4A : Settings.MP4_readChaptersExclusive has been renamed to Settings.MP4_readChaptersFormat

New values are :

• 0 : Read from Quicktime format (chap atom), except if Nero chapters have more entries (default)
• 1 : Read from Quicktime format only
• 2 : Read from Nero format (chpl atom), except if Quicktime chapters have more entries
• 3 : Read from Nero format only

New

• New Track.CopyMetadataTo method to copy all metadata to another Track

Fixed

• AIFx : Custom chunk IDs written with lowercase letters are now properly read

Binaries are available from nuGet

Version 5.12

Changed

• Vorbis : Vendor ID ("VORBIS-VENDOR") Additional field is now removable
• Vorbis : Upon reading an empty file or removing all tags, vendor ID is now unset by default instead of having a hardcoded FLAC or OGG vendor value

Fixed

• WAV : Fix removing an item from Track.AdditionalField not having any effect on several chunks

Binaries are available from nuGet

Version 5.11

Fixed

• Vorbis (FLAC, OGG, OPUS) and WMA now support the PublishingDate field

Binaries are available from nuGet

Version 5.10

Fixed

• Playlists : Properly populate Tracks and FilePaths after saving
• Playlists : Only apply Settings.PlaylistWriteAbsolutePath to newly added tracks
• Playlists : Override Track metadata with metadata defined in the playlist file upon reading

Binaries are available from nuGet

Version 5.09

Breaking changes

• Playlists : Updating FilePaths and Tracks doesn't automatically save the playlist file anymore; you now have to call Save() to do so

New

• Settings.PlaylistWriteAbsolutePath can be used to determine whether new playlist elements are saved using a relative (default) or absolute path. Unmodified playlist elements' paths are kept as is regardless of the setting you've chosen

Binaries are available from nuGet

Version 5.08

New

• New Format.Writable property
• FPL playlist Format is marked as non-writable

Fixed

• ID3v2 : Handle fields whose size is 0 ("flag" fields with no actual value)

Binaries are available from nuGet

Version 5.07

New

• Alternate signature for Track.Save with a TagType parameter to save using a specific tag type in addition to existing ones
  Use case : add an ID3v2 tagging to a file with an existing APE tagging

Fixed

• APE tags : Lyrics are now properly detected
• LyricsPhrase : Return true for equals if a and b are null

Binaries are available from nuGet

Version 5.06

Changed

• Vorbis, MP4/M4A : Synch lyrics override unsynch lyrics when the target format cannot support both of them
• MP4/M4A : Insert an empty 1x1 black JPG image when chapters have no images in order to avoid breaking sequence order

Fixed

• Vorbis : Catch metadata whose field ID is written in lowercase letters

Binaries are available from nuGet