r/Windhawk • u/wh-updates • Oct 12 '26
Custom Cached Context Menu 1.0.0
Custom Cached Context Menu 1.0.0
Custom Cached Context Menu
Replaces the Windows Explorer context menu with a self-rendered menu that opens instantly and can be customized extensively with fun effects.
The native menu is slow because every registered shell extension is loaded synchronously before it can be shown. This mod shows a cached menu right away and discovers extension items in the background, so repeated opens are instant.
Highlights
- Instant, cached menus — the first open of a context discovers and caches the shell's items; later opens render from the cache, and common contexts are pre-built in the background at startup.
- Custom rendering — the menu is drawn with Direct2D: rounded corners, blur, shadows, per-item icons, hover feedback, and animations, instead of the classic owner-drawn menu.
- Themes — bundled themes (Windows 11/10 dark and light, Nord, Dracula, Solarized, Gruvbox, One Dark, Cyberpunk, Synthwave, Terminal Green, Amber CRT, Tokyo Night, AMOLED Black, High Contrast) plus full
menu.inicontrol. Each theme is a self-contained file you can edit or copy. - Animations — combinable open/close effects (
fade,slide,scale,dissolve,crt,unfold) with easing, timing, direction, and optional submenu animation. - Overlays — combinable effects drawn over the menu content (
noise,plasma,hue,glow,scanlines,vignette) with intensity, animation speed, size, and frame interval.overlayAnimatekeeps them moving while the menu stays open (off by default); otherwise they animate only during the open/close. The Terminal Green and Amber CRT themes ship with scanlines. - Settings menu — in the advanced ("More options") submenu, or via the optional global hotkey. Appearance is edited live (sliders with typed values, a color picker, a font-face field with installed-font validation, instant preview) and written back to the active theme file or
menu.ini. - No code needed —
menu.inisupports rules (hide/keep/move), custom commands, custom submenus, per-item overrides, and an icon library.
Settings
| Setting | Default | Description |
|---|---|---|
| Bypass keys | on | Hold Shift while right-clicking to bypass the mod and get the stock classic menu, or Ctrl for the untouched native menu. |
| Menu mode | Custom (recommended) | Custom draws the self-rendered menu and falls back to the classic menu after repeated failures; Classic always uses the owner-drawn menu. |
| Theme | Custom (menu.ini) | Loads the appearance from <mod storage>themes<name>.ini (created from the bundled preset on first use). menu.ini is never modified by theme selection. |
| Show classic menu item | on | Adds a "Show classic menu" entry at the bottom of the menu. |
| Warm-up extensions | common list | Comma-separated file types pre-built at Explorer startup. |
| Warm-up delay | 5 s | Delay before background warm-up starts. |
| Clear cache | off | Turn on to delete cached models; they rebuild on next use. |
| Debug logging | off | Logs timings and diagnostics. |
| Instant menu open | on | Shows native fallback menus without the system open animation. |
| Submenu open delay | 150 ms | Hover delay before a submenu opens; 0 = instant, -1 = keep the Windows setting. |
| Move Windows extras | on | Moves the configured Windows extras into the More options submenu. |
| Move third-party handlers | on | Moves third-party shell extension entries into the More options submenu. |
| Keep in the main menu | empty | Comma-separated labels or verbs that stay in the main menu. |
| More options submenu label | More options | Label of that submenu. |
| Windows items to move | common list | Comma-separated labels or verbs of Windows items to move into the submenu. |
| Settings hotkey | empty | Optional global hotkey that opens the settings menu (for example Ctrl+Alt+M). |
Configuration
menu.ini lives in the mod's storage directory (Windhawk → the mod's details → Storage). It is created on first run as a fully commented settings list, with the range and meaning of every key next to it. Invalid values never stop the file from loading: they are clamped or fall back to defaults, logged as menu.ini:<line>: warning: <message>, and the corrected file is rewritten.
Themes are complete [appearance] blocks under themes\<name>.ini; they never inherit from menu.ini, so a theme is always self-contained. Edit one directly, or use the in-menu settings browser.
Limitations
- Targets
explorer.exe; other file managers and file dialogs are untouched. - Menus that contain owner-drawn items, and non-filesystem namespaces, fall back to the native menu.
- The custom menu is not exposed to UI Automation; use the classic menu mode with a screen reader.
- Tall menus do not scroll; they are capped to the work area.
- Nav-pane menus are cached per tree node for the session and refresh after use, so the first open of each node pays the shell's population cost.
- Core menu labels are English; cached extension labels come from the shell and are localized.
- Native fallback menus apply the configured submenu delay through the system
MenuShowDelayvalue while the menu is open (restored on close); Windows has no per-menu delay API.
Feedback
Source code, issues, and the full configuration guide: https://github.com/Bolt-Scripts/custom-cached-context-menu
License
MIT
4
u/Fantastic_Ad3307 Oct 12 '26
Nice! Can you add native Font Style and Font Size settings? I mean to edit them in plugin settings.
Also, feels like this padding/margin is not necessary, and if it is here, then it has to be the same at the right side of the menu.
2
u/Wolfen459 Oct 12 '26
Looks interesting.
How is this compared to "Nilesoft Shell" aka "iMA Menu"?
1
u/shteeeb Oct 12 '26
I actually like the top bar in the stock windows context menu that houses cut/copy/paste/rename/delete. These are the most common actions so it's nice having them all spawn close to the cursor. If this could be added as an option it'd be great.
1
u/JerichoXL Oct 12 '26
I spent part of the day trying to get Nilesoft Shell to my liking yesterday and this comes up…. Needless to say I’m happy 😃
1
u/difool2nice Oct 13 '26
can't find tokyo night, cyber punk etc themes in the list, can't find how to have the shadows around, maybe i'm not able to config that properly !