How can we help you?

Payment Failed

If your payment failed, here are common causes and solutions:

1. Insufficient funds - Ensure your card has enough balance.
2. Card expired - Update your payment method with a valid card.
3. Bank declined - Contact your bank to authorize international transactions.
4. Incorrect details - Double-check your card number, expiry, and CVV.

Update Payment Method

To update your payment information:

1. Visit the Customer Portal
2. Sign in with your email
3. Click "Update Payment Method"
4. Enter your new card details

Request a Refund

To request a refund within 14-day, email us at support@magicprefs.com with your order number.

Supported Gestures

MagicPrefs supports a variety of multi-touch gestures:

• Two-finger swipes - Up, down, left, right
• Three-finger swipes - Navigate spaces, app switching
• Pinch to zoom - Standard macOS zoom gesture
• Rotate - Two-finger rotation gesture
• Multi-finger taps - Two, three, or four-finger taps

Creating Custom Gestures

1. Go to the Gestures tab in MagicPrefs
2. Click "Add Gesture"
3. Perform the gesture on your device to record it
4. Assign an action

Enable Native Gestures

To allow MagicPrefs to generate native macOS pinch/rotate events:

1. Click the MagicPrefs menu bar icon
2. Enable "Generate Native Pinch/Rotate"

This allows gestures to work in apps like Maps and Photos.

Required Permissions

MagicPrefs requires two system permissions to function:

1. Accessibility

Required for: Simulating key presses, clicking, and controlling windows.

1. Open System Settings → Privacy & Security → Accessibility
2. Click the lock to make changes
3. Toggle MagicPrefs ON

2. Input Monitoring

Required for: Reading touch events from your Magic Mouse or Trackpad.

1. Open System Settings → Privacy & Security → Input Monitoring
2. Click the lock to make changes
3. Toggle MagicPrefs ON

Permission Not Sticking?

If macOS doesn't remember your permission grant:

1. Remove MagicPrefs from the list
2. Restart your Mac
3. Open MagicPrefs and grant permissions again

TCC Database Reset (Advanced)

In rare cases, you may need to reset the permission database:

tccutil reset Accessibility com.vladalexa.MagicPrefs
tccutil reset ListenEvent com.vladalexa.MagicPrefs

Then relaunch MagicPrefs and grant permissions again.

Activating Your License

1. Open MagicPrefs Preferences (⌘,)
2. Go to the License tab
3. Enter your license key (received via email after purchase)
4. Click Activate

Finding Your License Key

Your license key was sent to the email you used at checkout. Search for emails from Lemon Squeezy or vladalexa.com. You can also find it in your Receipt or by logging into the Customer Portal.

Deactivating a Device

To free up an activation slot:

1. Open MagicPrefs on the device you want to deactivate
2. Go to License tab
3. Click Deactivate

Activation Limit Reached

If you see "Activation limit reached":

• Deactivate unused devices first
• Or contact support to reset your activations

Manage Payments & Subscriptions

Visit the Customer Portal (also known as "My Orders") to:

• Update payment method
• View invoices
• Cancel or reactivate subscription

MagicPrefs Not Starting?

1. Check if another instance is running (only one can run at a time)
2. Look for the MagicPrefs icon in the menu bar
3. Try quitting and relaunching from Applications

Orange Menu Bar Icon

The menu bar icon turns orange when there's an issue:

• License expired - Renew your subscription
• Touch engine stopped - Grant required permissions
• Permissions missing - See Permissions

Device Not Detected

1. Ensure Bluetooth is enabled
2. Check device is connected in System Settings → Bluetooth
3. Try turning the device off and on
4. Restart MagicPrefs

Collecting Debug Logs

When reporting an issue, include debug logs:

1. Open Terminal
2. Run: log show --predicate 'subsystem == "com.vladalexa.MagicPrefs"' --last 5m
3. Copy the output and include in your support email