Install
On the iPhone
Install Handy Mouse from the App Store (iPhone · iOS 17 or later). Open the App Store listing.
On the Mac
- Download Handy Mouse Receiver (Mac · macOS 14 or later) from the download page, drag it into Applications and eject the disk image. Always open it from Applications: a copy opened straight from the download cannot reopen after a restart.
- Open it. macOS asks for Accessibility access: choose Open System Settings, then switch Handy Mouse Receiver on in System Settings › Privacy & Security › Accessibility. Without it the pointer will not move.
- A mouse icon appears in the menu bar. Click it for status, connected phones and the pairing code.
- In the same menu, make sure Open at login is ticked. It is on by default, and it starts the receiver with your Mac, so the phone finds it after every restart. If it will not stay ticked, switch Handy Mouse Receiver on in System Settings › General › Login Items. If it is greyed out, the receiver is running from the download: click Move to Applications at the top of the menu.
Connect, once
Quickest: on the computer, open the receiver’s menu and choose Show pairing code. Scan it with the iPhone’s Camera app (tap the Handy Mouse banner) or in Handy Mouse › Computers › Scan pairing code. No dialog to confirm, and it works even on networks that hide the computer from Bonjour.
Or: open Handy Mouse, tap your computer in the list, and click Allow on the computer after checking that the six‑digit code matches the one on the phone. From then on the phone finds this computer and reconnects by itself.
Unlock the pointer and keyboard
Installing, pairing and connecting are free. Using the pointer and keyboard needs a one‑time unlock (US$4.99 in the United States; the app shows the price in your currency). There is no trial and no subscription.
- When your computer is connected and allows pointer control, the unlock sheet opens and the computer’s pointer draws one small circle. That circle is the proof that everything works; Show the circle again repeats it.
- No circle? Do not buy yet. On a Mac, check pointer control first; otherwise see the sections below.
- Until you unlock, the mouse shows a lock panel. Tap it, or open Settings › Unlock, to buy.
- Bought before, or on another iPhone with the same Apple Account? It unlocks by itself; if it does not, tap Restore purchase in Settings › About or on the unlock sheet.
- Refunds are handled by Apple at reportaproblem.apple.com.
Using the mouse
- Slide on the touchpad to move; tap to click; tap, then press and slide to drag.
- Two fingers scroll (natural direction, adjustable in Settings). A two‑finger tap is a right click; a three‑finger tap is a middle click.
- The wheel between the buttons scrolls when dragged and middle‑clicks when tapped. The Left and Right buttons support press‑and‑hold.
- Settings (slider icon, top right) has pointer speed, acceleration, tap‑to‑click, palm rejection, touch prediction, scroll speed and direction, haptics, the peer‑to‑peer Wi‑Fi switch and the ten looks.
The computer is not in the list
- Easiest fix: scan the pairing code. It carries the computer’s address, so it connects even where Bonjour cannot see the computer.
- Make sure the receiver is running: look for the mouse icon in the menu bar. This is by far the most common cause, for example after a restart with Open at login off.
- Mouse icon gone after the Mac restarted? Open Handy Mouse Receiver from Applications (drag it there from the download first if it is not there, and eject the disk image). Then click the mouse icon and check that Open at login is ticked. If it was already ticked, untick and tick it again, so it points at the copy in Applications. If it will not stay ticked, switch Handy Mouse Receiver on in System Settings › General › Login Items.
- Tap Look again on the phone. Both devices should be on the same Wi‑Fi (not a guest network, no VPN on either side).
- On the phone, Local Network must be allowed for Handy Mouse; the Computers sheet shows a red notice with a Settings button when it is not.
- Check that the Mac’s firewall is not blocking incoming connections for the receiver.
- Bluetooth needs none of the network: turn Bluetooth on both devices and give the receiver Bluetooth permission on the Mac.
- Without any shared network, turn on Peer‑to‑peer Wi‑Fi on both the phone (Settings) and the Mac (menu).
Connected, but the pointer does not move
On a Mac, Accessibility is not switched on for the receiver. The phone shows an amber blocked state, and the moment input arrives the receiver opens System Settings › Privacy & Security › Accessibility for you: switch Handy Mouse Receiver on there. Allow Pointer and Keyboard… in the menu bar panel opens the same page. The phone turns green by itself within a few seconds, with no restart. Switched on, but still nothing moves? Click Switched on, but still not working? under that button: it clears the entry an earlier copy of the receiver left behind and asks again.
The pointer lags, stutters or pauses
- Look at the footer on the phone. UDP and a round trip under about 20 ms is healthy. TCP means the UDP port is blocked by a firewall on the computer; p2p means the direct Wi‑Fi link is in use, which is jumpier.
- Prefer the router’s 5 GHz band on both devices. 2.4 GHz is crowded and shares the radio with Bluetooth. The Mac’s menu bar panel shows which band it is on under Pointer link.
- If the footer says wi‑fi pausing: the Mac is probably on battery (macOS saves Wi‑Fi power; plug it in), on 2.4 GHz, or scanning other channels because of AirDrop receiving, Handoff or an open Wi‑Fi menu. Turn AirDrop receiving off while you use the mouse.
- Or tap Use Bluetooth instead in Computers. Bluetooth sits at a steady 20–30 ms and does not depend on Wi‑Fi at all. The app keeps preferring Bluetooth for that computer until you tap Back to Wi‑Fi.
- Keep Peer‑to‑peer Wi‑Fi off unless you need it: while the direct link is up, the Mac’s Wi‑Fi hops channels and everything stutters.
The codes do not match
Click Don’t Allow. Something on the network is interfering with the connection. Try again, ideally over Bluetooth or on a network you trust. Matching codes are how you know nothing sits between the phone and the computer.
Forget and uninstall
- On the phone, Settings › Forget this computer disconnects, deletes the pairing key and stops automatic reconnects. The computer asks to allow the phone again next time.
- On the computer, Forget next to a phone in the receiver’s menu does the same from that side.
- To uninstall the receiver, quit it from its menu and drag Handy Mouse Receiver from Applications to the Trash. Turn off Open at login first if you want to keep the app around without it running.
Still stuck
Write to hengsamkok76@gmail.com with your iPhone and computer versions and what the phone’s footer shows. The contact page has a template.