Getting Started

From nothing to a working context menu in about five minutes.

Once you’re set up, go straight to whichever page covers what you’re after:

• Menu Editor Guide — how to configure each menu type, what every field means, how display rules work
• Plugin Manager — installing plugins, permissions, resident plugins
• Settings — what each switch does, and what to do when iCloud folders have no menu
• Script Menus — writing your own scripts
• FAQ — start here when something is wrong

1. Install

1. Download the latest DMG from the website
2. Open it and drag iRightMenu Pro into your Applications folder
3. Launch it from Applications

Don’t run it from inside the DMG, and don’t leave it in Downloads — macOS applies extra restrictions in both locations and the context menu may fail to register.

2. First launch

Activation

An activation window appears on first launch. Enter the license key you received when purchasing and click Activate. You can also re-activate later under Settings → License.

The Finder extension

You don’t need to enable it. The app registers the Finder extension itself at launch, on every version of macOS.

If right-clicking still shows no menu, see “The context menu doesn’t show up” in the FAQ, which walks through the checks in order.

Permissions

First launch needs no special permissions — the context menu and scripts both work as they are.

Only two situations call for more, and you can grant them when you get there:

• Accessibility — for using the context menu inside iCloud, OneDrive and similar folders, or for the middle-click menu. See Settings
• Location / Screen Recording / Bluetooth — needed by certain plugins, which will ask when they need one

Launch at login

Worth leaving on. The context menu and plugins are executed by the main app, so if it isn’t running your first click is a beat slower.

3. Build your first menu

Open the main window (status bar icon → Open Main Window, or double-click the app icon) and stay on the Context Menu tab.

Three panes: the library on the left (every available template), your menu in the middle (what the context menu actually contains), and the inspector on the right.

Take “Open with VS Code” as the example, built from scratch:

1. Right-click in the middle pane → Add → Open With…
2. The new item is called “Open With…”; on the Basic tab set Title to Open with VS Code
3. Scroll to Open With Configuration:
   • Set Open With to App Name
   • Set Target to Visual Studio Code — the name shown in the Applications folder, without .app
4. Switch to the Display tab and set Show When to Files selected
5. Right-click any file in Finder — there it is

The library does contain a whole group of ready-made “Open with X” entries you could just drag over. We create one from scratch here so you touch every field once and learn what each of them controls — the same fields configure any menu.

Changes take effect immediately; there is no Save button. Made a mistake? ⌘Z.

Three ways to add a menu

Ordering and grouping

• Drag up and down in the middle pane to reorder
• Drop onto a Submenu item to make it a child
• Select and press Delete to remove

Use submenus once you have a lot of items. Anything you rarely use can be switched off with Enable on the Basic tab — the configuration stays, ready to come back.

4. Where next

When something is wrong

Start with the FAQ — it covers the context menu not showing, scripts failing, plugins not taking effect and more.

Still stuck? Set the log level to DEBUG under Settings → Diagnostics, reproduce the problem, then use Export Diagnostic Logs and send it to us.

• Support QQ: 102378237
• QQ group: 1097016301
• Email: support@byteage.com