Canonical music library

Each imported recording receives a platform UUID. Exact source SHA-256 detects identical files; a separate canonical-PCM hash protects replay assets. Chromaprint fingerprints are stored for future near-duplicate comparison and do not automatically merge tracks. External IDs remain mappings, never primary identity.

In local SQLite mode, an asset directory contains original.media, canonical stereo audio.wav, and versioned track.json. library.sqlite is a SQLx-managed index rebuilt from track sidecars at startup. Deleting the index does not delete music or reviews. Writes update sidecars and the index; startup rebuild repairs an interrupted index update. Back up the entire data directory, not only SQLite.

Import currently accepts mono/stereo WAV, FLAC, MP3, AIFF and M4A (AAC/ALAC) through the UI, limits files to 150 MB and tracks to 20 seconds–15 minutes, and decodes/resamples before analysis. Lofty retains title/artist/album/genre tags. Native analysis supplies a provisional onset-based BPM/grid, chroma-based key estimate, waveform, bass density, RMS energy curve, and EBU R128 integrated loudness/true peak. These are separate features: energy is not LUFS.

Imported BPM, first beat, regular phrase length and key must be reviewed before a track becomes eligible. Review uses a revision precondition to reject stale edits and recomputes grid-dependent energy. The native analyzer never silently overwrites human corrections. Synthetic demo tracks carry generator-known grids and keys.

The Rust musical analyzer adds cached timelines, raw ONNX sound-event scores, mean embeddings and unapproved transition-region candidates. Calibrated vocal probability and semantic section labels remain unavailable. Model assets are explicitly prepared and supplied; they are not bundled. Analysis occurs offline, not during playback. The UI now provides paginated search, a searchable source-file inventory, native/model metrics, listening preview and complete report export. It does not yet provide a professional beatgrid editor.

The master library preserves originals and full platform analysis. PCM WAV, M3U8 and rekordbox XML export are now available through the CLI, with an asset/metadata preflight check in the UI. Direct OneLibrary/Device Library databases and physical device verification remain pending. See club interchange.

Sources: Symphonia, Lofty, Chromaprint, ebur128.

MongoDB mode uses central track metadata and versioned analysis documents, with PCM/originals retained on disk. Sidecars become legacy snapshots rather than the source of truth. See shared storage.