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.

Theme loading comes from makeover, published to crates.io. Shared libraries from ../../MNW/shared/: 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, from the shared makeover crate
• 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