Home

Welcome to the WinMac-Menu wiki!

Features

• Recent Items: dynamic submenu from %AppData%\Microsoft\Windows\Recent
• Config-driven items with separators, folders as submenus, URIs, commands, power actions, and a consolidated Power menu (POWER_MENU)
• Light/Dark auto-adaptation; immersive dark hint on the invisible owner window
• Icons: per-item icons, theme-aware overrides (light/dark), optional DefaultIcon + theme variants, and optional system folder icon retrieval
• Placement controls (edges, center, or cursor, with offsets + ignore options), per‑monitor DPI aware
• First-letter activation, outside-click dismissal
• Folder submenu behaviors: lazy population, max depth, name-only items, optional “Open ” entry
• Inline folder expansion (inject a folder’s contents directly into the root menu) with optional clickable header
• Granular extension hiding (global + recent-only override)

Run

Quick Start: Double‑click the EXE. By default, it runs in background mode with a system tray icon.

Modes:

• Background Mode (default): App stays running in background. Launch again to toggle/show menu.
• One-shot: Set RunInBackground=false in config to exit after menu closes (legacy behavior).
  • To start silently in background (without showing the menu on first launch), set ShowOnLaunch=false.

Custom config: Use --config <path> to point at a custom INI (single instance per INI path applies).

Tray Icon: Right-click for settings menu including:

• Show menu / Hide tray / Elevate (run as admin)
• Start on login toggle
• Show/Hide menu icons (toggles whether icons appear in the popup menu)
• Settings (opens config.ini) / Help / About
• Exit

Configuration

WinMacMenu reads an INI. If missing, a default is created.

Sections

• [General] global behavior and style
• [Placement] position rules
• [Menu] menu items Item1..ItemN
• [Icons] per-item icon mapping Icon1..IconN and optional DefaultIcon/DefaultIconLight/DefaultIconDark
• [IconsLight] theme-specific per-item icons for light theme (Icon1..IconN)
• [IconsDark] theme-specific per-item icons for dark theme (Icon1..IconN)

Notes

• Environment variables expand in labels, paths, params, and icon paths (e.g., %USERNAME%).
• Indices N in [Icons]/[IconsLight]/[IconsDark] map to ItemN in [Menu].
• Generated default INI contains no comments (to keep the file minimal). Comments are still supported by the parser if you add them manually: lines beginning with ; or # are ignored.
• Duplicate keys: The last occurrence in a section wins (standard Win32 profile API behavior).
• Unknown keys are ignored.

Comment Syntax

The generated default INI is comment-free. If you add comments manually, use ; or # at the start of a line. Inline comments (end‑of‑line) are not supported.