osfeed.dev
Projects/ForrestKnight / omarchy-key-promoter

Omarchy Key Promoter

Keyboard shortcut reminders for the Omarchy menu

Get it on GitHub
Unclaimed

This page was written by @iluxav from public sources, last updated , and may lag behind new releases.

Are you @ForrestKnight?Claim this page to keep it up to date
Updated 4 things you can do
Follow GitHub

Learn your configured keyboard shortcuts from reminders after using the Omarchy menu.

What you can do with Omarchy Key Promoter

Learn your configured shortcuts when you launch apps, open shell panels or run detectable scripts from the Omarchy menu.

Since commit ecbfcc5
Good to know

Requires a matching binding and detection shortly after the menu closes. Bar clicks, workspace switches and actions that finish before detection are not covered. XF86 media keys are excluded.

Choose where shortcut reminders appear, how long they stay and whether they show repeat counts.

Since commit ecbfcc5
Good to know

Settings are edited in the plugin entry in `~/.config/omarchy/shell.json`.

Inspect matchable shortcuts and saved reminder counts as JSON.

Since commit ecbfcc5
Good to know

Counts record shortcut promotions, not keyboard usage, and persist in `~/.local/state/omarchy/key-promoter.json`.

Preview and hide a shortcut reminder with your chosen key combination and description.

Since commit ecbfcc5
Good to know

Requires the enabled plugin and `omarchy-shell`.

Omarchy Key Promoter release history 1
commit ecbfcc5
First release

Learn your own keyboard shortcuts from reminders after using the Omarchy menu.

Details

Menu-triggered app and web-app launches, shell layers and detectable `omarchy-*` scripts can show the matching shortcut from your bindings. Settings in `shell.json` control six positions, display duration, detection window and counts; `omarchy-shell key-promoter` provides preview, reload and JSON inspection commands.

Also: Choose reminder placement and timing, inspect matching bindings, and view saved reminder counts.

Available from the repository through `omarchy plugin add`; no tagged release. Requires Omarchy shell/plugin support and the documented stock tools: `omarchy-menu-keybindings`, `hyprctl`, `jq`, `ps`.

Added: Learn your configured shortcuts when you launch app…Added: Choose where shortcut reminders appear, how long th…Added: Inspect matchable shortcuts and saved reminder coun…Added: Preview and hide a shortcut reminder with your chos…

Seeded by @iluxav with Codex

Read the evidence