Files
soundcraft/docs/ui-parity.md
T
Brandon ThomasandClaude Opus 5.5 330a698397 Progress docs: target-app parity, gaps, alpha gate, readiness by audience (#155)
* Progress docs to the craftrules standard; full re-measure against Pro Tools 2026.4.1

Stage: alpha. Menu breadth 482/512 (94.1%, measured), feature breadth ~70%,
ready for real work ~40%; ~350-570 agent-hours to beta, ~950-1,450 to full parity,
calibrated on this repo's PR history.

- ROADMAP.md rewritten: stage banner, two numbers, dimension/feature/language tables
- docs/target-app-parity.md: authoritative assessment (area table moved from ROADMAP)
- docs/gaps.md: 22 ranked gaps with evidence and estimates
- docs/roadmap.md: milestones, current focus, beta plan
- docs/ui-, file-format-, hardware-, plugin-, localization-parity.md: new checklists
- docs/parity.md -> docs/parity-checklist.md (generated by cargo xtask parity)
- architecture.md: video, vst3-host, au-host crates; device I/O limits

Co-Authored-By: Claude Opus 5.5 <[email protected]>

* Stage: pre-alpha under the core-workflow gate

Add the alpha gate to docs/roadmap.md: interface recording at a chosen buffer
size, MIDI recording, and session interchange with Pro Tools fail, so the stage
moves from alpha to pre-alpha (~5 points and ~110-180 agent-hours to alpha).
Mark the alpha blockers in docs/gaps.md; update ROADMAP.md, target-app-parity.md
and README.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

* Add mainstream-practitioner and essentials-user readiness numbers

Mainstream practitioner ~36% (weekly-area depth 50.6% x 0.90 interaction x 0.92
stability x 0.85 file exchange) and essentials user ~57% (core-feature depth
72.4% x 0.90 launch/stability x 0.90 discoverability x 0.97 files), with written
weights, discounts and GitHub user evidence. Full ready-for-real-work checked
against its written dimension weights (40.6%); unchanged at ~40%, stage unchanged.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

* Readiness by audience: hours to ~95% for full, mainstream and essentials

Full ~40% / 950-1,450 h, mainstream ~36% / 380-600 h, essentials ~57% / 110-200 h,
calibrated on this repo's PR history. The full number is already an additive
weighted sum over the written dimension table; method unchanged.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

---------

Co-authored-by: Claude Opus 5.5 <[email protected]>
2026-10-10 14:08:49 -04:00

4.2 KiB
Raw Blame History

UI parity

Last reviewed: 2026-10-10 · Last updated: 2026-10-10 · Change: major (first interaction checklist against Pro Tools 2026.4.1) · Target: Avid Pro Tools Ultimate 2026.4.1

How SoundCraft feels in the hands of a Pro Tools user: tools, modes, modifiers, shortcuts, windows, meters. Measured from crates/model/src/session.rs (tools, modes), the command registry (shortcuts), crates/ui-egui/src (windows, gestures) and user issues; compared with reference screenshots kept locally under plan/protools/screenshots/ (16, never committed).

UI/UX fidelity: ~55 % ready (estimated). Remaining ≈ 60–100 h.

Legend: ✅ matches · 🟡 partial · ❌ missing.

Tools and modes

Feature Status Notes
Tools: Zoom, Trim, Selector, Grabber, Scrubber, Pencil, Smart (7) ✅ present Trim variants (TCE, loop, scrub trim) and Grabber variants (separation, object) partial; Multitool fade/trim handles don't adjust audio (#5)
Edit modes: Shuffle, Slip, Spot, Grid (absolute/relative) ✅ Spot dialog present
Grid and nudge values, all timebases ✅ Bars/Beats, Min:Secs, Timecode, Feet+Frames, Samples
Keyboard focus modes (Commands, Clip List, Groups) 🟡 Commands focus single-key editing ✅; list focus partial
Link timeline/edit, link track/edit, Tab to transient, insertion follows playback ✅
Mirrored MIDI, MIDI merge, layered editing 🟡 Stored and partly honoured

Keyboard and mouse

Feature Status Notes
Default shortcuts 🟡 146 bound (measured: distinct Some("…") shortcuts in the registry) Pro Tools' default set is several hundred incl. numeric keypad and focus keys. Collisions: Mix/Edit toggle vs zoom (#144), Heal (#140), Export (#7)
Ctrl as Cmd on Windows/Linux ✅ since #15, #41 still open in some builds #62 shows Ctrl in labels
Numeric keypad transport and memory-location recall 🟡 Classic / Transport / Shuttle modes not all present
Modifier gestures (Alt for all tracks, Shift-Alt for selected, Cmd-click fine faders, Ctrl-click defaults) 🟡 Main ones on faders and pan; not across every control
Scroll/zoom: wheel, trackpad pinch 🟡 Anchored trackpad zoom in open PRs #112, #137
Drag and drop: Clip List → tracks, files → tracks ✅ macOS/Windows; 🟡 Wayland (PR #150)
Context menus (clip, track name, ruler, Clip List) 🟡 Clip and track menus exist; depth lower than Pro Tools'; Clip List delete (#4)

Windows and panels

Window Status Notes
Edit window: rulers, track headers, view columns, Clip List, Groups, Tracks list ✅ Track Pin (new in 2026.4) ✅ (track.pin)
Mix window: strips, views (inserts, sends, I/O, comments, EQ curve, preamps, instruments, object) ✅ Narrow Mix ✅; Delay Compensation view and HEAT missing
MIDI Editor, Score Editor, Event List 🟡 Dock height bug fixed (#113); notation editing shallow
Transport, Big Counter, Memory Locations, Automation, Video, Universe, Renderer, UI Customization ✅ present
Workspace / sound browser with previews ❌ G-16
I/O Setup 🟡 Busses and paths; no hardware channel matrix (G-01)
Preferences 🟡 Many settings stored, fewer honoured
Window configurations, Tile/Cascade 🟡 Configurations ✅; Tile/Cascade in PR #151
Plugin windows 🟡 Generic parameter sliders; Pro Tools plugins have bespoke GUIs (#138 asks for skeuomorphic design); multi-page plugin views (#6)
Command palette (Search) ✅ Over every command

Look and meters

Feature Status Notes
Dark theme close to Pro Tools' ✅ Light theme (#32) and live system appearance (#85) beyond Pro Tools
Interface scaling 🟡 Slider in PR #147
Meter types and ballistics (peak, RMS, VU, K-scales, gain reduction) 🟡 Peak/RMS; meter type choice and GR meters partial
Clip indicators, track colours, waveform views (peak/power/rectified/outlines) ✅
Fader resolution, fine adjust, numeric entry 🟡
macOS system menu bar ✅ #10

Revision history

Date Change Summary
2026-10-10 major Created: tools, modes, shortcuts, windows and meters checklist against Pro Tools 2026.4.1