Version 2.2

Author: ufleisch

CHANGELOG.md

@@ -3,6 +3,7 @@ TagLib 2.2 (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.

CMakeLists.txt

@@ -12,7 +12,7 @@ include(CMakePackageConfigHelpers)
 
 option(BUILD_SHARED_LIBS "Build shared libraries" OFF)
 if(APPLE)
-  option(BUILD_FRAMEWORK "Build an OS X framework" OFF)
+  option(BUILD_FRAMEWORK "Build a macOS framework" OFF)
   if(BUILD_FRAMEWORK)
     set(BUILD_SHARED_LIBS ON)
     #set(CMAKE_MACOSX_RPATH 1)

INSTALL.md

@@ -63,13 +63,13 @@ and ID3 tags cannot be disabled. The following CMake options are available:
 | `WITH_APE`              | Build with APE, MPC, WavPack (default ON)          |
 | `WITH_ASF`              | Build with ASF (default ON)                        |
 | `WITH_DSF`              | Build with DSF (default ON)                        |
-| `WITH_MATROSKA`         | Build with Matroska (default ON)                   |
+| `WITH_MATROSKA`         | Build with Matroska, WebM (default ON)             |
 | `WITH_MOD`              | Build with Tracker modules (default ON)            |
 | `WITH_MP4`              | Build with MP4 (default ON)                        |
 | `WITH_RIFF`             | Build with AIFF, RIFF, WAV (default ON)            |
 | `WITH_SHORTEN`          | Build with Shorten (default ON)                    |
 | `WITH_TRUEAUDIO`        | Build with TrueAudio (default ON)                  |
-| `WITH_VORBIS`           | Build with Vorbis, FLAC, Ogg, Opus (default ON)    |
+| `WITH_VORBIS`           | Build with FLAC, Ogg, Opus, Speex (default ON)     |
 
 Note that disabling formats will remove exported symbols from the library and
 thus break binary compatibility. These options should therefore only be used

README.md

@@ -7,18 +7,32 @@
 https://taglib.org/
 
 TagLib is a library for reading and editing the metadata of several
-popular audio formats. Currently, it supports both ID3v1 and ID3v2
-for MP3 files, [Ogg Vorbis][] comments and ID3 tags
-in [FLAC][], MPC, Speex, WavPack, TrueAudio, WAV, AIFF, MP4, APE, ASF,
-DSF, DFF and AAC files.
+popular audio formats. Currently, it supports various metadata containers such
+as [ID3v1][], [ID3v2][] and [Vorbis][] comments for MP3, MP4, AAC,
+[Ogg][], [Opus][], [FLAC][], [Speex][], [APE][], [MPC][], [WavPack][],
+[WAV][], [AIFF][], [TrueAudio][], [Matroska][], [WebM][], ASF, WMA, DSF, DFF and
+tracker (MOD, XM, S3M, IT) files.
 
 TagLib is distributed under the [GNU Lesser General Public License][]
 (LGPL) and [Mozilla Public License][] (MPL). Essentially that means that
 it may be used in proprietary applications, but if changes are made to
 TagLib they must be contributed back to the project. Please review the
 licenses if you are considering using TagLib in your project.
 
-  [Ogg Vorbis]: https://xiph.org/vorbis/
+  [ID3v1]: https://id3.org/ID3v1
+  [ID3v2]: https://id3.org/Home
+  [Vorbis]: https://xiph.org/vorbis/
+  [Ogg]: https://www.xiph.org/ogg/
+  [Opus]: https://opus-codec.org/
   [FLAC]: https://xiph.org/flac/
+  [Speex]: https://www.speex.org/
+  [APE]: https://www.monkeysaudio.com/
+  [MPC]: https://musepack.net/
+  [WavPack]: https://www.wavpack.com/
+  [WAV]: https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html
+  [AIFF]: https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/AIFF/AIFF.html
+  [TrueAudio]: https://sourceforge.net/projects/tta/
+  [Matroska]: https://www.matroska.org/
+  [WebM]: https://www.webmproject.org/
   [GNU Lesser General Public License]: https://www.gnu.org/licenses/lgpl.html
   [Mozilla Public License]: https://www.mozilla.org/MPL/MPL-1.1.html

taglib/matroska/matroskafile.h

@@ -25,11 +25,14 @@
 #include "tfile.h"
 #include "matroskaproperties.h"
 
+//! An implementation of Matroska metadata
 namespace TagLib::Matroska {
   class Tag;
   class Attachments;
   class Chapters;
 
+  //! An implementation of TagLib::File with Matroska specific methods
+
   /*!
    * Implementation of TagLib::File for Matroska.
    */

taglib/toolkit/taglib.h

@@ -77,7 +77,8 @@ namespace TagLib {
  * - A clean, high level, C++ API for handling audio metadata.
  * - Format specific APIs for advanced API users.
  * - ID3v1, ID3v2, APE, FLAC, Xiph, iTunes-style MP4 and WMA tag formats.
- * - MP3, MPC, FLAC, MP4, ASF, AIFF, WAV, DSF, DFF, TrueAudio, WavPack, Ogg FLAC, Ogg Vorbis, Speex and Opus file formats.
+ * - MP3, MPC, FLAC, MP4, ASF, AIFF, WAV, DSF, DFF, TrueAudio, WavPack, Ogg FLAC, Ogg Vorbis, Speex,
+ *   Opus, Matroska and WebM file formats.
  * - Basic audio file properties such as length, sample rate, etc.
  * - Long term binary and source compatibility.
  * - Extensible design, notably the ability to add other formats or extend current formats as a library user.