Radify

A radial menu launcher with multi-ring layouts, submenus and interactive items.

Inspired by Radial menu v4 by Learning one.

---

---

📦 Requirements

• AutoHotkey v2
• GDI+ Library for AutoHotkey v2

---

✨ Features

• Customizable Menu Options: Configure images, text, tooltips, item size, skins, and more.
• Custom Click Actions: Assign various click actions to individual items and menus.
• Hotkeys and Hotstrings: Assign custom hotkeys and hotstrings to trigger specific item actions.
• Multi-Level Submenus: Create nested menus.
• Interactive Effects: Show tooltips and glow effects when hovering over items.
• Sound Effects: Add audio feedback for various menu interactions.
• Skin Support: Apply different skins. Compatible with Radial menu v4 skins.
• Built-In Menu Items: 200+ items including emojis, symbols, websites, system settings, administrative tools, and power management options.

✨ Built-In Menus

• Emojis Picker: 50+ popular emojis.
• Symbols Picker: 60+ common symbols.
• Websites: 30+ frequently used websites.
• Settings: 15+ system settings (GUID and ms-settings: URI links).
• Tools: 15+ Windows system utilities and administrative tools.
• Power Options: Shutdown, Restart, Sleep, Advanced Startup, and Restart to Safe Mode.
• Power Plans: Set the active power plan.
• System Cleanup: Useful shortcuts for cleaning your system.

---

🎨 Radify Skin Editor

Explore all customization options of the Radify class, configure settings, preview skins, and more.

---

---

✨ Features

• Browse Skins: Preview all available skins.
• Configure Settings: Configure default and individual skin settings.
• Font and Color Selection: Browse and preview system fonts and colors.
• Sound Preview: Browse and play all available sounds.

---

🔧 Modify Default Settings

1. Open the Radify Skin Editor
2. Select the "Default" skin (first in the list)
3. Configure the settings as needed
4. Click the "Edit" button
5. Confirm with "OK" or "Apply"

---

🎨 Modify a Skin

1. Open the Radify Skin Editor
2. Select the skin you want to modify
3. Make your changes
4. Click the "Edit" button
5. Ensure all desired settings are checked
6. Click "OK" or "Apply"

---

🌟 Set a Skin as Default

1. Open the Radify Skin Editor
2. Choose your preferred skin
3. Click the floppy disk icon to save it as the default

---

🖼️ Skin Files

• ItemGlow.png
• MenuOuterRim.png
• MenuBack.png
• ItemBack.png(required)
• CenterImage.png
• SubmenuIndicator.png

Note:

• The Skins folder requires .png files for skin assets. Other image formats can be assigned programmatically or via Radify Skin Editor. See: Supported Image Formats.

Radial menu v4 skins

• All settings are loaded from Preferences.json rather than from skin definition.txt files.

• To set the submenu indicator image, you can:

  • In Radify Skin Editor, set a default SubmenuIndicatorImage, or assign one per skin.
  • Add a SubmenuIndicator.png file to each skin folder.
  • Set SubmenuIndicatorImage programmatically.

---

📁 Set Media Directory

Files in those folders can be referenced by filename only.

• Include the file extension when referencing image files (e.g., downloads.png).
• Omit the .wav extension when referencing sound files (e.g., tada).

Steps:

1. Open the Radify Skin Editor
2. Click the folder icon
3. Choose a new directory

You can also configure these directories programmatically using the following methods:

• SetImageDir(dirPath) – sets the image directory
• SetSoundDir(dirPath) – sets the sound directory

---

🗒️ Radify Skin Editor Notes

• Reload any script using Radify after making changes.

---

📖 How to Use

• As a Library in a Script

Radify can be included as a library in any AutoHotkey v2 script.

For example:

