TagLib 2.2 Release - Feb 18, 2026

• Support for Matroska (MKA, MKV) and WebM files.
• Support for NI STEM in MP4 files.
• New method isDsd() in WavPack properties.
• Stricter verification of ID3v2 frames.
• Fix setting the last header flag in Ogg FLAC files.
• Fix reading of the last page in Ogg streams.
• Avoid corrupting invalid Ogg FLAC files without Vorbis comment.
• Windows: Support MP4 files with 64-bit atoms.
• Fix use of property keys with non-ASCII characters in C bindings.
• Fix building with Android NDK 29.

TagLib 2.1.1 Release - June 30, 2025

• Map ID3v2.3 IPLS frames to both ID3v2.4 TIPL and TMCL to have a consistent
  behavior when using MusicBrainz tags with the property map interface.
• Fix missing include for wchar_t when using C bindings with MinGW.

TagLib 2.1 Release - May 31, 2025

• Support for Shorten (SHN) files.
• Compile time configuration of supported formats: WITH_APE, WITH_ASF, ...
• Compile time configuration of data and temporary directories for unit tests:
  TESTS_DIR and TESTS_TMPDIR.
• C bindings: Added taglib_file_new_wchar() and taglib_file_new_type_wchar().
• Preserve unicode encoding when downgrading to ID3v2.3.
• Do not store FLAC metadata blocks which are too large.
• Fix segfaults with String and ByteVector nullptr arguments.

TagLib 2.0.2 Release - Aug 24, 2024

• Fix parsing of ID3v2.2 frames.
• Tolerate MP4 files with unknown atom types as generated by Android tools.
• Support setting properties with arbitrary names in MP4 tags.
• Windows: Fix "-p" option in tagwriter example.
• Support building with older utfcpp versions.

TagLib 2.0.1 (Apr 9, 2024)

• Fix aborting when _GLIBCXX_ASSERTIONS are enabled.
• Fall back to utf8cpp header detection in the case that its CMake
  configuration is removed.
• Improve compatibility with the SWIG interface compiler.
• Build system fixes for testing without bindings, Emscripten and Illumos.
• C bindings: Fix setting UTF-8 encoded property values.
• Windows: Fix opening long paths.

TagLib 2.0 Release - Jan 24, 2024

• New major version, binary incompatible, but mostly source-compatible
  with the latest 1.x release if no deprecated features are used.
  Simple applications should build without changes, more complex
  applications (e.g. extending classes of TagLib) will have to be adapted.
• Requires a C++17 compiler and uses features of C++17.
• Major code cleanup, fixed warnings issued by compilers and static analyzers.
• Made methods virtual which should have been virtual but could not be
  changed to keep binary compatibility, remove related workarounds.
• Removed deprecated functions:
  • APE::Item::Item(const String &, const String &)
  • APE::Item::toStringList(): Use values()
  • APE::Item::value(): Use binaryData()
  • ASF::Properties::setLength()
  • ByteVector::checksum()
  • ByteVector::isNull(): Use isEmpty()
  • ByteVector::null
  • FLAC::File::setID3v2FrameFactory()
  • FLAC::File::streamInfoData()
  • FLAC::File::streamLength()
  • FLAC::Properties::Properties(File *, ReadStyle)
  • FLAC::Properties::sampleWidth(): Use bitsPerSample()
  • File::isReadable(): Use system functions
  • File::isWritable(): Use system functions
  • FileName::str()
  • FileRef::create(): Use constructor
  • MP4::Tag::itemListMap(): Use itemMap()
  • MPC::File::remove(): Use strip()
  • MPC::Properties::Properties(const ByteVector &, long, ReadStyle)
  • MPEG::File::save(int, ...): Use overload
  • MPEG::File::setID3v2FrameFactory(): Use constructor
  • MPEG::ID3v2::Frame::Header::Header(const ByteVector &, bool)
  • MPEG::ID3v2::Frame::Header::frameAlterPreservation(): Use
    fileAlterPreservation()
  • MPEG::ID3v2::Frame::Header::setData(const ByteVector &, bool)
  • MPEG::ID3v2::Frame::Header::size(unsigned int): Use size()
  • MPEG::ID3v2::Frame::Header::unsycronisation(): use unsynchronisation()
  • MPEG::ID3v2::Frame::checkEncoding(const StringList &, String::Type): Use
    checkTextEncoding(const StringList &, String::Type)
  • MPEG::ID3v2::Frame::headerSize(): Use Header::size()
  • MPEG::ID3v2::Frame::headerSize(unsigned int): Use
    Header::size(unsigned int)
  • MPEG::ID3v2::FrameFactory::createFrame(const ByteVector &, bool)
  • MPEG::ID3v2::FrameFactory::createFrame(const ByteVector &, unsigned int):
    Use createFrame(const ByteVector &, const Header *)
  • MPEG::ID3v2::RelativeVolumeFrame::channelType()
  • MPEG::ID3v2::RelativeVolumeFrame::peakVolume(): Use peakVolume(ChannelType)
  • MPEG::ID3v2::RelativeVolumeFrame::setChannelType()
  • MPEG::ID3v2::RelativeVolumeFrame::setPeakVolume(const PeakVolume &): Use
    setPeakVolume(const PeakVolume &, ChannelType)
  • MPEG::ID3v2::RelativeVolumeFrame::setVolumeAdjustment(float): Use
    setVolumeAdjustment(float, ChannelType)
  • MPEG::ID3v2::RelativeVolumeFrame::setVolumeAdjustmentIndex(short): Use
    setVolumeAdjustmentIndex(short, ChannelType)
  • MPEG::ID3v2::RelativeVolumeFrame::volumeAdjustment(): Use
    volumeAdjustment(ChannelType)
  • MPEG::ID3v2::RelativeVolumeFrame::volumeAdjustmentIndex(): Use
    volumeAdjustmentIndex(ChannelType)
  • MPEG::ID3v2::Tag::footer()
  • MPEG::ID3v2::Tag::render(int): Use render(Version)
  • MPEG::XingHeader::xingHeaderOffset()
  • Ogg::Page::getCopyWithNewPageSequenceNumber()
  • Ogg::XiphComment::removeField(): Use removeFields()
  • PropertyMap::unsupportedData(): Returns now const reference, use
    addUnsupportedData() to add keys
  • RIFF::AIFF::Properties::Properties(const ByteVector &, ReadStyle)
  • RIFF::AIFF::Properties::Properties(const ByteVector &, int, ReadStyle)
  • RIFF::AIFF::Properties::sampleWidth(): Use bitsPerSample()
  • RIFF::WAV::File::save(TagTypes, bool, int): Use
    save(TagTypes, StripTags, Version)
  • RIFF::WAV::File::tag(): Returns now a TagUnion, use ID3v2Tag() to get an
    ID3v2::Tag
  • String::isNull(): Use isEmpty()
  • String::null
  • TrueAudio::File::setID3v2FrameFactory(): Use constructor
  • WavPack::Properties::Properties(const ByteVector &, long, ReadStyle)
• Made methods const: Frame::Header::size(), Frame::headerSize(),
  MP4::Atom::findall(), MP4::Atoms::find(), MP4::Atoms::path().
• Made classes non-virtual: APE::Footer, APE::Item, ASF::Attribute,
  ASF::Picture, MP4::CoverArt, MP4::Item, ID3v2::ExtendedHeader, ID3v2::Footer,
  ID3v2::Header, MPEG::Header, MPEG::XingHeader, Ogg::Page, Ogg::PageHeader.
• Removed type definitions in TagLib namespace: wchar, uchar, ushort, uint,
  ulong, ulonglong, wstring: Use the standard types.
• Removed include file taglib_config.h and its defines TAGLIB_WITH_ASF,
  TAGLIB_WITH_MP4: They were always 1 since version 1.8.
• Behavioral changes:
  • The basic tag methods (e.g. genre()) separate multiple values with " / "
    instead of " ".
  • The stream operator for String uses UTF-8 instead of ISO-8859-1 encoding.
  • MP4 property ORIGINALDATE is mapped to "----:com.apple.iTunes:ORIGINALDATE"
    instead of "----:com.apple.iTunes:originaldate".
  • MP4 property ENCODEDBY is mapped to "©enc" instead of "©too", which is now
    mapped to ENCODING.
• Unified interface for complex properties like pictures.
• Simplified the unified properties interface by providing its methods on
  FileRef.
• C bindings: Support for properties (taglib_property_...) and complex
  properties like cover art (taglib_complex_property_...), memory I/O streams.
• Support for Direct Stream Digital (DSD) stream files (DSF) and interchange
  file format (DSDIFF, DFF), ADTS (AAC) files.
• The runtime version can be queried.
• Additional utility functions ByteVector::fromUShort(),
  ByteVector::fromULongLong(), ByteVector::toULongLong(),
  ByteVector::toULongLong(), List::sort().
• Fixed List::setAutoDelete() affecting implicitly shared copies.
• Build system: Direct support for CMake, find_package(TagLib) exports target
  TagLib::tag.
• Build system: Fixed PackageConfig to support both relative and absolute paths.
• Build system: utf8cpp is no longer included, it can be provided via a system
  package or a Git submodule.
• ASF: Support additional properties ARTISTWEBPAGE, ENCODING, ENCODINGTIME,
  FILEWEBPAGE, INITIALKEY, ORIGINALALBUM, ORIGINALARTIST, ORIGINALFILENAME,
  ORIGINALLYRICIST.
• ID3v2: Fixed extensibility of FrameFactory, use it also for WAV and AIFF
  files.
