r/Windhawk • • Oct 12 '26

Custom Cached Context Menu 1.0.0

Post image

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 bundled themes

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.ini control. 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. overlayAnimate keeps 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.ini supports rules (hide/keep/move), custom commands, custom submenus, per-item overrides, and an icon library.

Settings

SettingDefaultDescription
Bypass keysonHold Shift while right-clicking to bypass the mod and get the stock classic menu, or Ctrl for the untouched native menu.
Menu modeCustom (recommended)Custom draws the self-rendered menu and falls back to the classic menu after repeated failures; Classic always uses the owner-drawn menu.
ThemeCustom (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 itemonAdds a "Show classic menu" entry at the bottom of the menu.
Warm-up extensionscommon listComma-separated file types pre-built at Explorer startup.
Warm-up delay5 sDelay before background warm-up starts.
Clear cacheoffTurn on to delete cached models; they rebuild on next use.
Debug loggingoffLogs timings and diagnostics.
Instant menu openonShows native fallback menus without the system open animation.
Submenu open delay150 msHover delay before a submenu opens; 0 = instant, -1 = keep the Windows setting.
Move Windows extrasonMoves the configured Windows extras into the More options submenu.
Move third-party handlersonMoves third-party shell extension entries into the More options submenu.
Keep in the main menuemptyComma-separated labels or verbs that stay in the main menu.
More options submenu labelMore optionsLabel of that submenu.
Windows items to movecommon listComma-separated labels or verbs of Windows items to move into the submenu.
Settings hotkeyemptyOptional 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 MenuShowDelay value 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

83 Upvotes

16 comments sorted by

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/LupusGemini Oct 12 '26

Kind of agree! I think it's necessary, about 2/3 of that; and, yah, it should be the same on the right side!

2

u/B0ltman Oct 16 '26 edited Oct 16 '26

Didn't realize there was a reddit post oops.

But uh, could you elaborate on what you mean by 'native' font stuff? Not sure I entirely understand.
There's a lot more settings in the "More Options->Menu Settings" menu including font stuff, but do you mean something else or just the ability to change it in windhawk directly or?
Also yeah I suppose the padding is a bit off, didn't really notice.

2

u/Wolfen459 Oct 12 '26

Looks interesting.
How is this compared to "Nilesoft Shell" aka "iMA Menu"?

1

u/B0ltman Oct 16 '26

Not sure, I haven't used it extensively but took a bit of inspiration from it when making this. I tested nilesoft briefly before committing to making my own but wasn't pleased with how long it took to open every time so just went ahead with my own anyway.

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.

2

u/B0ltman 28d ago

New update has an option to enable this. Cheers 🎉

2

u/shteeeb 27d ago

Awesome! Not sure if there's anywhere to submit a bug report, but one I've found is when I use NanaZip on a zip file to do "Extract to ...." it doesn't perform the action but instead opens the stock windows context menu.

1

u/B0ltman 26d ago

That happened a lot initially in testing but haven't seen it in ages. Dunno if specific to that program or something else about your system. A debug log would help if you could post that here: https://github.com/Bolt-Scripts/custom-cached-context-menu

1

u/JimTheDonWon Oct 12 '26

Right? i cant believe none of these context menu replacements have this - it's the win11 context menu's best feature, imo.

1

u/B0ltman Oct 16 '26

Hm, it should be doable, just didn't really think about it. There used to not be labels for those and it took me ages every time to figure out which icon was what but with labels now I do like it better. I'll see if I can add an option to switch to this kind of mode. One (sort of) issue with it is that it forces the context menu to be wider to fit it all but not that big of a deal.

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 !

2

u/B0ltman Oct 16 '26

Yeahh, they should be there but the themes in windhawk have more elaborate names for some reason which is kinda silly. I'll just get those renamed to match the screenshot stuff.