#Requires AutoHotkey v2.0
#SingleInstance
#Include <v2\GDIp\Gdip_All>
#Include <v2\Radify\Radify>
;==============================================
if (!pToken := Gdip_Startup())
MsgBox('GDI+ failed to start. Please ensure you have GDI+ on your system.',, 'Iconx'), ExitApp()
OnExit((*) => (Radify.DisposeResources(), Gdip_Shutdown(pToken)))
;==============================================
Radify.CreateMenu('myMenu', [
[ ; ring 1
{image: 'device-manager.png', click: (*) => Run('devmgmt.msc')},
{image: 'disk-management.png', click: (*) => Run('diskmgmt.msc')},
{image: 'computer-management.png', click: (*) => Run('mmc.exe compmgmt.msc')},
{image: 'system-configuration.png', click: (*) => Run('msconfig.exe')},
{image: 'system-information.png', click: (*) => Run('msinfo32.exe')},
{image: 'task-scheduler.png', click: (*) => Run('mmc.exe taskschd.msc')},
],
[ ; ring 2
{image: 'services.png', click: (*) => Run('services.msc')},
{image: 'registry-editor.png', click: (*) => Run('regedit.exe')},
{image: 'optimize-drives.png', click: (*) => Run('dfrgui.exe')},
{image: 'system-image.png', click: (*) => Run('sdclt.exe /BLBBACKUPWIZARD')},
{image: 'event-viewer.png', click: (*) => Run('eventvwr.msc')},
{image: 'windows-tools.png', click: (*) => Run('shell:::{D20EA4E1-3957-11D2-A40B-0C5020524153}')},
{
image: 'monitor.png',
click: (*) => Run('resmon.exe'),
text: 'Resmon',
tooltip: 'Resource Monitor',
itemImageScale: 0.35,
itemImageYRatio: 0.25,
textYRatio: 0.75,
},
{
image: 'monitor.png',
click: (*) => Run('perfmon.exe'),
text: 'Perfmon',
tooltip: 'Performance Monitor',
itemImageScale: 0.35,
itemImageYRatio: 0.25,
textYRatio: 0.75,
},
],
])
^1::Radify.Show('myMenu')
^2::Radify.Close('myMenu')

---

Item Actions

• Click: Executes the item’s primary action.
• Right-Click: Executes an alternate action (if defined).
• Ctrl + Click: Executes the CtrlClick action if defined; otherwise, it executes the item’s Click action (if defined), without closing the menu.
• Actions can also be launched via Shift + Click, Alt + Click, Hotkeys, and Hotstrings.

---

• Quick Start with Built-in Menus

Run Radify Menus.ahk to access pre-built menus with 200+ items including emojis, symbols, websites, system settings, tools, and power options. You can add, customize, or remove items by editing the Radify Menus.ahk file directly.

---

🖱️ Default Actions and Shortcuts in Radify Menus.ahk

Open Menu

• Middle mouse button: Opens mainMenu with the cursor centered on the menu.
• Tray icon clicks:
  • Click: Opens mainMenu
  • Double-Click: Opens appsMenu
  • Ctrl + Click: Opens websitesMenu
  • Shift + Click: Opens aiMenu
  • Alt + Click: Opens systemPowerMenu

Close Menu

• Click on the menu background.
• Right-Click on the menu background or the center.
• Esc key

Move Menu

• Click and Drag the center to reposition the menu.

Specific Item Actions (Same item, two actions)

Items in the Emojis, Symbols, Websites, AI, and Shopping submenus

• Click: Executes the primary action.
• Right-Click: Executes the primary action and keeps the menu open. By default, Ctrl + Click also executes the item’s Click action (if defined), without closing the menu.

Apps submenu

• Right-Click on submenu: Opens Apps > Installed apps in Windows Settings.

Folders submenu

• Right-Click on submenu: Opens This PC

Settings submenu

• Right-Click on submenu: Opens the Windows Settings app

Cleanup submenu

• Click on Recycle Bin item: Opens the Recycle Bin folder.
• Right-Click on Recycle Bin item: Empties the Recycle Bin.

---

🗒️ Notes

