Ocideck/docs/SHORTCUTS.md
Brenno de Winter b719c43991 Add presentation timer / rehearsal mode to the presenter
The presenter view now doubles as a rehearsal clock that measures without
coaching: a countdown against a target time, the time spent on the current
slide, and an end-of-run summary (total vs. target and per-slide times, with
copy-to-clipboard). Timing lives in a plain, unit-tested RehearsalController fed
via an idempotent observe() on every build, so it captures every navigation
path. The default target is stored in AppSettings; live adjustment is the K key
(typed as MMSS). All rehearsal state is session-only -- nothing is written to
disk or into the .md file.

- New: models/rehearsal.dart, services/rehearsal_controller.dart,
  widgets/presentation/rehearsal_summary.dart, plus a controller unit test.
- Presenter: countdown + per-slide timer in the clock bar, K to set the target,
  R resets the run, end-of-run summary dialog, and help/cheatsheet entries.
- Settings: presentationTargetSeconds (default target) with a dropdown in the
  General tab, threaded into FullscreenPresenter.present().
- l10n: new Dutch source strings translated in all seven languages.
- Docs: README, CHANGELOG, USER_GUIDE, SHORTCUTS, ARCHITECTURE.

Also bundles a pre-existing in-progress change already in the working tree: wire
the existing ThemeProfile.tableHeaderBackgroundColor into table rendering
(preview, HTML export, file_service) and the settings dialog, plus its
translations.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-13 07:03:08 +02:00

2.1 KiB

OciDeck — Keyboard shortcuts

Ctrl is shown for Windows/Linux; use Cmd (⌘) on macOS.

Editor (app-wide)

Shortcut Action
Ctrl/Cmd + O Open a presentation
Ctrl/Cmd + S Save the active deck
Ctrl/Cmd + Z Undo
Ctrl/Cmd + Shift + Z Redo
Ctrl + Y Redo (alternative)
Ctrl/Cmd + H Find & replace
Ctrl/Cmd + V (in a table cell) Paste a spreadsheet/CSV/markdown selection as a table (also Shift + Insert)
Tab to the panel divider, then / Resize the slide panel

In the add-slide dialog, Tab moves between the type cards, Enter picks the focused one, and Esc cancels.

Fullscreen presenter

Navigation:

Shortcut Action
· Space · Page Down · click Next slide
· Page Up Previous slide
Enter Next slide (or jump, if a number was typed)
digits, then Enter Jump to that slide number
Home · End First · last slide
G Slide-grid overview (arrows + Enter to jump)

View & timing:

Shortcut Action
P Toggle presenter view (notes, clock, countdown, per-slide timer, next slide)
S Move the presentation to another screen
B · W Black · white screen
K Set the target time / countdown (type MMSS, Enter to confirm, 0 = off)
R Reset the time & rehearsal run (elapsed and per-slide timings; the target stays)
A Auto-advance on/off
L Loop (restart after the last slide) on/off
M Advance automatically after a slide's audio finishes
H · ? Show the in-app shortcut cheatsheet

Annotation tools:

Shortcut Action
D Pen
T Highlighter
E Eraser
X Laser pointer
C Clear the current slide's annotations

Esc is layered: it first puts away the active annotation tool, then clears a typed slide number, then removes a black/white screen, and finally exits the presentation.

In dual-screen mode the keyboard stays with the laptop (presenter) window; clicks on the beamer also advance the slide.