audiofiles

A sample manager with content-addressed storage and a virtual file system. Standalone desktop app built with Rust, egui, and SQLite.

Prerequisites

• Rust (stable toolchain, 2024 edition)

No platform-specific audio libraries are required. Audio decoding uses Symphonia (pure Rust), SQLite is bundled via rusqlite, and the standalone app uses cpal for system audio output.

Build and Run

# Standalone app
cargo run -p audiofiles-app

# Standalone app -- import a folder on launch
cargo run -p audiofiles-app -- /path/to/samples

# Run all workspace tests
cargo test --workspace

# Train the ML classifier (developers only)
cargo run -p audiofiles-train -- /path/to/training-data

Workspace Architecture

Six crates:

Dependency flow: audiofiles-core is the leaf -> audiofiles-rhai and audiofiles-sync depend on core -> audiofiles-browser depends on core, sync, and rhai -> audiofiles-app depends on browser and core. audiofiles-train depends on core only.

Shared libraries from ../../MNW/shared/: theme-common (theme loading), synckit-client (cloud sync SDK).

Features

Storage & Organization

• Content-addressed storage – samples stored by SHA-256 hash, automatic deduplication
• Virtual file system – organize samples in virtual directories independent of disk location, multiple VFS roots
• Tag system – hierarchical dot-notation tags with auto-suggestions from analysis results
• Smart folders – saved filter queries that update dynamically
• Collections – cross-VFS sample groupings

Audio Analysis

• Analysis pipeline – loudness (peak/RMS/LUFS), BPM detection, key detection, spectral analysis
• ML classification – two-layer system: rule-based broad categories, then 200-tree random forest for drum sub-classification (94.4% accuracy on 4,343 samples)
• Loop detection – identifies seamless loops via amplitude envelope analysis
• Similarity search – VP-tree indexed fingerprinting for finding similar and duplicate samples (O(log n) lookup)
• Waveform display – pre-computed peak data with click-to-seek playback

Search & Filtering

• Text search – FTS5 indexed across filenames, tags, and metadata
• Parameter filters – BPM range, duration range, key selector, classification category
• Tag prefix matching – type a tag prefix to filter by hierarchy

Editing

• Destructive editing – trim, fade in/out, normalize, reverse, gain adjust
• Edit history – full undo/redo stack per sample
• Bulk operations – bulk delete, move, rename, tag across selections
• Rename engine – pattern-based renaming with tokens (name, bpm, key, index, etc.)

Device Export

• Rhai export profiles – scriptable export for 14 hardware samplers: M8, Digitakt, Digitakt II, Octatrack, Model:Samples, SP-404 MKII, MPC, Polyend Tracker, Deluge, Blackbox, Volca Sample 2, OP-1, Circuit Rhythm, Maschine+

Playback & Integration

• MIDI instrument – chromatic and multi-sample playback modes with 8-voice polyphony and ADSR envelopes
• Native drag-out – drag samples from the file list directly to Finder, Desktop, or any DAW (macOS + Windows)
• System tray – minimize to tray, quick access

Infrastructure

• Cloud sync – cross-device sync of metadata, tags, and VFS via SyncKit (E2E encrypted, ChaCha20-Poly1305 + Argon2)
• OTA updates – background update checker with consent dialog
• Bundled themes – dark, light, and high-contrast variants in TOML format (see crates/audiofiles-browser/themes/)
• Audio formats – WAV, FLAC, MP3, OGG, AIFF (via Symphonia, pure Rust)
• Platforms – macOS, Windows, Linux (standalone, no backend required)

Key Paths

License

PolyForm Noncommercial 1.0.0