• All shortcuts and behaviors are customizable.

---

Item Object Properties

Defines the characteristics and behavior of a menu item.

Each item object may include:

Property	Type	Description
Image	string | number	Image displayed on the menu item. See: Supported Image Formats.
Tooltip	string	Tooltip text shown on hover. See also: AutoTooltip.
Text	string	Text to display on the menu item.
Click	function object | string	Action to execute when the item is clicked.
RightClick	function object | string	Action to execute when the item is right-clicked.
CtrlClick	function object | string	Action to execute when the item is ctrl+clicked. If the CtrlClick action is not defined, Ctrl + Click executes the item’s Click action (if defined), without closing the menu.
ShiftClick	function object | string	Action to execute when the item is shift-clicked.
AltClick	function object | string	Action to execute when the item is alt-clicked.
HotkeyClick	string	Hotkey that triggers the Click action.
HotkeyRightClick	string	Hotkey that triggers the RightClick action.
HotkeyCtrlClick	string	Hotkey that triggers the CtrlClick action.
HotkeyShiftClick	string	Hotkey that triggers the ShiftClick action.
HotkeyAltClick	string	Hotkey that triggers the AltClick action.
HotstringClick	string	Hotstring that triggers the Click action.
HotstringRightClick	string	Hotstring that triggers the RightClick action.
HotstringCtrlClick	string	Hotstring that triggers the CtrlClick action.
HotstringShiftClick	string	Hotstring that triggers the ShiftClick action.
HotstringAltClick	string	Hotstring that triggers the AltClick action.
SubMenu	array	The submenu structure: an array of one or more inner arrays (rings), each containing item objects.
SubmenuOptions	object	Options specific to the submenu.

---

Additional Properties:

• ItemBackgroundImage, ItemImageScale, ItemImageYRatio, SubmenuIndicatorImage, SubmenuIndicatorSize, SubmenuIndicatorYRatio, SoundOnSelect, CloseOnItemClick, CloseOnItemRightClick, MirrorClickToRightClick and all text styling settings.

---

Click, RightClick, CtrlClick, ShiftClick and AltClick accept either a function object or a predefined action.

Predefined Actions:

• Close: Closes the entire menu tree.
• CloseMenu: Closes only the current menu.

---

Special Interactions:

• Ctrl + Click: If the CtrlClick action is not defined, Ctrl + Click executes the item’s Click action (if defined), without closing the menu.

Empty Items:

• An empty object {} inserts a blank space in the menu, useful for spacing or alignment.

---

Supported Image Formats

• File path to a standard image. (png, jpeg, jpg, ico, gif, bmp, tif)
• Filename located in the /Images folder (include the file extension, e.g., downloads.png).
• Image handle (hIcon, hBitmap).
• Icons from resource libraries (.exe, .dll, .cpl). Use the format: full_path|iconN, where N is the icon index. If |iconN is omitted, icon index 1 is used by default.
  • Examples:
    • A_WinDir '\System32\imageres.dll|icon19'
    • A_ProgramFiles '\Everything\Everything.exe'

---

🔧 Class Methods

Available methods for the Radify class:

🔧 Show(MenuID, AutoCenterMouse)

Shows the menu at the current mouse position.

Parameter	Type	Description
MenuID	string	Unique identifier of the menu.
AutoCenterMouse	boolean	Center mouse cursor when showing menu.

---

🔧 Close(MenuID, SuppressSounds)

Closes the entire menu tree of the specified menu.

Parameter	Type	Description
MenuID	string	Unique identifier of the menu.
SuppressSounds	boolean	Suppresses the menu close sound.

---

🔧 SetImageDir(DirPath)

Sets the directory for images, allowing image files to be referenced by filename only. Must be called before creating a menu to change the directory. Include the file extension when referencing image files (e.g., downloads.png).

Parameter	Type	Description
dirPath	string | undefined	The image directory path. If omitted, defaults to rootDir\Images. The path may include the rootDir\ prefix, which refers to the directory containing Radify.ahk.

