Version 6.08

Fixed

• FLAC : Prevent corruption on certain files when removing all metadata from tagged files or adding metadata to files without any metadata
• MP4/M4A : Fix mvhd atom's "next track ID" field not being valued correctly when adding or removing chapters

Binaries are available from nuGet

Version 6.07

Interface-breaking changes

• AudioDataIOFactory.CID_MP3 has been renamed AudioDataIOFactory.CID_MPEG
• The values of the following constants have changed - please update your code if you hardcoded them instead of referring to the field value.
  • All AudioDataIOFactory.CID_ constants
  • CatalogDataReaderFactory.CR_CUE
  • All PlaylistIOFactory.PL_ constants
• Track.AudioFormat.ID can not be used to read format IDs directly anymore. Use Track.AudioFormat.ContainerId or Track.AudioFormat.DataFormat.ID depending on what you need

New

• Track now publishes the SupportedMetadataFormats field, which indicates which tagging systems are supported by the file. Their IDs match MetaDataIOFactory.TagType enum values

Changed

• Track.AudioFormat is now of AudioFormat type (instead of plain Format), which allows you to read container format ID and audio data format ID

Fixed

• ID3v2 : Composer and Copyright fields with numeric values aren't displayed as genres anymore

Binaries are available from nuGet

Version 6.06

Fixed : MP3 : Improve duration detection for certain files where the first MPEG header is misplaced

Binaries are available from nuGet

Version 6.05

New

• ID3v2.2-3 : Settings.ID3v2_separatev2v3Values : keep raw data in fields that have multiple values (e.g. TP1, TCM, TCOM...) (false by default)
• MP3 : Setting.MP3_parseExactDuration : read exact duration by reading through all frames (slower; false by default)

Changed

• MKA/WEBM : Read metadata when Tag.Targets is not set

Fixed

• ID3v2 : Handle badly formatted WXXX fields without any null character at the end of the Description string
• M4A/MP4 : Read audio properties when embedded format is Opus
• M4A/MP4 : Better support for fragmented MP4s
• MKA/WEBM : Fix corruption upon saving certain files due to the Segment header being written at the wrong offset

Thanks a bunch to @Smiuv for his invaluable help in finding niche bugs!

Binaries are available from nuGet

Version 6.04

New

• MP4 : Detect duration on files where duration info is under the moof atom
• MKA : Detect duration and bitrate on files where the Info/Duration element is not set and raw audio data has no duration info

Binaries are available from nuGet

Version 6.03

Fixed

• MKA, WEBM : Files embedding Opus data can now be read without crashing
• MKA, WEBM : EBML headers with undefined size are now properly read
• MKA, WEBM : Duration and sample rates are now read properly on files where previous version read negative values

Technical

• OGG, Vorbis : Better support for async operations

Binaries are available from nuGet

Version 6.02

New

• MKA : Support for writing
• MKA : Support for chapters
• MKA : Reads tags from all TargetTypeValues (not only track and album)
• Chapters : New ChapterInfo.UniqueNumericID field to store numeric chapter IDs

Changed

• Vorbis : Now uses ChapterInfo.UniqueNumericID to store indexes instead of ChapterInfo.UniqueID

Fixed

• WMA : Properly handle files where WM/TrackNumber and WM/PartOfSet are saved as integers (both are now forced to type string as per specs)

Binaries are available from nuGet

Version 6.01

MAJOR VERSION - PLEASE NOTE THE FOLLOWING COMPATIBLITY CHANGES

• .NET Core support has been dropped

New

• Read-only support for Matroska Audio (.MKA)

Binaries are available from nuGet

Version 5.26

New

• Track.SaveTo method to save to a new file or a new Stream

Fixed

• FLAC : Saving multiple embedded pictures doesn't corrupt the audio stream anymore

Binaries are available from nuGet

Version 5.25

Fixed

• ID3v2 : Use a buffer to read picture data (continued)
• Lyrics : Use UnsynchronizedLyrics when LRC fails to be parsed
• Improve BufferedBinaryReader's behaviour in case of slow data retrieval

Thanks to @j4587698 for his help~

Binaries are available from nuGet