Skip to content

Repository files navigation

Music Scan Integrity

Checks a music collection for corrupted files. Windows 10/11, offline.

.NET 10 BSD 3-Clause licence Windows x64


The program finds files that are physically damaged and will not play, telling them apart from files that merely lack tags or look unusual but are in fact fine. It works offline and only reads files - it never deletes or renames anything.

Every file is checked twice: by the decoder, to confirm that audio can be read from it, and by parsing the format itself - whether the checksums stored inside the file add up. The second check is exact where the first only answers "it opened": a truncated FLAC decodes fine, while comparing its checksums and declared length shows that part of the file is missing.

A separate setting turns on decay tracking: the program remembers a fingerprint of every file and, on the next scan, notices that the content changed while the size and date stayed the same - that is what a failing disk looks like.

Supported formats

WAV, AIFF, FLAC, ALAC, M4A, APE, WV, MP3, AAC, OGG, Opus, WMA, DSF, DFF, as well as tracker formats (MIDI, MOD, XM, IT, S3M) and M3U, M3U8, PLS and CUE playlists.

Building from source

pwsh tools/fetch-bass.ps1              # BASS libraries - fetched separately, not in the repository
dotnet build MusicScanIntegrity.sln -c Release
dotnet run --project src/MusicScanIntegrity.App -c Release

Portable build:

dotnet publish src/MusicScanIntegrity.App -c Release -r win-x64 --self-contained true -o artifacts/publish

Installer (needs Inno Setup 6+, run after the portable build):

iscc /DAppVersion=1.0.0 installer/MusicScanIntegrity.iss

Documentation

docs/INTERNALS.md - how everything works inside: check methods, working with BASS, the engine, reports, debatable decisions and the reasoning behind them.

Licence

BSD 3-Clause. The BASS libraries are not covered by it - they are free for non-commercial use only, see THIRD-PARTY-NOTICES.md for details.

About

Checking Your Music Collection for Corrupted Files. For Windows 10/11, works offline.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages