Use iPhone as a Mac Mouse: Pairing, Gestures & Permissions

What you need

Install iPocketDock on the Mac and iPocketRemote on the iPhone or iPad. Keep both apps updated to compatible versions. Leave the Mac awake and Dock running while you set up the connection.

This workflow is for a nearby Mac: media, volume, pointer, keyboard, and supported system controls. It does not provide a public-internet remote desktop or a way to reach an unrelated network.

Pair the devices

1. Connect both devices to a local network where they can reach each other. Guest Wi-Fi can isolate devices even when the network name is the same.
2. Open Dock’s menu bar menu and show its pairing QR code. Use a fresh code if an earlier session has expired.
3. In iPocketRemote, open Device Management → Add Device and scan the current QR code. Allow camera access when prompted. Keep the Mac pairing window open until pairing finishes. Current versions use QR pairing; legacy manual pairing codes are no longer supported.
4. Finish the pairing prompts on the phone. Seeing or scanning a QR code alone is not the final connected state.
5. Check that the Mac appears online, then change the volume once. Next, grant Accessibility access and test mouse mode. A working volume control alone does not verify the pointer permission.

Mouse, trackpad gestures, and keyboard shortcuts

Once connected, open mouse mode on the phone. Start with a normal web page on the visible Mac screen: verify pointing and clicking before trying multi-finger gestures. These are the defaults; your mouse-mode settings take precedence after customization.

Goal	Phone gesture	What to check on the Mac
Move, click, double-click	Move one finger, tap, or double-tap.	The pointer moves and the target responds.
Right-click	Tap with two fingers.	A context menu opens at the pointer.
Scroll	Slide two fingers.	The scrollable area under the pointer moves.
Drag	Hold one finger, then move and lift to release; or choose three-finger dragging in settings.	The target stays held until release.
Back and forward	In three-finger Navigation mode, swipe quickly right for back or left for forward.	The active app moves through supported history.
Switch tabs	Choose three-finger tab switching; swipe quickly left for the next tab or right for the previous one.	The active window changes its tab.
Desktops and windows	Default four-finger left/right swipes switch desktops; up opens Mission Control, down opens the current app’s windows.	A neighboring desktop, full-screen app, or window overview appears.

Three-finger navigation and tab switching require a quick swipe; a slow drag may not trigger them. Choose the three-finger Drag mode before expecting that gesture to drag. Four-finger actions can be disabled separately.

When a keyboard shortcut does nothing

Back/forward uses Command + [ / ], tab switching uses Control + Tab / Control + Shift + Tab, and desktop/window actions use Control + an arrow key. Bring the target app to the front, then test the same shortcut on the Mac keyboard. If it fails locally too, check the app’s support and macOS keyboard shortcut settings.

Desktop switching needs a neighboring desktop or full-screen app. Keyboard controls here are supported shortcuts, not full text entry from the phone. Four-finger actions trigger a shortcut rather than a continuous native desktop animation.

Grant the permission for the action you use

Permission on the Mac	Why it matters	How to verify
Local Network	Lets the devices discover and reach each other.	Confirm the Mac appears online in the phone app.
Accessibility	Allows supported pointer, keyboard, and system actions.	Try a simple action while watching the Mac.
Automation	Lets Dock control supported media apps.	Open your player and test play/pause.

Dock’s Preferences → Permissions links to the relevant System Settings pages. A connected indicator confirms the connection; it does not prove that every macOS permission has been granted.

Diagnose the symptom

Camera fails or the QR cannot be read: Check camera permission on the phone, show a fresh QR on the Mac, and keep its window open. If the apps report incompatible versions, update both before scanning again; do not retry legacy manual codes.

Connected but the pointer does not move: In macOS System Settings → Privacy & Security → Accessibility, verify that access belongs to the currently installed iPocketDock. Recheck permission as directed by the app, then test mouse mode again.

The Mac never appears: Confirm Dock is running, check Local Network permission on both devices, and try a trusted non-guest network. VPN or firewall rules may change which local devices are reachable; check those rules without disabling protections wholesale.

The QR code is accepted but pairing does not finish: Generate a fresh code, keep both apps in the foreground, finish the phone-side prompts, and check that the two installed versions are compatible.

Volume works but another action fails: Check the permission associated with that action. For a media control, also verify that the intended player is open and selected.

Control stops after sleep or a long background period: Wake the Mac, reopen iPocketRemote, and verify the online state before sending another command. If it remains offline, reopen Dock’s device view and reconnect. Avoid rapidly queuing repeated commands while the connection is recovering.

Keep proximity locking separate

Dock’s Bluetooth walk-away locking is a separate workflow from phone pairing. Configure the Bluetooth device and test its behavior at your desk before enabling automatic actions. See the Dock proximity setup notes for signal stability and permission checks.