18.Keyboard shortcuts & help overlay
The full default keymap (~120 actions, every one rebindable), the help overlay (press ?), the rebinding UI, the FZF query syntax, and mouse conventions. This is the only step you should bookmark for the future.
Open the help overlay
Press ? (Shift + /) anywhere in the app. The overlay (#helpOverlay via frontend/js/help-overlay.js) is a modal with a multi-column grid of sections. Click the background or the × button to dismiss. It reads the current shortcut map so if you rebind, the overlay reflects your binding.
Tab navigation
Cmd+1 Plugins Cmd+2 Samples Cmd+3 DAW Projects Cmd+4 Presets Cmd+5 MIDI Cmd+6 PDF Cmd+7 Favorites Cmd+8 Notes Cmd+9 Tags Cmd+0 Files F3 History F4 Visualizer F5 Walkers F6 Audio Engine Cmd+, Settings Cmd+] Next tab Cmd+[ Previous tab
Row navigation & selection
J / ↓ Next item K / ↑ Previous item GG First item G Last item Ctrl+D Half page down Ctrl+U Half page up / Focus search (vim-style) Cmd+F Focus search (modern) Enter Open / activate O Reveal in Finder Y Yank (copy path) P Play / preview X Toggle favorite V Toggle selection Shift+V Select all visible Cmd+A Select all visible (alternate) Cmd+Shift+Esc Deselect all
Playback & transport
Space Play / pause Cmd+→ Next track Cmd+← Previous track L Toggle loop B A/B loop (cycle A, B, clear) S Toggle shuffle M Toggle mute U Toggle mono Q Toggle EQ section E Expand / collapse player P Show / hide floating player Cmd+↑ Volume up Cmd+↓ Volume down W Find similar samples Cmd+H Clear play history
Scans & analysis
Cmd+S Scan all Cmd+. Stop all scans Cmd+Shift+P Scan plugins only Cmd+Shift+S Scan samples only Cmd+Shift+` Scan DAW projects only Cmd+Shift+R Scan presets only Cmd+Shift+F Scan PDFs only Cmd+Shift+E Scan videos only Cmd+Shift+Y Stop PDF scan Cmd+Shift+Q Stop video scan Cmd+Shift+M Extract PDF metadata Cmd+Shift+K Stop PDF metadata Cmd+Shift+F4 Stop fingerprint cache Cmd+Shift+B Build fingerprint cache Cmd+Shift+U Check plugin updates (KVR) Cmd+Shift+X Build plugin xref index Cmd+Shift+V Start BPM / key / LUFS analysis Cmd+Shift+C Stop BPM / key / LUFS analysis Cmd+Shift+, Start content-dup scan Cmd+Shift+. Stop content-dup scan Cmd+Shift+F5 Start all background jobs Cmd+Shift+F6 Stop all background jobs Cmd+Shift+Backspace Reset all scans / clear all caches
Row actions (any tab)
R Reveal in Finder / Explorer C Copy path F Toggle favorite N Add note Del Delete selected Esc Close / clear / stop context
Exports
Cmd+E Export current tab Cmd+I Import to current tab Cmd+Shift+W Export settings as PDF Cmd+Shift+L Export app log as PDF Cmd+Shift+I Export MIDI palette Cmd+Shift+J Export plugin xref Cmd+Shift+\ Export smart playlists
UI toggles & files
F1 Toggle CRT scanlines F2 Toggle neon glow Cmd+Y Toggle theme (dark / light) Cmd+Shift+T Toggle tag filter bar Cmd+K Command palette Cmd+T Toggle terminal Cmd+, Settings Cmd+D Find duplicates Cmd+G Dependency graph D Heatmap dashboard Shift+G Genre rules dashboard Cmd+P New smart playlist Cmd+Shift+O Open app log file Cmd+Shift+G Open prefs file Cmd+Shift+D Open data directory V Video maximize toggle (Videos tab)
Dynamic nudges (no UI open needed)
Cmd+Shift+↑ Increase table page size Cmd+Shift+↓ Decrease table page size Cmd+Shift++ Increase scan history keep Cmd+Shift+- Decrease scan history keep Cmd+Shift+? Cycle log verbosity Cmd+Shift+9 Clear analysis cache Cmd+Shift+N Toggle autoplay next Cmd+Shift+[ Autoplay source → player Cmd+Shift+] Autoplay source → samples Cmd+Shift+7 Video audio route → AudioEngine Cmd+Shift+8 Video audio route → HTML5
Settings toggles (function row)
Cmd+F7 / Cmd+Shift+F7 Auto analyze / auto-play sample on select Cmd+F8 / Cmd+Shift+F8 Auto scan / show player on startup Cmd+F9 / Cmd+Shift+F9 Auto update / expand on click Cmd+F10 / Cmd+Shift+F10 Folder watch / include Ableton backups Cmd+F11 / Cmd+Shift+F11 Incremental directory scan / prune old scans Cmd+F12 / Cmd+Shift+F12 Single click play / PDF metadata auto-extract
FZF query syntax
Every fuzzy search input in the app accepts FZF-style query modifiers:
term Fuzzy match anywhere 'exact Exact match (single quote prefix) ^prefix Prefix match suffix$ Suffix match !term Exclude matches containing term a | b OR combinator .* Regex (when the regex toggle is on)
Mouse conventions
- Click — select row.
- Drag samples — reorder in the floating-player history. Native drag-out works from every inventory row.
- Double-click — expand metadata / activate item / navigate into a directory.
- Right-click — context menu.
- Drag tabs — reorder tab bar.
- Drag player title — move floating player window.
- Drag column headers — reorder columns. Drag the column right edge to resize.
- Drag Settings section headers — reorder the Settings page layout.
Rebinding shortcuts
frontend/js/shortcuts.js (~120 entries in DEFAULT_SHORTCUT_DEFS). Open Settings → Keyboard Shortcuts (or the command palette's Help & Keyboard Shortcuts row). Every action in SHORTCUT_LABEL_KEYS is listed with its current binding. Click any binding to enter recording mode:
- The row gains the
.recordingclass and shows "Press key...". - Press the desired combination. Modifiers (
Cmd,Shift,Alt,Ctrl) are captured plus the base key. - Bare modifier keys are rejected;
Spaceand=/+are normalized.
Only non-default bindings are persisted — the serialized map stays small. resetShortcuts() wipes the custom map and restores defaults. A filter input (shortcutsFilter) lets you search through the list by action name. The shortcut row order itself is drag-reorderable — drops emit a toast.reordered_shortcut_rows toast and the order persists as shortcutOrder.
Reserved by macOS: Cmd+Tab (app switcher), Cmd+H (hide app), Cmd+M (minimize), Cmd+Q (quit) — these never reach the WebView. Don't rebind anything to them; the shortcut editor accepts the chord but the OS swallows the keystroke.