Files
filmcraft/docs/keyboard.md
T
aiongg 0a881266c8 CI: xtask ci in the dev profile, one test binary per crate, nextest (#2860)
* Tests: one integration-test binary per crate

Each crate with several tests/*.rs files keeps them as modules of tests/it/,
so cargo links one test executable per crate instead of one per file. Files
that change process-wide state or time a workload stay binaries of their own.

* Profiles: line tables for workspace crates, no debug info for dependencies

* Windows ARM64: nightly and on release pushes instead of every push to main

* xtask ci: clippy and tests in the dev profile

The release profile's thin LTO and single codegen unit made linking the test
binaries take most of the gate. The codec and audio crates stay at opt-level 3
in the dev profile, so their tests run at release speed.

* xtask ci: nextest, doctests, no examples, one wasm check

Tests run with cargo nextest when it is installed (cargo test otherwise) and
build with --lib --bins --tests, so examples aren't linked; doctests run
separately. The wasm check keeps going past the first failing crate. VP8
fixture generation locks across processes, since nextest runs each test in
its own.

* VP9 synthetic fixtures: write aside and rename

A test in another process could read a fixture ffmpeg was still writing.

* Fuzz tests: a third of each sweep by default, all of it with FILMCRAFT_FUZZ_ITERS

Every seed, mutation kind and thread count still runs. Header bytes each get
one overwrite value and two bit flips in rotation, so every value and bit
index still occurs across the region. FILMCRAFT_FUZZ_ITERS=N runs the whole
sweep plus N random rounds per seed, as before.

* Platform fallback tests: one failure point per hybrid path

The failure-anywhere test injected a failure at four points around every
restart point; the hybrid's paths differ only in the first GOP, around the
second and last restart points, at the end and never. The replay test needs
the first two GOPs.

* Export tests: shorter ranges with the same checks

The bitrate test measures 0.5–1.5 s, where each preset reaches its own
target (on 0–3 s the simple demo left two presets at the same rate). The
every-preset test exports three frames per preset.

* Audio tests: effects in parallel, a table-driven FFT for the Opus quality metric

The extreme-settings test keeps both settings and the 40 s tail for every
effect, one thread each. The Opus quality metric's FFT builds its twiddles
once and allocates nothing per transform (same algorithm and summation order).

* CI: dev-profile gate with nextest

xtask ci no longer builds with --release, so the release-profile overrides
go; nextest is installed for the test step.

* CI: apt packages through the cached install-apt-packages action

* Review fixes: fuzz tests with a panic hook in their own binaries, loud fixture lock

The fuzz tests of av1, h264, hevc, mpeg2v, vp8 and vp9 count panics through
a process-wide hook, so a panic in another test of the same process would
fail them; they are binaries of their own again. The VP8 fixture lock fails
the test instead of skipping it silently, and the full-sweep doc comments say
how many truncation points the full run samples.

* Fuzz tests: rotate the default subset per run (FILMCRAFT_FUZZ_SEED replays one)

* platform tests: decode-switch tests in their own binaries, one NVENC lock
2026-10-23 13:34:16 -04:00

7.0 KiB
Raw Blame History

Keyboard parity with Premiere Pro

FilmCraft's Premiere Pro Compatible shortcut preset (Edit ▸ Keyboard Shortcuts…) follows Premiere's default keyboard (macOS). The table lives in crates/engine/src/shortcut_presets.rs: PREMIERE (application-wide keys and a few panel keys) and PREMIERE_PANEL (panel-scoped keys that FilmCraft Default uses as well). presets::premiere() is the whole preset.

Every entry names a FilmCraft command id. Engine commands run through Session::execute; UI commands (frames, panels, monitor zoom, Project and Text panel navigation) run through menus::invoke. Both are reachable by id from the CLI (filmcraft-cli exec <id>), the control channel (engine.execute / ui.menu.invoke) and MCP (command_run).

Tests: crates/engine/src/keyboard_tests.rs (no key used twice in one scope; behaviour of the keyboard commands, with undo) and crates/ui-egui/tests/it/keyboard_ui.rs (no dangling ids in the tables, no conflicts in FilmCraft Default or the Premiere preset, keys pressed in the headless app).

Keyboard-only commands (M3.12)

Premiere has these as keys only (most are not in a menu). Modules: filmcraft_engine::keyboard (engine) and filmcraft_ui_egui::panels::keyboard (UI); their module docs list each id.

Group Commands Keys
Navigation Go to Next/Previous Edit Point (targeted tracks), …on Any Track, Go to Selected Clip Start/End, Reveal Nested Sequence Down/Up, Shift+Down/Up, Shift+Home/End, Cmd+Alt+F
Selection Select Clip at Playhead, Select Next/Previous Clip, Select Find Box, Open Search D, Cmd+Down/Up, Shift+F, Cmd+Shift+F
Trimming Extend Previous/Next Edit To Playhead; Nudge Clip Selection Left/Right One/Five Frames, Up/Down; Slip and Slide Clip Selection Left/Right One/Five Frames Shift+Q/W; Cmd+(Shift+)Left/Right, Alt+Up/Down; Cmd+Alt+(Shift+)Left/Right; Alt+(Shift+), / . (Timeline)
Targeting Toggle All Video/Audio Targets, Toggle All Source Video/Audio; Toggle Target Video/Audio 1–8, Move All Video/Audio Targets Up/Down, Toggle Mute/Solo for targeted audio, Toggle Track Output for targeted video (unbound, as in Premiere) Cmd+0/9, Cmd+Alt+0/9
Tracks Expand/Minimize All Tracks (again restores), Increase/Decrease Video/Audio Tracks Height, Show Next/Previous Screen Shift+= / Shift+-, Cmd+= / Cmd+- / Alt+= / Alt+-, PageDown/PageUp (Timeline)
Monitors Zoom Program/Source Monitor to 100%/Fit, Toggle Full Screen, Play In to Out with Preroll/Postroll, Play from Playhead to Out Point, Export Frame, Set/Clear Poster Frame Cmd+Shift+1/0, Cmd+Alt+Shift+1/0, Ctrl+`, Shift+Space, Ctrl+Space, Shift+E, Cmd+P / Alt+P
Panels Maximize or Restore Active Frame / Frame Under Cursor, Select Next/Previous Panel, Toggle Source/Program Monitor Focus, Workspaces 7–9 Shift+, , Ctrl+Shift+. / ,, Alt+Shift+7/8/9
Audio Increase/Decrease Clip Volume (1 dB) and …Many (Settings ▸ Audio ▸ Large Volume Adjustment), Nudge Volume ±1/±3 dB, Toggle Audio During Scrubbing ] / [, Shift+] / Shift+[, Shift+S
Graphics Increase/Decrease Font Size and Leading by One/Five Units, Left/Center/Right align text, Begin Text Editing, Nudge Selected Object by one/five (graphic layers, else Motion position) Cmd+Alt+(Shift+)Left/Right, Alt+(Shift+)Up/Down, Cmd+Shift+L/C/R, Cmd+Alt+', Cmd+(Shift+)arrows (Program, Properties)
Project panel List/Icon/Toggle View, Hover Scrub, Thumbnail Size Next/Previous (and = / -), Move/Extend Selection, Mark In / Out of the hover-scrubbed clip Cmd+PageUp/PageDown, Shift+, Shift+H, Shift+] / Shift+[, arrows, Home/End, PageUp/PageDown, I / O
Text panel Navigate/Select to Previous/Next Word and Line, Start/End of Segment, Delete (lift), Ripple Delete (extract), Show Program Transcript, Merge/Split Segments arrows, Shift+arrows, Home/End, Shift+Home, Cmd+Shift+Down, Alt+Backspace, Backspace, Shift+X, Alt+M / Alt+S
Other Help (F1), Quit (Cmd+Q), Media Browser ▸ Open In Source Monitor (imports the file first), Send to Media Encoder (= Send to Export Queue, Alt+Shift+M), Metadata panel Play/Loop

Existing commands that only lacked their Premiere key were added to the table too (Close, Close Project, Import from Media Browser, Get Media File Properties, Paste Attributes, Find, Edit Original, Make Subclip, Audio Channels, the Graphics New Layer / Arrange / Select Layer commands, Program monitor Show Rulers / Show Guides / Snap / Lock Guides, New Bin From Selection, Paste and Paste Insert in the Timeline, the Audio Track Mixer Loop).

FilmCraft Default keeps its own keys where they differ (Shift+E is Clip ▸ Enable there, so Export Frame has no default key; the Premiere preset moves Shift+E to Export Frame and Enable to ⇧⌘E).

Skipped Premiere default shortcuts

Premiere command (key, scope) Reason
Generative Media Tool (⇧V) Adobe Firefly cloud generation; not part of FilmCraft.
Add to object / Subtract from object (⌘= / ⌘-) Refine an AI object mask (Object Mask tool); FilmCraft has no AI object masks.
Change Draw Mode (⌥⌘L) Premiere's shape draw modes for the Pen/shape tools; FilmCraft's shape tools have no draw modes.
Production panel: New Project, New Folder, Close Project, Make a Copy, Move Selection Home/End/Page Up/Page Down, Move To Trash, Open Project, Zoom In/Out (12 keys) Productions (shared multi-project folders) are not implemented; there is no Production panel.
Search panel: Open in Source Monitor (⇧O) No separate Search panel; Open Search (⇧⌘F) focuses the Project panel search.
Audio Track Mixer: Show/Hide Tracks… (⌥⌘T), Meter Input(s) Only (⌃⇧I) The mixer has no track visibility dialog and no input metering (no hardware input recording).
Effect Controls: Remove Selected Effect (Delete), Loop During Audio-Only Playback (⌘L) Effect Controls has no effect selection state and no audio-only playback mode; effects are removed from their context menu or effects.remove.
Effects panel: New Custom Bin (⌘/), Delete Custom Item (Delete) The Effects panel has no custom bins (effect presets live in the Presets bin).
History panel: Delete (Delete) History states cannot be selected and deleted individually.
Media Browser: Select Directory List / Select Media List (⇧← / ⇧→) The directory tree and media list take no separate keyboard focus.
Project panel: Delete Selection with Options (⌘Delete) Needs the "delete instances in sequences" dialog; plain Clear (Backspace) deletes.
Project panel: Next/Previous Column Field, Next/Previous Row Field (Tab, ⇧Tab, Return, ⇧Return) The list view has no inline-editable metadata cells.
Text panel: Edit Segment (Return) No inline transcript text editing (corrections go through transcript.set).
Text panel: Follow Active Monitor (⇧C), Show Source Transcript (⇧Z) Only sequence transcripts exist; source clips have no transcript view.
Timeline: Set Work Area Bar In/Out Point (⌥[ / ⌥]) FilmCraft has no work area bar (Premiere hides it by default; renders use In/Out).