Version 2.2.1

When using for example

examples/tagwriter -C GENRE \
"name=GENRE,targetTypeValue=50,value=Soft Rock;name=GENRE,targetTypeValue=50,value=Classic Rock" \
path/to/file.mka

the GENRE key was included twice and tagreader displayed the two genre
tags twice.

CHANGELOG.md

@@ -1,3 +1,9 @@
+TagLib 2.2.1 (Mar 7, 2026)
+==========================
+
+ * Support edition, chapter and attachment UIDs in Matroska simple tags.
+ * Avoid duplicates in Matroska complex property keys.
+
 TagLib 2.2 (Feb 18, 2026)
 =========================
 

CMakeLists.txt

@@ -93,7 +93,7 @@ endif()
 # Patch version: increase it for bug fix releases.
 set(TAGLIB_SOVERSION_MAJOR 2)
 set(TAGLIB_SOVERSION_MINOR 2)
-set(TAGLIB_SOVERSION_PATCH 0)
+set(TAGLIB_SOVERSION_PATCH 1)
 
 include(ConfigureChecks.cmake)
 

taglib/matroska/matroskatag.cpp

@@ -551,10 +551,11 @@ StringList Matroska::Tag::complexPropertyKeys() const
 {
   StringList keys;
   for(const SimpleTag &t : std::as_const(d->tags)) {
-    if(t.type() != SimpleTag::StringType ||
-       t.trackUid() != 0 || t.editionUid() != 0 ||
-       t.chapterUid() != 0 || t.attachmentUid() != 0 ||
-       translateTag(t.name(), t.targetTypeValue()).isEmpty()) {
+    if((t.type() != SimpleTag::StringType ||
+        t.trackUid() != 0 || t.editionUid() != 0 ||
+        t.chapterUid() != 0 || t.attachmentUid() != 0 ||
+        translateTag(t.name(), t.targetTypeValue()).isEmpty()) &&
+       !keys.contains(t.name())) {
       keys.append(t.name());
     }
   }

taglib/toolkit/taglib.h

@@ -28,7 +28,7 @@
 
 #define TAGLIB_MAJOR_VERSION 2
 #define TAGLIB_MINOR_VERSION 2
-#define TAGLIB_PATCH_VERSION 0
+#define TAGLIB_PATCH_VERSION 1
 
 #if (defined(_MSC_VER) && _MSC_VER >= 1600)
 #define TAGLIB_CONSTRUCT_BITSET(x) static_cast<unsigned long long>(x)