---

🔧 SetSoundDir(DirPath)

Sets the directory for sounds, allowing sound files to be referenced by filename only. Must be called before creating a menu to change the directory. Omit the .wav extension when referencing sound files (e.g., tada).

Parameter	Type	Description
dirPath	string | undefined	The sound directory path. If omitted, defaults to rootDir\Sounds. The path may include the rootDir\ prefix, which refers to the directory containing Radify.ahk.

---

🔧 CreateMenu(MenuID, MenuItems, Options)

Creates a menu with the specified ID, structure, and configuration options.

Parameter	Type	Description
MenuID	string	Unique identifier of the menu.
MenuItems	array	The menu structure: an array of one or more inner arrays (rings), each containing item objects.
Options	object	Configuration options for the menu.

---

Options Object Properties

Configuration options for the menu.

Note:

Options apply only to the current menu and are not inherited by submenus, except for skin. To pass other options to submenus, use the SubmenuOptions key on individual menu items.

Each menu's options are merged in the following order:

• User-defined options passed to the CreateMenu method.
• Skin-defined options.
• Global default options.

---

🎨 Skin & Images

Property	Type	Description
Skin	string	Folder in /Skins containing skin assets.
ItemGlowImage	string | number	Glow effect image on hover. Requires EnableGlow to be true.
MenuOuterRimImage	string | number	Image for the outer rim of the menu.
MenuBackgroundImage	string | number	Background image of the menu.
ItemBackgroundImage	string | number	Background image for individual menu items. Requires ItemBackgroundImageOnItems to be true.
CenterBackgroundImage	string | number	Background image for the center. Requires ItemBackgroundImageOnCenter to be true.
CenterImage	string | number	Image shown in the center of the menu.
SubmenuIndicatorImage	string | number	Icon indicating a submenu.

---

🔊 Sounds

Property	Type	Description
SoundOnSelect	string	Sound played when an item is selected.
SoundOnShow	string	Sound played when the menu opens.
SoundOnClose	string	Sound played when the menu closes.
SoundOnSubShow	string	Sound played when a submenu opens.
SoundOnSubClose	string	Sound played when a submenu closes.

Supported Sound Formats:

• Path to a .wav file.
• Filename from the C:\Windows\Media folder or the configured \Sounds directory. Omit the .wav extension when referencing sound files (e.g., tada).

---

📐 Layout

Property	Type	Description
ItemSize	number	Size of menu items (25–250 px).
RadiusScale	number	Spacing between rings (0.5–2).
CenterSize	number	Size of center area (25–250 px).
CenterImageScale	number	Scale of center image (0–1).
ItemImageScale	number	Scale of item image (0–1).
ItemImageYRatio	number	Y-position of item image (0 = top, 0.5 = center, 1 = bottom).
SubmenuIndicatorSize	number	Size of submenu icon (5–50 px).
SubmenuIndicatorYRatio	number	Y-position of submenu icon (0 = top, 0.5 = center, 1 = bottom).
OuterRingMargin	number	Margin between the outermost ring and the edge of the menu (0–75 px).
OuterRimWidth	number	Width of outer rim (0–25 px).
ItemBackgroundImageOnCenter	boolean	Apply item background image to the center.
ItemBackgroundImageOnItems	boolean	Apply item background image to all menu items.

---

Text Styling

Property	Type	Description
TextFont	string	Font name.
TextColor	string	Font color in hex (e.g., "FFFFFF").
TextSize	number	Font size (5–100 px).
TextFontOptions	string	Font styles (bold, italic, strikeout, underline) (e.g., "bold italic").
TextShadowColor	string	Shadow color in hex (e.g., "000000").
TextShadowOffset	number	Shadow offset (0–5 px).
TextBoxScale	number	Text box scale (0.5–1).
TextYRatio	number	Text Y-position (0 = top, 0.5 = center, 1 = bottom).
TextRendering	number	Rendering quality for text:
		- 0: Default
		- 1: SingleBitPerPixelGridFit
		- 2: SingleBitPerPixel
		- 3: AntiAliasGridFit
		- 4: AntiAlias
		- 5: ClearTypeGridFit

---

🖱️ Click Behavior

Property	Type	Description
MirrorClickToRightClick	boolean	Automatically assigns the Click function to RightClick for items that have a Click action but no RightClick action defined.

---

🖱️ Menu Actions

Property	Type	Description
MenuClick	function object | string	Action to execute when clicking the menu background.
MenuRightClick	function object | string	Action to execute when right-clicking the menu background.
CenterClick	function object | string	Action to execute when clicking the center area.
CenterRightClick	function object | string	Action to execute when right-clicking the center area.

These properties accept either a function object or a predefined action.

Predefined Actions:

• Close: Closes the entire menu tree.
• CloseMenu: Closes only the current menu.
• Drag: Makes the menu draggable. Note: Dragging is only supported with left-click, not right-click.

---

⚙️ Menu Closing Behavior

Property	Type	Description
CloseOnItemClick	boolean	Closes the entire menu tree when a menu item is clicked.
CloseOnItemRightClick	boolean	Closes the entire menu tree when a menu item is right-clicked.
CloseMenuBlock	boolean	Prevents the menu from closing via the specific HotIfWinExist(WinTitle) example below. Close(MenuID) still works normally.

HotIfWinExist('RadifyGui_0_0 ahk_class AutoHotkeyGUI')
Hotkey('Esc', (*) => WinClose(WinExist()))
HotIfWinExist()

---

🪟 Window & Interaction

Property	Type	Description
AutoCenterMouse	boolean	Center mouse cursor when showing menu.
AlwaysOnTop	boolean	Keeps the menu always on top.
ActivateOnShow	boolean	Activates menu window on show.

---

Tooltip & Effects

Property	Type	Description
AutoTooltip	boolean	Generates the tooltip text if Tooltip is not set, based on item text or image name.
EnableTooltip	boolean	Enables tooltips for menu items.
EnableGlow	boolean	Enables glow effect on hover.
EnableItemText	boolean	Shows text labels on menu items.

---

🧮 Rendering

Property	Type	Description
GuiOptions	string	AutoHotkey GUI options
SmoothingMode	number	Shape rendering mode:
		- 0: Default
		- 1: High Speed
		- 2: High Quality
		- 3: None
		- 4: AntiAlias
InterpolationMode	number	Image scaling quality:
		- 0: Default
		- 1: Low Quality
		- 2: High Quality
		- 3: Bilinear
		- 4: Bicubic
		- 5: Nearest Neighbor
		- 6: High Quality Bilinear
		- 7: High Quality Bicubic

---

☕ Donate

If you find my AHK code useful and would like to show your appreciation, any donation is greatly appreciated. Thank you!

---

📄 License

• MIT License

---

🎖️ Credits

• AutoHotkey – Steve Gray, Chris Mallett, portions of the AutoIt Team, and various others.
• Radial menu v4 by Learning one
• GDI+
  • tic – Created the original Gdip.ahk library
  • Rseding91, mmikeww, buliasz
• JSON by thqby, HotKeyIt
• Icons and emojis © Microsoft.

---

Radify

• CalculatePopupWindowPosition by lexikos
• PlayWavConcurrent by Faddix
• ToolTipEx by nperovic

---

Radify Skin Editor

• GuiCtrlTips by just me
• LVGridColor by just me
• GuiButtonIcon by FanaticGuru
• YACS – Yet Another Color Selector by Komrad Toast
• ColorPicker by Maestrith, TheArkive (v2 conversion)
• GetFontNames by teadrinker
• MoveControls by Descolada (from UIATreeInspector.ahk)
• Control_GetFont by SKAN, swagfag
  • AHK Forum
  • AHK Forum