Release v0.2.0

- Bump version to 0.2.0
- Add ID3v2.2 support, unsynchronization, frame flags, FLAC MD5
- Add picture support for WAV and AIFF
- Add SaveToFile(path) convenience overloads
- Update test count from 1528 to 1658 (+130 tests)

Author: decriptor

CHANGELOG.md

@@ -5,10 +5,47 @@ All notable changes to TagLibSharp2 will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.2.0] - 2025-12-29
 
 ### Added
 
+#### ID3v2.2 Legacy Support
+- Full ID3v2.2 (3-character frame ID) parsing support
+- Complete v2.2 → v2.3/v2.4 frame ID mapping (66 mappings)
+- Proper 3-byte big-endian size handling for v2.2 frames
+
+#### ID3v2 Unsynchronization
+- Global unsynchronization support (tag-level, v2.3/v2.4)
+- Per-frame unsynchronization support (v2.4 frame flag)
+- Proper 0xFF 0x00 byte sequence removal during parsing
+- Two-pass algorithm for efficient memory usage
+
+#### ID3v2 Frame Flags Processing
+- Compression support with zlib decompression (v2.3 and v2.4)
+- Grouping identity flag handling (skips group ID byte)
+- Data length indicator parsing (v2.4 syncsafe 4-byte prefix)
+- Encryption flag detection (content preserved as-is)
+
+#### FLAC MD5 Audio Signature
+- `FlacFile.AudioMd5Signature` property for 128-bit MD5 hash of unencoded audio
+- `FlacFile.AudioMd5SignatureHex` for hex string representation
+- `FlacFile.HasAudioMd5Signature` to detect if encoder computed the hash
+- Essential for bit-perfect archive verification
+
+#### Picture Support for WAV and AIFF
+- `WavFile.Pictures` and `WavFile.HasPictures` via embedded ID3v2 tag
+- `AiffFile.Pictures` and `AiffFile.HasPictures` via embedded ID3v2 tag
+- `CoverArt` convenience property for primary album art
+- Full PictureType support (FrontCover, BackCover, etc.)
+
+#### SaveToFile Convenience Overloads
+- `Mp3File.SaveToFile(path)` - saves to specified path
+- `FlacFile.SaveToFile(path)` - saves to specified path
+- `OggVorbisFile.SaveToFile(path)` - saves to specified path
+- `WavFile.SaveToFile(path)` - saves to specified path
+- `AiffFile.SaveToFile(path)` - saves to specified path
+- All with async variants accepting CancellationToken
+
 #### AIFF Write Support
 - `AiffFile.Render` for serializing AIFF files to binary data
 - `AiffFile.SaveToFile` and `SaveToFileAsync` for atomic file saves
@@ -64,7 +101,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Defense-in-depth checks added to AiffChunk, RiffChunk, and RiffInfoTag
 
 ### Changed
-- Test count increased from 1528 to 1564
+- Test count increased from 1528 to 1658 (+130 tests)
 
 ## [0.1.0] - 2025-12-26
 
@@ -226,4 +263,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - `BinaryData(byte[])` constructor now copies the array to ensure true immutability
 
+[0.2.0]: https://github.com/decriptor/TagLibSharp2/releases/tag/v0.2.0
 [0.1.0]: https://github.com/decriptor/TagLibSharp2/releases/tag/v0.1.0

Directory.Build.props

@@ -8,7 +8,7 @@
 		<Copyright>Copyright (c) 2025 Stephen Shaw and contributors</Copyright>
 
 		<!-- Version: Set via CI or use default for local builds -->
-		<ReleaseVersion Condition="'$(ReleaseVersion)' == ''">0.1.0</ReleaseVersion>
+		<ReleaseVersion Condition="'$(ReleaseVersion)' == ''">0.2.0</ReleaseVersion>
 		<VersionSuffix Condition="'$(VersionSuffix)' == '' And '$(CI)' == ''">dev</VersionSuffix>
 
 		<!-- Repository Info -->

src/TagLibSharp2/Aiff/AiffFile.cs

@@ -178,13 +178,13 @@ bool Parse (BinaryData data)
 	void ProcessChunk (AiffChunk chunk)
 	{
 		switch (chunk.FourCC) {
-		case "COMM":
-			ParseCommChunk (chunk);
-			break;
-		case "ID3 ":
-		case "ID3":
-			ParseId3Chunk (chunk);
-			break;
+			case "COMM":
+				ParseCommChunk (chunk);
+				break;
+			case "ID3 ":
+			case "ID3":
+				ParseId3Chunk (chunk);
+				break;
 		}
 	}
 

src/TagLibSharp2/Id3/Id3v2/Id3v2Tag.cs

@@ -2383,7 +2383,7 @@ static ReadOnlySpan<byte> ProcessFrameFlags (ReadOnlySpan<byte> content, byte fo
 			if (content.Length < offset + 4)
 				return content;
 			decompressedSize = (content[offset] << 24) | (content[offset + 1] << 16) |
-			                   (content[offset + 2] << 8) | content[offset + 3];
+							   (content[offset + 2] << 8) | content[offset + 3];
 			offset += 4;
 		}
 
@@ -2413,9 +2413,9 @@ static ReadOnlySpan<byte> ProcessFrameFlags (ReadOnlySpan<byte> content, byte fo
 	static int ReadSyncsafeInt32 (ReadOnlySpan<byte> data)
 	{
 		return ((data[0] & 0x7F) << 21) |
-		       ((data[1] & 0x7F) << 14) |
-		       ((data[2] & 0x7F) << 7) |
-		       (data[3] & 0x7F);
+			   ((data[1] & 0x7F) << 14) |
+			   ((data[2] & 0x7F) << 7) |
+			   (data[3] & 0x7F);
 	}
 
 	/// <summary>

src/TagLibSharp2/Mpeg/MpegFrame.cs

@@ -224,20 +224,20 @@ static int CalculateFrameSize (MpegLayer layer, int bitrate, int sampleRate, boo
 		int coefficient;
 
 		switch (layer) {
-		case MpegLayer.Layer1:
-			// Layer 1: frame size = (12 * bitrate / sampleRate + padding) * 4
-			paddingSize = hasPadding ? 4 : 0;
-			return ((12 * bitrate * 1000 / sampleRate) + (hasPadding ? 1 : 0)) * 4;
-
-		case MpegLayer.Layer2:
-		case MpegLayer.Layer3:
-			// Layer 2/3: frame size = 144 * bitrate / sampleRate + padding
-			paddingSize = hasPadding ? 1 : 0;
-			coefficient = 144;
-			return (coefficient * bitrate * 1000 / sampleRate) + paddingSize;
-
-		default:
-			return 0;
+			case MpegLayer.Layer1:
+				// Layer 1: frame size = (12 * bitrate / sampleRate + padding) * 4
+				paddingSize = hasPadding ? 4 : 0;
+				return ((12 * bitrate * 1000 / sampleRate) + (hasPadding ? 1 : 0)) * 4;
+
+			case MpegLayer.Layer2:
+			case MpegLayer.Layer3:
+				// Layer 2/3: frame size = 144 * bitrate / sampleRate + padding
+				paddingSize = hasPadding ? 1 : 0;
+				coefficient = 144;
+				return (coefficient * bitrate * 1000 / sampleRate) + paddingSize;
+
+			default:
+				return 0;
 		}
 	}
 

src/TagLibSharp2/Riff/RiffInfoTag.cs

@@ -104,25 +104,21 @@ public class RiffInfoTag : Tag
 	public override TagTypes TagType => TagTypes.RiffInfo;
 
 	/// <inheritdoc />
-	public override string? Title
-	{
+	public override string? Title {
 		get => GetField (INAM);
 		set => SetField (INAM, value);
 	}
 
 	/// <inheritdoc />
-	public override string? Artist
-	{
+	public override string? Artist {
 		get => GetField (IART);
 		set => SetField (IART, value);
 	}
 
 	/// <inheritdoc />
 #pragma warning disable CA1819 // Properties should not return arrays - TagLib# API compatibility
-	public override string[] Performers
-	{
-		get
-		{
+	public override string[] Performers {
+		get {
 			var artist = GetField (IART);
 			return string.IsNullOrEmpty (artist)
 				? []
@@ -133,32 +129,27 @@ public override string[] Performers
 #pragma warning restore CA1819
 
 	/// <inheritdoc />
-	public override string? Album
-	{
+	public override string? Album {
 		get => GetField (IPRD);
 		set => SetField (IPRD, value);
 	}
 
 	/// <inheritdoc />
-	public override string? Comment
-	{
+	public override string? Comment {
 		get => GetField (ICMT);
 		set => SetField (ICMT, value);
 	}
 
 	/// <inheritdoc />
-	public override string? Genre
-	{
+	public override string? Genre {
 		get => GetField (IGNR);
 		set => SetField (IGNR, value);
 	}
 
 	/// <inheritdoc />
 #pragma warning disable CA1819 // Properties should not return arrays - TagLib# API compatibility
-	public override string[] Genres
-	{
-		get
-		{
+	public override string[] Genres {
+		get {
 			var genre = GetField (IGNR);
 			return string.IsNullOrEmpty (genre)
 				? []
@@ -169,10 +160,8 @@ public override string[] Genres
 #pragma warning restore CA1819
 
 	/// <inheritdoc />
-	public override string? Year
-	{
-		get
-		{
+	public override string? Year {
+		get {
 			var icrd = GetField (ICRD);
 			if (string.IsNullOrEmpty (icrd))
 				return null;
@@ -184,10 +173,8 @@ public override string? Year
 	}
 
 	/// <inheritdoc />
-	public override uint? Track
-	{
-		get
-		{
+	public override uint? Track {
+		get {
 			var track = GetField (ITRK);
 			if (string.IsNullOrEmpty (track))
 				return null;
@@ -198,17 +185,15 @@ public override uint? Track
 	}
 
 	/// <inheritdoc />
-	public override string? Copyright
-	{
+	public override string? Copyright {
 		get => GetField (ICOP);
 		set => SetField (ICOP, value);
 	}
 
 	/// <summary>
 	/// Gets or sets the software field.
 	/// </summary>
-	public string? Software
-	{
+	public string? Software {
 		get => GetField (ISFT);
 		set => SetField (ISFT, value);
 	}

tests/TagLibSharp2.Tests/Aiff/AiffFilePictureTests.cs

@@ -27,7 +27,7 @@ static BinaryData CreateMinimalAiff ()
 		builder.AddUInt16BE (2);      // channels
 		builder.AddUInt32BE (0);      // sample frames
 		builder.AddUInt16BE (16);     // bits per sample
-		// 80-bit extended sample rate (44100 Hz)
+									  // 80-bit extended sample rate (44100 Hz)
 		builder.Add (new byte[] { 0x40, 0x0E, 0xAC, 0x44, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 });
 
 		// SSND chunk (empty)

tests/TagLibSharp2.Tests/Core/SaveToFileConvenienceTests.cs

@@ -2,8 +2,8 @@
 
 using TagLibSharp2.Core;
 using TagLibSharp2.Mpeg;
-using TagLibSharp2.Xiph;
 using TagLibSharp2.Ogg;
+using TagLibSharp2.Xiph;
 
 namespace TagLibSharp2.Tests.Core;
 
@@ -50,7 +50,7 @@ static byte[] CreateMinimalFlac ()
 		builder.Add (new byte[] { 0x10, 0x00 }); // max block size
 		builder.Add (new byte[] { 0x00, 0x00, 0x00 }); // min frame size
 		builder.Add (new byte[] { 0x00, 0x00, 0x00 }); // max frame size
-		// sample rate (20 bits) = 44100, channels (3 bits) = 2-1, bps (5 bits) = 16-1, samples (36 bits)
+													   // sample rate (20 bits) = 44100, channels (3 bits) = 2-1, bps (5 bits) = 16-1, samples (36 bits)
 		builder.Add (new byte[] { 0x0A, 0xC4, 0x42, 0xF0, 0x00, 0x00, 0x00, 0x00 });
 		builder.AddZeros (16); // MD5
 

tests/TagLibSharp2.Tests/Mpeg/MpegAudioPropertiesTests.cs

@@ -296,7 +296,7 @@ static BinaryData CreateDataWithId3v2Prefix (int id3Size, BinaryData mp3Data)
 		builder.Add (0x49, 0x44, 0x33);  // "ID3"
 		builder.Add (0x04, 0x00);         // Version 2.4
 		builder.Add (0x00);               // Flags
-		// Syncsafe size (without header)
+										  // Syncsafe size (without header)
 		var payloadSize = id3Size - 10;
 		builder.AddSyncSafeUInt32 ((uint)payloadSize);
 

tests/TagLibSharp2.Tests/Riff/BextTagTests.cs

@@ -146,7 +146,7 @@ public void Umid_Version1_ParsedCorrectly ()
 	{
 		var data = CreateMinimalBextChunk ();
 		data[346] = 0x01; // Version 1
-		// UMID at offset 348, 64 bytes
+						  // UMID at offset 348, 64 bytes
 		for (int i = 0; i < 64; i++)
 			data[348 + i] = (byte)(i + 1);