Skip to main content

Common Issues

Solutions to frequently encountered problems.

Problem​

The radial menu doesn't show when you press your activation key or shortcut.

Solutions​

Check permissions:

  1. Open System Settings > Privacy & Security
  2. Verify Radial has Accessibility permission enabled
  3. If not listed, add it manually

Restart the app:

  1. Quit Radial completely
  2. Relaunch from Applications folder
  3. Test the activation method again

Verify activation method:

  1. Open Radial settings
  2. Check Activation settings
  3. Make sure a modifier key or keyboard shortcut is set
  4. Try a different activation method

Check for conflicts:

  • Your chosen shortcut might conflict with another app
  • Try a different key combination
  • Temporarily disable other utilities that use keyboard shortcuts

Macros Not Working​

Problem​

A macro doesn't execute or only partially executes.

Solutions​

Check permissions:

  1. Open System Settings > Privacy & Security
  2. Verify Radial has Accessibility permission enabled
  3. If not listed, add it manually

Increase delays:

  • Add longer delays between actions
  • Some apps need more time to process commands
  • Start with 1-2 second delays and adjust

Check keyboard shortcuts:

  • Verify the shortcut works manually in the target app
  • Some shortcuts differ between app versions
  • Update the macro if shortcuts have changed

Verify app is active:

  • Make sure the correct app is in focus before triggering the macro
  • Some actions only work when their target app is frontmost

Test actions individually:

  1. Create a new macro with just one action
  2. Test each action from your failing macro separately
  3. Identify which specific action causes the problem

Debug AppleScript:

  • If a macro is using AppleScript, try running it from script-editor to see any errors

Review file paths:

  • Update paths to match your system
  • Use absolute paths instead of relative ones

App-Specific Macros Not Showing​

Problem​

Your app-specific macros don't appear when you switch to that app.

Solutions​

Verify app folder configuration:

  1. Open Radial settings
  2. Go to Menu Content > Macros
  3. Make sure you've created a folder for the specific app
  4. Confirm the app name matches exactly. It's recommended to use the browse file option to ensure name is correct.

Restart both apps:

  1. Quit the target app
  2. Quit Radial
  3. Launch Radial
  4. Launch the target app
  5. Test again

Permission Errors​

Problem​

Macros fail with permission errors or don't have access to perform certain actions.

Solutions​

Grant Accessibility permission:

  1. System Settings > Privacy & Security > Accessibility
  2. Enable Radial
  3. Restart Radial

Grant Automation permission (if needed):

  1. System Settings > Privacy & Security > Automation
  2. Enable Radial to control other apps
  3. Grant permission for each app Radial needs to control

Files & Folders (if needed):

  1. System Settings > Privacy & Security > Full Disk Access
  2. Enable Radial if your macros access protected folders
  3. Only needed for macros that work with sensitive locations

AppleScript Errors​

Problem​

AppleScript actions fail or show error dialogs.

Solutions​

Test in Script Editor:

  1. Open Script Editor
  2. Paste your AppleScript
  3. Run it directly to see detailed error messages
  4. Fix errors there, then update your macro

Check app support:

  • Not all apps support AppleScript
  • Open Script Editor > File > Open Dictionary
  • Search for your target app to see if it's scriptable

Add error handling:

try
    -- your script here
on error errMsg
    display dialog "Error: " & errMsg
end try

Insert Text Not Working​

Problem​

Insert Text action doesn't type anything or types in the wrong place.

Solutions​

Ensure cursor is in text field:

  • Click in a text field before triggering the macro
  • Some apps need focus on a specific text area

Add a delay before inserting:

1. Simulate Keyboard Shortcut → [to focus field]
2. Delay → 0.5 seconds
3. Insert Text → [your text]

Keyboard Shortcuts Not Triggering​

Problem​

Simulate Keyboard Shortcut action doesn't work in the target app.

Solutions​

Verify the shortcut manually:

  • Test the keyboard shortcut by pressing it yourself
  • Make sure it works in the current app version

Check for conflicts:

  • Another app might be intercepting the shortcut
  • Try the shortcut while other utilities are quit

Add focus action first:

1. Open App → [target app]
2. Delay → 1 second
3. Simulate Keyboard Shortcut → [your shortcut]

Try alternative methods:

  • Try the same action with AppleScript

License Issues​

Problem​

License key not working or trial expired.

Solutions​

Check email:

  • License key is sent to your email after purchase
  • Check spam folder
  • Search for emails from hello@appverge.net

Recover license:

  1. Open Radial
  2. On page 4 of the onboarding process
  3. Click "Recover License"
  4. Enter your email address

Verify purchase:

  • Make sure the purchase was completed successfully
  • Check your bank statement or email receipt

Contact support:

Getting More Help​

If these solutions don't fix your issue:

  1. Check documentation — Browse other help pages for specific topics
  2. Contact support — Email support@appverge.net with:
    • Detailed description of the problem
    • Steps to reproduce it
    • macOS version
    • Radial version
    • Screenshots if relevant

Include as much detail as possible when asking for help. The more information provided, the faster support can assist you.

Next Steps​