Skip to content

Add Office Hotkeys plugin#693

Open
pjleduc wants to merge 3 commits into
fatihak:mainfrom
pjleduc:add-office-hotkeys-plugin
Open

Add Office Hotkeys plugin#693
pjleduc wants to merge 3 commits into
fatihak:mainfrom
pjleduc:add-office-hotkeys-plugin

Conversation

@pjleduc
Copy link
Copy Markdown

@pjleduc pjleduc commented May 21, 2026

Office Hotkeys plugin

A new plugin that displays a keyboard-shortcut cheat sheet for Microsoft Excel, Outlook, and PowerPoint — a glanceable, rotating reference for the e-ink display.

What it does

  • Per-instance settings: App (Excel / Outlook / PowerPoint) and Skill level (Beginner / Intermediate / Advanced).
  • Each refresh shows one themed category of shortcuts (Navigation, Formatting, Formulas & Functions, …), rotating hourly so the display stays fresh.
  • Skill level is a difficulty floor — it shows shortcuts at your level and harder, topping up with the next level down only when a category is thin, so an Advanced screen stays advanced-first and never shows trivial shortcuts.
  • Weighted-random selection picks a highlighted "top move" plus a list of shortcuts; content reshuffles each refresh.
  • Bundled, curated Windows-shortcut dataset (data/shortcuts.json) — no external API or network access required.

Implementation

  • Follows docs/building_plugins.md: OfficeHotkeys(BasePlugin) with generate_image / generate_settings_template, render/ HTML + CSS via render_image, plus settings.html, icon.png, and plugin-info.json.
  • The selection logic (selection.py, constants.py) is pure and stdlib-only, kept separate from rendering, with pytest unit tests in tests/.
  • Designed for the 6-colour Spectra e-ink palette — flat, high-contrast.

Testing

  • Unit tests cover category rotation, the skill-level floor + top-up, and weighted selection.
  • Verified on hardware — Raspberry Pi Zero 2 W with an Inky Impression 7.3" (800×480) — rendering correctly for all three apps across skill levels.

🤖 Generated with Claude Code

pjleduc and others added 3 commits May 21, 2026 14:10
A plugin that displays a rotating keyboard-shortcut cheat sheet for
Excel, Outlook, and PowerPoint, with a per-instance app and skill-level
filter. Pure selection logic with unit tests; renders via HTML/CSS.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Switch the shortcut list from a 2-column grid to a single column with
much larger text, showing 6 items instead of 8. The 2-column layout
packed in more shortcuts but the text was too small to read on the
e-ink panel.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Reduce to one hero plus 4 list items so each line can be considerably
larger, improving readability on the e-ink panel.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant