Getting Started

Welcome to iRightMenu Pro! This guide helps you get up and running quickly.

Installation

Download & Install

1. Download the latest DMG from the official website
2. Open the DMG and drag iRightMenu Pro to the Applications folder
3. On first launch, the system will prompt for permissions:
   • Finder Extension: Enabled automatically
   • Accessibility: Required for keyboard/mouse simulation features (System Settings → Privacy & Security → Accessibility)

Launch at Login

Recommended to keep enabled. The main app provides core services for right-click menus and plugins.

Even if disabled, the app will be launched automatically on your first right-click action.

Menu Editor

Open the main window and select the “Context Menu” tab. The editor has three panels:

Left — Template Library

All available menu item templates:

• New File: AI, CSS, Excel, Markdown, and more
• Built-in: Copy Path, Cut File, New Folder
• Copy To / Move To: Quick file operations
• Scripts: Custom shell scripts
• Plugins: Menu items from installed plugins

Center — Your Menu

This is the actual Finder right-click menu content. You can:

• Drag to reorder — drag items up/down
• Create hierarchy — drag onto a submenu to nest
• Right-click to add — right-click the empty area to add new items

Right — Properties Panel

Select a menu item to edit its properties:

• Basic: Title, icon, enabled state, shortcut key
• Match Rules: File type filter (extension, regex), file/folder selection
• Script: Shell/AppleScript/Python/JavaScript content
• Execution: Privilege, confirmation, result notification

Adding Menu Items

Three ways:

1. Drag: Drag from the left template library to the center menu tree
2. Double-click: Double-click a template to add it to the end
3. Right-click: Right-click a template and select “Add to Menu”

Removing Menu Items

• Select an item and press Delete
• Or drag the item out of the editor window

Script Menus

Custom scripts that can display results or send notifications.

Creating a Script Menu

1. Right-click in the center panel → Add → Script
2. Write your script in the “Script” tab on the right
3. Supported types: Shell (bash/zsh), AppleScript, Python, JavaScript

Built-in Variables

• $1, $2, … — selected file paths
• Working directory is set to the current Finder location

Plugin System

Installing Plugins

1. Click “Plugin Manager” in the toolbar
2. Browse the plugin store
3. Click “Install” or right-click and select “Install”

Managing Plugins

• Enable/Disable: Right-click a plugin → Enable/Disable
• Uninstall: Right-click → Uninstall
• Check Updates: Click “Check Updates” at the bottom

Status Bar Menu

In addition to the Finder context menu, you can customize the status bar menu:

1. Click the “Status Bar Menu” tab in the toolbar
2. Same editing experience as the context menu editor
3. Best for: folder shortcuts, global scripts that don’t require file selection