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: 60+ popular emojis.
Symbols Picker: 50+ common symbols.
Websites: 50+ 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

Open the Radify Skin Editor
Select the "Default" skin (first in the list)
Configure the settings as needed
Click the "Edit" button
Click "OK" or "Apply"

🎨 Modify a Skin

Open the Radify Skin Editor
Select the skin you want to modify
Make your changes
Click the "Edit" button
Ensure all desired settings are checked
Click "OK" or "Apply"

🌟 Set a Skin as Default

Open the Radify Skin Editor
Choose your preferred skin
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 instead of individual 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:

Open the Radify Skin Editor
Click the folder icon
Choose a new directory

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

SetImageDir(dirPath)
SetSoundDir(dirPath)

🗒️ Radify Skin Editor Notes

Reload any script using Radify after making changes for the changes to take effect.

📖 How to Use

As a Library in a Script

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

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('compmgmt.msc')},
        {image: 'system-configuration.png', click: (*) => Run('msconfig.exe')},
        {image: 'system-information.png', click: (*) => Run('msinfo32.exe')},
        {image: 'task-scheduler.png', click: (*) => Run('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 create, customize, or modify items by editing the file.

🖱️ Default Actions and Shortcuts in Radify Menus.ahk

Open Menu

Middle mouse button: Opens mainMenu
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

Power Plans submenu

Right-Click on submenu: Opens Control Panel > Power Options

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.

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)
Image filename from 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: fullPath|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

Methods of the Radify class:

🔧 `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.

🔧 `Show(MenuID, AutoCenterMouse)`

Shows the menu at the current mouse position.

Parameter	Type	Description
`MenuID`	string	Unique identifier of the menu.
`AutoCenterMouse`	boolean	Centers the mouse cursor when the menu is shown.

🔧 `Close(MenuID, SuppressSound)`

Closes the entire menu tree of the specified menu.

Parameter	Type	Description
`MenuID`	string	Unique identifier of the menu.
`SuppressSound`	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`.

🔧 Class Properties

Properties of the Radify class:

🔧 `LastMenuOpenInfo`

Stores information about the last opened menu. Updated each time a menu is shown via the Show method.

Property	Type	Description
`mouseX`	number	X-coordinate when the menu was opened.
`mouseY`	number	Y-coordinate when the menu was opened.
`hwndUnderMouse`	number	HWND of the window under the mouse when the menu was opened.

Access example:

; Toggles the always-on-top state of window
ToggleWindowAlwaysOnTop() {
    info := Radify.lastMenuOpenInfo
    hwndUnderMouse := info.hwndUnderMouse

    try {
        winTitleUM := WinGetTitle('ahk_id ' hwndUnderMouse)
        winClassUM := WinGetClass('ahk_id ' hwndUnderMouse)
    } catch
        return

    if (!winTitleUM || winTitleUM = 'Program Manager' || winClassUM = 'Shell_TrayWnd')
        return

    WinSetAlwaysOnTop(-1, 'ahk_id ' hwndUnderMouse)
    exStyle := WinGetExStyle('ahk_id ' hwndUnderMouse)
    CoordMode('ToolTip', 'Screen')
    ToolTip(winTitleUM '`nAlways on Top "' (exStyle & 0x8 ? 'On' : 'Off') '"', info.mouseX, info.mouseY, 19)
    SetTimer((*) => ToolTip(,,,19), -2500)
}

🔧 `RootDir`

Stores the absolute path to the directory containing the script Radify.ahk or the compiled executable.

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 set options for submenus, use the SubmenuOptions property.

Menu options are merged in the following order:

User-defined options passed to the CreateMenu method or the SubmenuOptions property.
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 displayed when hovering over a menu item. 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	Image 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.
Sound filename from C:\Windows\Media or the \Sounds folder. 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
`EnableItemText`	boolean	Shows text labels on menu items.
`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` action 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	Centers the mouse cursor when the menu is shown.
`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.

🧮 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

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

Name		Name	Last commit message	Last commit date
Latest commit History 19 Commits
Images		Images
Lib		Lib
Licenses		Licenses
Scripts		Scripts
Skins		Skins
Icons.dll		Icons.dll
LICENSE		LICENSE
README.md		README.md
Radify Menus.ahk		Radify Menus.ahk
Radify Skin Editor.ahk		Radify Skin Editor.ahk
Radify.ahk		Radify.ahk

License

XMCQCX/RadifyClass-RadifySkinEditor

Folders and files

Latest commit

History

Repository files navigation

Radify

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

📦 Requirements

✨ Features

✨ Built-In Menus

🎨 Radify Skin Editor

✨ Features

🔧 Modify Default Settings

🎨 Modify a Skin

🌟 Set a Skin as Default

🖼️ Skin Files

📁 Set Media Directory

🗒️ Radify Skin Editor Notes

📖 How to Use

As a Library in a Script

Item Actions

Quick Start with Built-in Menus

🖱️ Default Actions and Shortcuts in Radify Menus.ahk

Open Menu

Close Menu

Move Menu

Specific Item Actions (Same item, two actions)

🗒️ Notes

Item Object Properties

Supported Image Formats

🔧 Class Methods

🔧 CreateMenu(MenuID, MenuItems, Options)

🔧 Show(MenuID, AutoCenterMouse)

🔧 Close(MenuID, SuppressSound)

🔧 SetImageDir(DirPath)

🔧 SetSoundDir(DirPath)

🔧 Class Properties

🔧 LastMenuOpenInfo

🔧 RootDir

Options Object Properties

🎨 Skin & Images

🔊 Sounds

📐 Layout

Text Styling

🖱️ Click Behavior

🖱️ Menu Actions

⚙️ Menu Closing Behavior

🪟 Window & Interaction

Tooltip & Effects

🧮 Rendering

☕ Donate

📄 License

🎖️ Credits

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

🔧 `CreateMenu(MenuID, MenuItems, Options)`

🔧 `Show(MenuID, AutoCenterMouse)`

🔧 `Close(MenuID, SuppressSound)`

🔧 `SetImageDir(DirPath)`

🔧 `SetSoundDir(DirPath)`

🔧 `LastMenuOpenInfo`

🔧 `RootDir`

Packages