Skip to content

Keyboard shortcuts: match PowerPoint's Windows and Mac lists - #325

Open
n0mahd wants to merge 2 commits into
storytold:mainfrom
n0mahd:keyboard-shortcut-parity
Open

n0mahd wants to merge 2 commits into
storytold:mainfrom
n0mahd:keyboard-shortcut-parity

Conversation

@n0mahd

@n0mahd n0mahd commented Oct 13, 2026 •

Copy link
Copy Markdown

Summary

This PR checks DeckCraft's default shortcuts against Microsoft's published lists: "Keyboard shortcuts in PowerPoint" (the Windows and Mac tables) and "Use keyboard shortcuts to deliver PowerPoint presentations". It binds every listed shortcut that already has a feature to run.

  • Coverage: before this PR, 68 of the 192 listed shortcuts worked. After it, 150 work and 3 are partial.
    • Windows: 36 → 71 of 87.
    • Mac: 22 → 59 of 70.
    • Slide show: 10 → 20 of 35.
  • Where it is documented: the full audit table is in docs/ui-parity.md#shortcut-audit.
  • Platform keys: when the Windows and Mac keys collide, DeckCraft uses the keys of the platform it runs on. A new field, Session::mac_keys, records that platform. Mac Cmd+Control shortcuts get a new Mods::control flag.
  • Bug fix: registry shortcuts on punctuation keys never fired from the keyboard. egui calls the key CloseBracket while the registry says ]. Bring Forward, the font size keys, superscript and Next Window were affected.
    • keys::key_token now normalises the key name.
    • The UI maps shifted symbols back to the key they are typed on, so { matches Ctrl+Shift+[.
  • Paths: the UI, the control channel (ui.key) and MCP all reach the same key path. ui.key now handles UI shortcuts first, the same way the keyboard does.

Added

Slides and files

  • Ctrl+M new slide (Windows only; on the Mac, Cmd+M stays Minimize).
  • Ctrl/Cmd+Shift+D duplicates the slide.
  • Ctrl/Cmd+Up and Down move the slide one place. With Shift they move it to the start or end.
  • Ctrl+Q quits (Windows). It asks about unsaved changes first.

Objects

  • Windows: Ctrl+G, Ctrl+Shift+G and Ctrl+Shift+J group, ungroup and regroup.
  • Mac: Cmd+Shift+F and B, and Cmd+Option+Shift+F and B, change the order.
  • Mac: Cmd+Option+Shift+C and V are the Animation Painter.
  • Alt/Option+Left and Right rotate by 15°.
  • Ctrl/Cmd+arrows nudge by 1 pt. Shift+arrows resize.
  • Ctrl+Alt+5 selects the first object (not while you are editing text).
  • Space (Mac) and Ctrl+Space (Windows) play or pause the selected media.

Formatting

  • Windows: Ctrl+= is Subscript, as PowerPoint has it, instead of Zoom In. Ctrl+Plus still zooms.
  • Mac: Cmd+= zooms. Cmd+Control+= is Subscript and Cmd+Control+Shift+= is Superscript.
  • Windows: Ctrl+Shift+Z clears character formatting. On the Mac, Cmd+Shift+Z stays Redo.

Text editing

  • Windows: Ctrl+arrows move by word or paragraph. Ctrl+Home and End go to the start or end of the text. Ctrl+Backspace and Ctrl+Delete delete a word.
  • Mac: Cmd+Left and Right go to the line's start or end. Cmd+Up and Down go to the start or end of the text. Cmd+Delete deletes a word.
  • Windows: Ctrl+Enter goes to the next title or body placeholder. After the last one it adds a new slide.
  • Windows Alt+Shift+Left and Right, and Mac Cmd+[ and ], promote and demote a paragraph.
  • Ctrl+Tab (Windows) and Option+Shift+Tab (Mac) type a tab in a table cell.

Views, panes and dialogs

  • Panes and views:
    • F6 and Shift+F6 cycle the slide, the notes and the thumbnails. The thumbnails get a focus ring, and the arrows change slides there.
    • Ctrl+Shift+Tab switches between the thumbnails and the outline.
    • Mac: Cmd+1 to 4 switch views, and Cmd+Option+1 opens the Slide Master.
    • Ctrl+Alt+O fits the slide to the window. Mac Cmd+Shift+O shows recent presentations.
  • Showing panes: Alt+F10 shows the Selection pane. Mac Cmd+Shift+1 shows the Format pane and Cmd+Shift+2 Format Background.
  • Guides: Mac Cmd+Option+Control+G shows or hides them.
  • Presenter View: Alt+F5 and Option+Return start it.
  • Dialogs:
    • Ctrl+Alt+M and Mac Cmd+Shift+M open the New Comment dialog. Before this, the key ran a command that failed.
    • F7 opens the Spelling dialog.
    • Alt+= opens the Equation dialog, which is still a placeholder.
    • Mac Cmd+Option+M opens the Paragraph dialog.

Slide show

  • H shows the next slide when it is hidden.
  • Mac Cmd+. ends the show. A plain . still blanks the screen.
  • The pointer:
    • Ctrl+H, and Cmd+I or Control+H on the Mac, hide it.
    • Ctrl/Cmd+A shows it.
    • Cmd+U lets it hide again when idle.
  • Media:
    • Alt+P and Ctrl+Space play or pause.
    • Alt+Q stops.
    • Alt+Shift+Page Down and Page Up seek ±3 s.
    • Alt+Shift+Right and Left seek ±0.25 s and pause.

Engine changes that support the keys

  • text.move has a new target, paraNext. paraStart at the start of a paragraph now goes to the previous one, as Ctrl+Up does.
  • shape.resize accepts relative dw and dh, clamped.
  • Mods gains control. The MCP and control-channel mods take control?.

Not changed on purpose

  • Ctrl+Shift+[ and ] (Windows): they keep Send to Back and Bring to Front. Microsoft's table says they move one step, but DeckCraft's Ctrl+[ and ] already do that.
  • Cmd+Shift+P (Mac Template Gallery): it stays the command palette.
  • Cmd+F and Ctrl+F: they still open command search, because there is no find in slides yet.
  • AltGr: winit already strips Ctrl+Alt from AltGr. For a backend that reports AltGr as Ctrl+Alt, a Ctrl+Alt key followed by typed text is treated as text, not as a shortcut.

Still missing, by the feature each one waits for

  • Find and Replace: Ctrl/Cmd+F, Ctrl+H, Cmd+Shift+H, Shift+F4.
  • Font dialog: Ctrl+T, Ctrl+Shift+F, Cmd+T.
  • Print: Ctrl/Cmd+P.
  • Paste Special dialog: Ctrl+Alt+V, Cmd+Control+V.
  • Ribbon KeyTips (Alt / F10) and a keyboard context menu (Shift+F10).
  • Help: F1.
  • Copilot: Shift+F8.
  • Thesaurus.
  • Outline view: levels, expand and collapse (Alt+Shift+1 / + / -). Moving paragraphs (Alt+Shift+Up and Down).
  • Masters and full screen: handout and notes masters (Cmd+Option+2 and 3), full-screen editing (Cmd+Control+F), drawing mode (Cmd+Control+Z).
  • Template gallery: Cmd+Shift+P, which DeckCraft uses for the command palette.
  • During the show:
    • Ink: laser, eraser and the ink toggle (Ctrl+L, Ctrl+E, Ctrl+M) are in open PR Slide show ink: pen, highlighter, eraser, laser, keep-on-exit, ink select tool #161.
    • All Slides (Ctrl+S), the taskbar (Ctrl+T), the show menu (Shift+F10), help (F1) and hotspots (Tab).
    • Media: volume and mute (Alt+Up, Alt+Down, Alt+U), bookmarks (Alt+Home and End), captions (Alt+J), cameo (Alt+X).
    • Rehearsal keys (T, O, M, R) and the Presenter View region keys.

Overlap with open PRs

Contributors

Adds my own [people.n0mahd] entry to contributors/people.toml (sync_github_name = true).

Test plan

Run on Linux aarch64.

  • cargo xtask ci: fmt, clippy, tests, assets, layers and wasm.
  • The engine tests drive Session::key. They cover the punctuation key names, the platform tables, nudging, rotating and resizing, text keys on each platform, paragraph levels, moving slides, Ctrl+Enter, and Space on media.
  • The UI tests (kittest) send real egui key events through SlideApp::keyboard, then menus::ui_shortcut, then Session::key. They cover the Windows keys, including the AltGr guard and Ctrl+= as Subscript, the Mac keys, and F6 pane cycling.
  • The slide-show test covers H with a hidden slide, hiding and showing the pointer, . versus Cmd+..
  • Not checked: a manual pass on a physical Mac and on Windows with an AltGr keyboard layout.

🤖 Generated with Claude Code

n0mahd and others added 2 commits October 12, 2026 20:24
Audit DeckCraft's default keys against Microsoft's published PowerPoint
shortcut lists (editing and slide show, Windows and Mac): 150 of 192 now
work, up from 68. Where the platforms disagree, Session::mac_keys picks
the one DeckCraft runs on; Mods gains `control` for Mac Cmd+Control keys.

- Punctuation shortcuts now fire from the keyboard (egui's CloseBracket,
  Period, Equals… match the registry's ], ., =), and shifted symbols map
  back to their key.
- Slides, objects, text editing, views, panes and dialogs: Ctrl+M,
  Ctrl+Shift+D, Ctrl+G, rotate and resize keys, word/paragraph moves,
  Ctrl+Enter, promote/demote, slide move, Alt+F5, F6 pane cycling,
  Ctrl+Shift+Tab, Cmd+1-4, New Comment, Spelling, Equation, Paragraph.
- Ctrl+= is Subscript on Windows (Ctrl+Plus zooms); Cmd+Control+= on Mac.
- Show: H, Cmd+., pointer hide/show, media play/stop/seek keys.
- ui.key on the control channel goes through the UI shortcuts first.
- Docs: shortcut audit in ui-parity.md, slideshow-parity, gaps,
  control-protocol, ROADMAP progress log.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@n0mahd
n0mahd force-pushed the keyboard-shortcut-parity branch from 95341df to 8d96333 Compare October 13, 2026 00:34
anishguduru pushed a commit to anishguduru/deckcraft that referenced this pull request Oct 16, 2026
…d recovery beside pdfcraft.exe (storytold#325)

* Issue storytold#157: the Windows portable zip keeps settings, logs and recovery beside pdfcraft.exe

The portable zip had no portable.txt, and the app had no portable mode: it always wrote %APPDATA%\PdfCraft and %LOCALAPPDATA%\PdfCraft. Now portable.txt (or PdfCraft.portable) beside the executable puts the settings, log files, crash recovery and new digital IDs in PdfCraftData next to it, as PhotoCraft does, and the zip ships portable.txt. An unwritable PdfCraftData falls back to the per-user folders and says so.

* Issue storytold#157: update ATTRIBUTION.toml SHA-256 for the translation catalogs this PR changes

---------

Co-authored-by: Brandon Thomas <echelon@gmail.com>

@FredApps FredApps left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ReviewerA — source-read COMMENT (not an approval)

I read the head of the diff: keyboard shortcuts match PowerPoint's Windows and Mac lists; the ROADMAP says 150 of 192 shortcuts work (68 before) and adds F6 pane cycling and platform-specific keys, and contributors/people.toml gains the author's entry. Matching the platform's documented shortcuts is the right oracle (they are facts, not code). The risk is conflicts: two commands on one key, shortcuts that collide with the operating system or with text-field editing (Ctrl+B in a text box against bold on a shape), so a test that all bindings are unique per platform and context is the proof. The ROADMAP header and the figure are hand-edited, which is the maintainers' tooling's job. I read the ROADMAP and the first engine hunk. I have not run it, and no exact-head CI result exists for this head. Nothing was run.

I ran nothing and have no exact-head CI result for this PR, so this is not an approval. Where a diff was long I read its code hunks rather than every generated or documentation line.

Status: waiting_author.

@aiongg aiongg added missing feature The reference application has it and we do not, or only part of it needs decision Needs a product or scope decision by a maintainer labels Nov 4, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

missing feature The reference application has it and we do not, or only part of it needs decision Needs a product or scope decision by a maintainer

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants