TagLib 2.0.1

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

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

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.

TagLib 1.13

• 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.

TagLib 1.12

• 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.

TagLib 1.11.1

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

TagLib 1.11

1.11:

• Fixed reading APE items with long keys.
• Fixed reading ID3v2 SYLT frames when description is empty.

1.11 BETA 2:

• Better handling of PCM WAV files with a 'fact' chunk.
• Better handling of corrupted APE tags.
• Efficient decoding of unsynchronized ID3v2 frames.
• Fixed text encoding when saving certain frames in ID3v2.3 tags.
• Fixed updating the size of RIFF files when removing chunks.
• Several smaller bug fixes and performance improvements.

1.11 BETA:

• New API for creating FileRef from IOStream.
• Added support for ID3v2 PCST and WFED frames.
• Added support for pictures in XiphComment.
• Added String::clear().
• Added FLAC::File::strip() for removing non-standard tags.
• Added alternative functions to XiphComment::removeField().
• Added BUILD_BINDINGS build option.
• Added ENABLE_CCACHE build option.
• Replaced ENABLE_STATIC build option with BUILD_SHARED_LIBS.
• Better handling of duplicate ID3v2 tags in all kinds of files.
• Better handling of duplicate tag chunks in WAV files.
• Better handling of duplicate tag chunks in AIFF files.
• Better handling of duplicate Vorbis comment blocks in FLAC files.
• Better handling of broken MPEG audio frames.
• Fixed crash when calling File::properties() after strip().
• Fixed crash when parsing certain MPEG files.
• Fixed crash when saving Ogg files.
• Fixed possible file corruptions when saving ASF files.
• Fixed possible file corruptions when saving FLAC files.
• Fixed possible file corruptions when saving MP4 files.
• Fixed possible file corruptions when saving MPEG files.
• Fixed possible file corruptions when saving APE files.
• Fixed possible file corruptions when saving Musepack files.
• Fixed possible file corruptions when saving WavPack files.
• Fixed updating the comment field of Vorbis comments.
• Fixed reading date and time in ID3v2.3 tags.
• Marked ByteVector::null and ByteVector::isNull() deprecated.
• Marked String::null and String::isNull() deprecated.
• Marked XiphComment::removeField() deprecated.
• Marked Ogg::Page::getCopyWithNewPageSequenceNumber() deprecated. It returns null.
• Marked custom integer types deprecated.
• Many smaller bug fixes and performance improvements.

TagLib 1.10

• New API for the audio length in milliseconds.
• Added support for ID3v2 ETCO and SYLT frames.
• Added support for album artist in PropertyMap API of MP4 files.
• Added support for embedded frames in ID3v2 CHAP and CTOC frames.
• Added support for AIFF-C files.
• Better handling of duplicate ID3v2 tags in MPEG files.
• Allowed generating taglib.pc on Windows.
• Added ZLIB_SOURCE build option.
• Fixed backwards-incompatible change in TagLib::String when constructing UTF16 strings.
• Fixed crash when parsing certain FLAC files.
• Fixed crash when encoding empty strings.
• Fixed saving of certain XM files on OS X.
• Changed Xiph and APE generic getters to return space-concatenated values.
• Fixed possible file corruptions when removing tags from WAV files.
• Added support for MP4 files with 64-bit atoms in certain 64-bit environments.
• Prevented ID3v2 padding from being too large.
• Fixed crash when parsing corrupted APE files.
• Fixed crash when parsing corrupted WAV files.
• Fixed crash when parsing corrupted Ogg FLAC files.
• Fixed crash when parsing corrupted MPEG files.
• Fixed saving empty tags in WAV files.
• Fixed crash when parsing corrupted Musepack files.
• Fixed possible memory leaks when parsing AIFF and WAV files.
• Fixed crash when parsing corrupted MP4 files.
• Stopped writing empty ID3v2 frames.
• Fixed possible file corruptions when saving WMA files.
• Added TagLib::MP4::Tag::isEmpty().
• Added accessors to manipulate MP4 tags.
• Fixed crash when parsing corrupted WavPack files.
• Fixed seeking MPEG frames.
• Fixed reading FLAC files with zero-sized padding blocks.
• Added support for reading the encoder information of WMA files.
• Added support for reading the codec of WAV files.
• Added support for multi channel WavPack files.
• Added support for reading the nominal bitrate of Ogg Speex files.
• Added support for VBR headers in MPEG files.
• Added new options to the tagwriter example.
• Marked FLAC::File::streamInfoData() deprecated. It returns an empty ByteVector.
• Marked FLAC::File::streamLength() deprecated. It returns zero.
• Fixed possible file corruptions when adding an ID3v1 tag to FLAC files.
• Fixed self-assignment operator in some types.
• Fixed extraction of MP4 tag keys with an empty list.
• Many smaller bug fixes and performance improvements.

TagLib 1.9.1

• Fixed binary incompatible change in TagLib::Map and TagLib::List.
• Fixed constructing TagLib::String from TagLib::ByteVector.
• Fixed compilation on MSVC with the /Zc:wchar_t- option.
• Fixed detecting of RIFF files with invalid chunk sizes.
• Added TagLib::MP4::PropertyMap::codec().

TagLib 1.9

Changes in this release:

• Added support for the Ogg Opus file format.
• Added support for INFO tags in WAV files.
• Changed FileStream to use Windows file API.
• Included taglib-config.cmd script for Windows.
• New ID3v1::Tag methods for working directly with genre numbers.
• New MPEG::File methods for checking which tags are saved in the file.
• Added support for the PropertyMap API to ASF and MP4 files.
• Added MusicBrainz identifiers to the PropertyMap API.
• Allowed reading of MP4 cover art without an explicitly specified format.
• Better parsing of corrupted FLAC files.
• Fixed saving of PropertyMap comments without description into ID3v2 tags.
• Fixed crash when parsing certain XM files.
• Fixed compilation of unit test with clang.
• Better handling of files that can't be open or have read-only permissions.
• Improved atomic reference counting.
• New hookable API for debug messages.
• More complete Windows install instructions.
• Many smaller bug fixes and performance improvements.