• MP4: Support additional properties OWNER, RELEASEDATE.
• MP4: Introduced ItemFactory allowing clients to support new atom types.
• MP4: Detect duration from mvhd atom if not present in mdhd atom.
• MP4: Fixed type of hdvd atom to be integer instead of boolean.
• MP4: Tolerate trailing garbage in M4A files.
• MPC: Fixed content check in presence of an ID3v2 tag.
• MPEG: Do not scan full file for ID3v2 tag when ReadStyle Fast is used.
• RIFF: Support properties ALBUM, ARRANGER, ARTIST, ARTISTWEBPAGE, BPM,
  COMMENT, COMPOSER, COPYRIGHT, DATE, DISCSUBTITLE, ENCODEDBY, ENCODING,
  ENCODINGTIME, GENRE, ISRC, LABEL, LANGUAGE, LYRICIST, MEDIA, PERFORMER,
  RELEASECOUNTRY, REMIXER, TITLE, TRACKNUMBER.
• WAV: Fixed crash with files having the "id3 " chunk as the only valid chunk.
• Windows: Fixed support for files larger than 2GB.

TagLib 1.13.1 Release - Jul 1, 2023

• Fixed parsing of TXXX frames without description.
• Detect MP4 atoms with invalid length or type.
• Do not miss ID3v2 frames when an extended header is present.
• Use property "DISCSUBTITLE" for ID3v2 "TSST" frame.
• Build system improvements: Use absolute path for macOS dylib install name,
  support --define-prefix when using pkg-config, fixed minimum required
  CppUnit version.
• Code clean up using clang-tidy.

• Added interface StreamTypeResolver to support streams which cannot be
  fopen()'ed, e.g. network files.
• Added MP4::File::strip() to remove meta atom from MP4 file.
• Added Map::value() to look up without creating entry.
• Use property "WORK" instead of "CONTENTGROUP" for ID3v2 "TIT1" frame,
  use property "WORK" for ASF "WM/ContentGroupDescription",
  use property "COMPILATION" for ID3v2 "TCMP" frame.
• Build system improvements: option WITH_ZLIB, BUILD_TESTING instead of
  BUILD_TESTS, GNUInstallDirs, FeatureSummary, tests with BUILD_SHARED_LIBS,
  cross compilation with Buildroot, systems without HAVE_GCC_ATOMIC, Clang.
• Fixed heap-buffer-overflows when handling ASF, APE, FLAC, ID3v2, MP4, MPC
  tags.
• Fixed detection of invalid file by extension when correct type can be
  detected by contents.
• Fixed unnecessary creation of map entries in APE and FLAC tags if looked up
  tag does not exist.
• Fixed parsing of MP4 non-full meta atoms.
• Fixed potential ID3v1 false positive in the presence of an APE tag.
• Fixed ID3v2 version handling for frames embedded in CHAP or CTOC frames.
• Fixed parsing of multiple strings with a single BOM in ID3v2.4.0.
• Fixed several smaller issues reported by clang-tidy.

• Added support for WinRT.
• Added support for Linux on POWER.
• Added support for classical music tags of iTunes 12.5.
• Added support for file descriptor to FileStream.
• Added support for 'cmID', 'purl', 'egid' MP4 atoms.
• Added support for 'GRP1' ID3v2 frame.
• Added support for extensible WAV subformat.
• Enabled FileRef to detect file types based on the stream content.
• Dropped support for Windows 9x and NT 4.0 or older.
• Check for mandatory header objects in ASF files.
• More tolerant handling of RIFF padding, WAV files, broken MPEG streams.
• Improved calculation of Ogg, Opus, Speex, WAV, MP4 bitrates.
• Improved Windows compatibility by storing FLAC picture after comments.
• Fixed numerical genres in ID3v2.3.0 'TCON' frames.
• Fixed consistency of API removing MP4 items when empty values are set.
• Fixed consistency of API preferring COMM frames with no description.
• Fixed OOB read on invalid Ogg FLAC files (CVE-2018-11439).
• Fixed handling of empty MPEG files.
• Fixed parsing MP4 mdhd timescale.
• Fixed reading MP4 atoms with zero length.
• Fixed reading FLAC files with zero-sized seektables.
• Fixed handling of lowercase field names in Vorbis Comments.
• Fixed handling of 'rate' atoms in MP4 files.
• Fixed handling of invalid UTF-8 sequences.
• Fixed possible file corruptions when saving Ogg files.
• Fixed handling of non-audio blocks, sampling rates, DSD audio in WavPack files.
• TableOfContentsFrame::toString() improved.
• UserTextIdentificationFrame::toString() improved.
• Marked FileRef::create() deprecated.
• Marked MPEG::File::save() with boolean parameters deprecated,
  provide overloads with enum parameters.
• Several smaller bug fixes and performance improvements.

• Fixed binary incompatible change in TagLib::String.
• Fixed reading ID3v2 CTOC frames with a lot of entries.
• Fixed seeking ByteVectorStream from the end.