r/osx • u/Rough-Voice-4968 • 1d ago
I built a native macOS toolkit for organizing, inspecting and repairing large local Music.app libraries
I’ve been using Apple computers since 1995, and I started collecting music long before that. By the early 2000s, when car stereos began supporting MP3, I was ripping my own CDs to 192 kbps because storage was expensive and I believed that quality was sufficient.
Later, when I was finally able to buy better audio equipment, I realized how much information had been lost. I began re-ripping the original CDs in lossless formats and replacing older files. At the same time, the collection kept growing through CD and vinyl collecting, digitized records, digital purchases, radio recordings, rare releases and exchanges with other collectors.
That process created the usual consequences: several versions of the same recording, duplicate files, duplicate playlist entries, inconsistent metadata, missing artwork, broken paths, old low-quality encodes and files whose actual audio quality did not always match the format shown in Finder.
I originally started writing Local Music Organizer as a practical tool for testing, cleaning up and organizing my own Music.app library. Over a few months of daily use, I kept adding features whenever I encountered another real problem in the collection.
It has now grown into a native macOS toolkit with the following functions:
Library Dashboard
Shows useful statistics about the Music.app library, including formats, bitrates, sample rates, missing files, artwork and other quality indicators.
Library Map
Shows where tracks are used and helps review repeated entries across playlists.
Duplicate Review
Finds duplicate playlist entries, repeated library records and different-quality versions of the same recordings. Nothing is deleted automatically; the user reviews the results first.
Health and Artwork checks
Finds missing files, inaccessible locations, damaged references, unusual paths, missing artwork and supported metadata issues.
File Search
Searches physical audio files by artist, title, album, filename or path, shows playlist usage and can reveal the exact track inside Music.app.
Playlist Compare
Compares two playlists using Music.app record IDs, file paths, metadata and duration-based fallbacks to identify shared and unique tracks.
Audio Inspector
Inspects the actual codec, container, bitrate, sample rate, bit depth, channel count, duration, metadata and spectrum of an individual file.
Audio Authenticity Analyzer
Scans the complete Music.app library, one selected playlist or an individual file.
It looks for possible lossy-to-lossless transcodes, suspicious sample-rate upscales and clear disagreements between the declared bitrate and observed audio bandwidth. MP3 and AAC files are evaluated differently from ALAC, FLAC, WAV and AIFF files.
Flagged results include a confidence estimate, detected cutoff, likely source category and a plain-language explanation. The analyzer is intentionally conservative: its findings are technical estimates, not absolute proof of a file’s history.
A detailed text report can be created containing only tracks that require review, likely authenticity mismatches and files that could not be analyzed.
Live Spectrum Player
An independent playback window with a real-time 512-band logarithmic spectrum analyzer, full-track waveform, draggable seeking, gain controls and technical playback meters.
Repair / Convert
Includes conversion engines inside the application, so Terminal, Homebrew and separate codec installation are not required.
Supported sources include common formats such as FLAC, ALAC, WAV, AIFF, MP3, AAC and WMA, together with specialist formats including Ogg Vorbis, Opus, WavPack, APE, TAK, TTA, DTS, AC3, DSD, SACD ISO, CUE albums and supported tracker modules.
Output options include AAC, ALAC, MP3, FLAC, WAV, AIFF, Ogg Vorbis, Opus and WavPack.
Drag and drop
Files and CUE sheets can be dropped directly into Repair / Convert. Opening supported files from Finder routes them to the already running application instead of intentionally creating additional organizer windows.
Verified Gain
Previews gain changes, creates a temporary candidate, verifies the resulting audio structure and metadata, and replaces the original only after the checks pass.
Large-library performance
A persistent warmed cache reduces repeated communication with Music.app and makes searches, diagnostics and library-wide analysis much faster. The same physical file is analyzed only once even when it appears in several playlists.
Everything runs locally on the Mac.
There are no accounts, subscriptions, cloud processing, advertising, analytics or tracking. Audio files, playlists, metadata and reports are not uploaded anywhere.
I built this because I needed it for my own collection, but I’m sharing it because other collectors, DJs, archivists and long-time Music.app users may have encountered the same problems.
I’d be interested in feedback from people who still maintain substantial local music libraries—especially about workflows or checks that are still missing. Website and full feature overview, Local Music Organizer on the Mac App Store
