This mod adds customizable system tray icons in Windows with configurable actions and context menus, support for image files and application icons, and automatic adaptation to the system theme.
- Install Windhawk.
- Open Windhawk and go to Explore → Search.
- Enter Ultimate Custom Tray in the search field.
- In the results, select Ultimate Custom Tray.
- Click the "Install" button.
- Open Windhawk settings for this mod.
- Add one or more Items to the list.
- Fill in Label, Icon and Action for each item.
- Save — the icons appear in the tray immediately.
| Prefix | Example | Description |
|---|---|---|
" " |
"C:\Program Files\Windhawk\windhawk.exe" |
Opens a file or folder by path. |
~ |
~Downloads and ~windhawk.exe |
Opens a folder or file by name. |
cmd: |
cmd:control |
Runs a command through cmd.exe. |
shell: |
shell:shutdown /r /f /t 0 |
Runs through powershell.exe. |
press: |
press:Win+E or press:0x5B;0x45 |
Keyboard key press using a Win32 key code. |
web: |
web:https://windhawk.net/ |
Opens a URL in the default browser. |
ms-settings: |
ms-settings:bluetooth |
Opens a Windows Settings page. |
| Sign | Example | Description |
|---|---|---|
- |
-"C:\Program Files\app.exe" or -shell:shutdown /r /f /t 0 |
Runs as administrator. |
* |
*cmd:tasklist or *shell:Get-Process |
Execution with a terminal window. (only for cmd: and shell: prefixes). |
Signs can be combined: -*cmd:tasklist runs cmd in a visible window as admin.
| Type | Example | Description |
|---|---|---|
| Glyph | E774 |
Hex code of a Segoe Fluent Icons glyph. 4-digit hex only, no \u prefix. |
| Image file | C:\Icons\name.png |
Full path to an image. Supported: .png .ico .jpg .bmp. Recommended: 32x32 px, transparent background. |
| App path | C:\Program Files\Windhawk\windhawk.exe |
Full path to an executable file (.exe, .dll). The icon will be extracted from the application. |
- Auto - detects the current Windows theme (light/dark) on every click and redraws the tray icon accordingly.
- White - always white (for dark taskbar).
- Black - always black (for light taskbar).
- Auto - follows the current Windows theme automatically.
- Light - light background, dark icons.
- Dark - dark background, light icons.
Controls the background and icon color inside the right-click context menu.
When enabled, the context menu opens near the tray icon instead of at the cursor position. This allows precise positioning relative to the icon.
Choose where the menu appears relative to the tray icon:
- Above icon - menu opens above the icon
- Below icon - menu opens below the icon
- Left of icon - menu opens to the left
- Right of icon - menu opens to the right
Controls how the menu is aligned relative to the icon:
- Center - menu is centered on the icon
- Left - menu's left edge aligns with the icon
- Right - menu's right edge aligns with the icon
Distance in pixels between the tray icon and the menu (0-200). Default is 10px.
Each item in the Tray Items list becomes a separate icon in the system tray. You can add multiple items to create a collection of custom tray icons.
- Label - Tooltip text shown when hovering over the tray icon.
- Icon - The icon to display. Can be a glyph code (e.g., "EC50"), image file path, or executable path.
- Action - Command or action to execute when the icon is left-clicked (or right-clicked if buttons are swapped).
- Swap mouse buttons - When enabled, left-click opens the context menu and right-click runs the action.
- Context menu - List of menu items shown on right-click (or left-click if buttons are swapped).
Each context menu item has the following settings:
- State - Controls visibility and interaction (Enabled/Disabled/Hidden).
- Name - Text displayed in the menu.
- Description - Optional text shown on the right side of the menu item (e.g., keyboard shortcut like "Win+E" or a hint).
- Icon - Icon shown next to the menu item (glyph code, image, or executable path).
- Action - Command to execute when the menu item is clicked.
- Separator - Add a separator line above or below this item.
This project is licensed under the MIT License - see the LICENSE file for details.