A pure-Python inspector, editor, and forensic tool for audio files and synth/DAW presets: read the metadata, decode the format structure byte by byte, flag anomalies, repair broken containers, and identify how a file was made.
Reads BPM, key, duration, tags, and format info from WAV, AIFF, MP3, FLAC, OGG, Opus, M4A, MIDI, and Serum presets. Also structurally decodes Bitwig (.bwpreset/.bwclip), Native Instruments (Massive/Absynth/Kontakt/NKS/KORE), Vital, NCW, SoundFont (SF2/SF3), tracker modules (MOD/XM/IT), MP4, VST FXP, ReCycle RX2, and RMID containers via
inspect. Beyond reading:repairandvalidatefix and check container structure (stale sizes, offset tables, counts, pad bytes) without touching a byte of audio, andauditgives a forensic verdict (structure, integrity, hidden data, and the writing tool). One pure-Python dependency (mutagen); the nativeinspectwalkers need nothing. Optional librosa analysis for BPM/key detection and ML feature extraction.Also ships per-library SQLite indexes (
acidcat index) tracked in a small global registry, plus an MCP server (acidcat-mcp) so an LLM can query your whole collection across libraries by bpm, key, tags, or full-text.
github.com/hed0rah/acidcat
github.com/hed0rah/acidcat-playground
www.databurn.org
