Skip to content

Keep Matroska track and album titles apart - #122

Merged
decriptor merged 3 commits into
mainfrom
fix/matroska-title-level
Nov 18, 2026
Merged

decriptor merged 3 commits into
mainfrom
fix/matroska-title-level

Conversation

@decriptor

@decriptor decriptor commented Nov 17, 2026 •

Copy link
Copy Markdown
Owner

Summary

Title and Album were the same Matroska TITLE whenever the file's most specific file-level target was 50. Setting either one replaced the other.

TITLE at target 30 is the track. TITLE at target 50 is the album or movie. Title writes only level 30. When the track has no TITLE, the display is the segment title, then the most specific file-level TITLE below a collection (70). That includes a lone album or movie title at 50, and a part (40), movement (20), shot (10), or edition (60) title when nothing more specific is set. An empty track TITLE still blocks every broader title. Album always reads and writes level 50. A collection TITLE at 70 is neither Title nor Album.

Artist writes at level 30. Reading still inherits an album artist when the track has none.

Fixes #121

Tests

dotnet test tests/TagLibSharp2.Tests/TagLibSharp2.Tests.csproj -c Debug -f net8.0 -p:WarningsNotAsErrors=CA2027 --filter FullyQualifiedName~Matroska

Passed: 101, Failed: 0, Skipped: 0

TITLE at target 30 is the track. TITLE at target 50 is the album.
Setting one no longer replaces the other, and an album-only ARTIST
is not replaced when the track artist is set.
@codecov

codecov Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 97.75281% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 92.98%. Comparing base (851b03f) to head (6443478).

Files with missing lines Patch % Lines
...s/TagLibSharp2.Tests/Matroska/MatroskaFileTests.cs 95.12% 0 Missing and 2 partials ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main     #122      +/-   ##
==========================================
+ Coverage   92.97%   92.98%   +0.01%     
==========================================
  Files         282      282              
  Lines       54202    54260      +58     
  Branches     4961     4970       +9     
==========================================
+ Hits        50392    50454      +62     
+ Misses       2260     2258       -2     
+ Partials     1550     1548       -2     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

A TITLE at target 50 still displays as Title until a track title or
a segment title exists. Writing Title still goes to target 30, so it
does not replace the album title.
A file-level TITLE below a collection still displays when the track
has none. Album stays the title at level 50.
@decriptor
decriptor merged commit bd067fb into main Nov 18, 2026
8 checks passed
@decriptor
decriptor deleted the fix/matroska-title-level branch November 18, 2026 06:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: Matroska Title tag reads/writes at album level

1 participant