TRACKLINT(1)

📦
version 3.1.1 · 4 versions
, in ubuntu questing

✨ TRACKLINT(1) ✨

aka tracklint — the lil command from the Track Checker manual that checks and fixes minor track metadata errors automatically 💅 no cap.

okay bestie, sit down, hydrate, because this one is genuinely a whole vibe 🫶

🌸 NAME 🌸

tracklint — checks and fixes minor track metadata errors automatically ✨

🎀 SYNOPSIS 🎀

tracklint [OPTIONS] <track 1> [track 2] ....

🦋 DESCRIPTION 🦋

So here's the tea, bestie 💖 — tracklint takes a list of audio tracks, examines their metadata for common problems, and suggests fixes for them. It's giving "your librarian friend who notices your ID3 tags are a mess and is too polite to scream" 😭

And if you hand it directories? Bestie it does not stop at the surface — it searches them recursively and suggests fixes for any audio tracks it finds in there. Down the whole tree. Iconic behaviour, honestly. 🌳✨

It can also actually perform any of those suggested metadata fixes if you ask it nicely (that's the --fix energy), and it can undo any performed fixes if an undo database was used. Yes queen, reversible. We love a safe experiment. 👑

💅 OPTIONS 💅

  • -h, --help — shows you a list of options and then dips. Exit stage left. 🚪✨
  • --fix — actually performs tracklint's suggested fixes on the given audio tracks. This is the "no thoughts, just commit" button, so like… be aware. 💀
  • -V, --verbose=VERBOSITY — the level of output to display. Pick between 'normal', 'quiet' and 'debug'. Quiet when you're in your chill era, debug when you're in your detective era 🔍

🔥 FIXES 🔥

Here's the main character section. The following fixes are performed on each track, one by one, slay by slay:

  • Leading zeroes are stripped from track number and album number fields. For example, a track number value of "01" is changed to "1". Bye bye, pointless zero 🎀
  • If the track number field is between 100 and 999, the leading digit becomes the album number and the trailing two digits become the track number. For example, a track number value of "213" results in an album number of "2" and a track number of "13". Math girlies rise 🧮✨
  • If the performer name is the same as the artist name, the redundant performer name field is removed. We don't do duplicates in this house 🚫
  • Leading or trailing whitespace is removed from fields. For example, a track name value of "Some Title " becomes "Some Title". That sneaky little space at the end? Gone. Periodt. 💅
  • Empty fields are removed. If it's got nothing to say, it doesn't get a seat at the table 🪑❌
  • Embedded images with invalid metadata fields such as width or height are fixed. Your album art gets a glow-up 🖼️✨
  • ID3v2 and ID3v1 tags are stripped from FLAC files. Not their house, not their tags. 🏠
  • FLAC files with misordered STREAMINFO blocks are reordered. We put things back in their correct order, because chaos is only cute in theory 😌
  • A WAVEFORMATEXTENSIBLE_CHANNEL_MASK tag is added to multi-channel or 24 bits-per-sample FLAC files if one isn't present in its metadata. Just filling in the gaps, bestie 🫶

🌈 SEE ALSO 🌈

Your extended friend group, fr fr:

👑 AUTHOR 👑

Brian Langenberger — the actual legend behind all this. Respect the architect 🫡

vibe check passed ✅ — this page was handcrafted with love, dated 2025-03-10, brought to you by the Track Checker manual. Go fix those tags, bestie, you've got this 💖🌸✨
📦 where this page comes from