>_END-USER WALKTHROUGH
Nineteen self-contained stages, from first boot through every tab, every keyboard shortcut, every IPC surface, and finally the ALS generator that turns your library into a playable Ableton project. Each page is a deep-dive: controls, columns, filters, row actions, keybindings, backend hooks, and gotchas — grounded in the current code, not vibes.
How to useStart at step
01 and work forward with the Next button at the bottom of each page, or jump to any step from the grid below. Every page pulls its screenshots from ../assets/; text-only steps describe overlays that don't belong to a single tab.
Chapter 01 — Getting started
STEP 01
First launch & orientation
Header HUD, process stats strip, tab bar, boot sequence, welcome panel.
STEP 02
Configure scan roots
Per-scanner root lists, blacklist, auto-scan, folder watch, incremental, prune, FD limit, thread pool, SQLite read pool.
STEP 03
Run Scan All & Walkers tab
Unified scan, per-type scans, header counters, stop/resume-all, live walker tiles, progress events.
Chapter 02 — Core libraries
STEP 04
Plugins tab
VST/VST3/AU/CLAP table, status badges, KVR resolve + update queue, dependency graph, disk-usage strip, xref.
STEP 05
Audio samples tab
Streaming table, waveform + spectrogram preview, floating-player preview, fingerprints, find similar, content duplicates, heatmap.
STEP 06
BPM / key / LUFS analysis
Batch analyze, algorithm notes (onset autocorrelation, Krumhansl-Kessler, BS.1770), analysis cache, smart playlists.
STEP 07
DAW projects tab
Ableton, Logic, FL Studio, REAPER, Cubase/Nuendo, Pro Tools, Bitwig, Studio One, Reason, Audacity, GarageBand, Ardour, DAWproject — extract plugins + xref.
STEP 08
MIDI, presets, PDFs
MIDI metadata extraction (tracks/BPM/key/notes), preset catalog, PDF page counts with auto-extract, history + diffs.
Chapter 03 — Navigation & playback
STEP 09
Command palette (Cmd+K)
Static rows, DB preview, palette-driven scan triggers, toggles, dynamic actions, keyboard nav.
STEP 10
Floating player & transport
Waveform seek, EQ (200Hz/1kHz/8kHz), gain, pan, mono, speed, reverse, loop, A/B loop, shuffle, history search, autoplay chain.
STEP 11
Tray popover & menu bar
Menu-bar HUD, draggable scrubber, volume + speed, transport, theme + scheme sync, EOF watchdog.
Chapter 04 — Organization
STEP 12
Favorites, notes, tags
Starred paths across types, per-item notes, global tag manager, multi-filter dropdowns, tag cloud.
STEP 13
Files browser
Directory listing, breadcrumbs, quick-nav (Desktop/Downloads/Music/Documents), bookmarks, rename/delete/open-with, native drag.
STEP 14
Scan history & diffs
Merged sidebar, per-type detail panes, added/removed diffs, compare dropdown, clear-all.
Chapter 05 — Advanced surfaces
STEP 15
Real-time visualizer
Six tiles — FFT, oscilloscope, spectrogram, stereo, levels, bands. Engine spectrum vs Web Audio fallback, idle backoff.
STEP 16
Audio Engine tab
JUCE subprocess, device selection, sample rate, buffer frames, plugin insert chain, editor windows, diagnostics, restart.
Chapter 06 — Customization
STEP 17
Theme, CRT, neon, color schemes
Dark/light, five presets (Cyberpunk/Midnight/Matrix/Ember/Arctic), custom color editor, scheme sync to tray popover.
STEP 18
Keyboard shortcuts & help overlay
Full default keymap, rebinding UI, help overlay (press ?), FZF query modifiers, mouse conventions.
Chapter 07 — Authoring