Skip to content

Earditor v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@ssskay ssskay released this 16 Jul 13:09
· 12 commits to main since this release
v1.0.0
18edd07

Earditor v1.0.0

The auditor for your music library. Metadata backed by evidence.

Earditor listens to your files, gathers evidence from independent sources (Shazam,
AcoustID + MusicBrainz, iTunes), scores it deterministically, and tells you exactly
which metadata it can prove — and which it can't. Every file lands in a verdict tier
(VERIFIED / LIKELY / COVER / UNVERIFIED / NO_MATCH), and covers by uploaders are a
first-class outcome, not a mislabel. Proof, not guesses.

Downloads

Platform File Notes
macOS Earditor-macOS.zip Signed & notarized. Full experience: tags files and syncs Music.app (artwork refresh, Earditor — Tagged playlist).
Windows Earditor-windows.zip Files-only mode: scan, verify, review, and tag your files — no Music.app integration. Unsigned: SmartScreen will warn on first launch — click More info → Run anyway. Windows 10 may need the WebView2 runtime (preinstalled on Windows 11).

Both builds bundle fpcalc, so AcoustID's second fingerprint works out of the box —
just add your free key (macOS Keychain or $ACOUSTID_API_KEY — see the README).
Without a key, Earditor runs Shazam-only and still works.

Try it in 60 seconds

No install, no keys, no music of your own — demo mode loads a fully synthetic library:

git clone https://github.com/ssskay/earditor.git && cd earditor
pip install -r requirements-demo.txt
python3 review.py --demo

(The packaged apps support demo mode too.)

Highlights

  • Triage first: retires the already-tagged half of a library in ~1 minute, before a single API call.
  • The cover rule — blank beats wrong: covers keep the uploader as artist and their own thumbnail; Earditor never borrows official art it can't justify.
  • Evidence, visible: every review card shows what each source returned and the exact tags each button will write. No hidden transforms.
  • Auto-align compare player (source installs with requirements-align.txt): lines your local file up against the 30s catalog preview automatically, with a match-confidence badge.
  • Path filters: include_paths / exclude_paths in config, so audiobooks stay out and you can work one artist at a time — see docs/CONFIGURATION.md.
  • Local by design: no accounts, no telemetry. Your library data never leaves your machine; state lives in ~/Library/Application Support/Earditor (macOS) / %APPDATA%\Earditor (Windows).

Notes

  • macOS will ask to allow controlling Music on first accept — that's the playlist/artwork integration.
  • Auto-align is not bundled in the packaged apps (it would double the size); the badge reads "align n/a" and manual nudge still works.
Assets 4
Loading