Pocket Keys

Support

Set up your small deck.

Pair once, choose your three actions, and keep the keys close.

Connect to your Mac.

  1. Open Pocket Keys on your iPhone.Allow Bluetooth permission and keep the app open.
  2. Open System Settings → Bluetooth on your Mac.Make sure Bluetooth is on. Find Pocket Keys or your iPhone’s name in nearby devices. The name may come from iPhone Settings → General → About → Name.
  3. Choose Connect and approve any pairing prompts.If codes appear, compare them before approving on both devices. Discovery and pairing can take a moment.
  4. Focus the Mac app you want to use.Click inside a document or other target on your Mac, then press a key in Pocket Keys.

Keep the iPhone app in the foreground. It must stay open while you use the keys. The screen stays awake while the app is in the foreground; normal Auto-Lock returns when you leave. Background operation is not offered. No companion app, driver, or account is needed on your Mac.

The connected status indicates that the Mac has subscribed to keyboard input. The iPhone cannot see whether the Mac’s app completed the action.

Assign an action.

Tap Edit, choose the keycap you want to change, and swipe through the action cards. Tap Assign to this key to return to the deck.

For your own shortcut, choose Create Custom Action. Add a short name and symbol, then choose a single key, keys pressed together, or a sequence of up to three steps. Names may contain up to 20 characters; very wide names may need to be shorter to fit.

Use Try it while the correct Mac app is focused. Check the result on the Mac, then save and assign. Key combinations are chosen on the iPhone; the app cannot automatically record what you press on your Mac keyboard.

The positions stay fixed during use. In Edit, you can choose which action occupies the large key. Action names and key combinations are saved on the iPhone.

Adjust the press.

Open Edit → More → Key feel to turn key sounds and haptics on or off. The Test key auditions feedback locally and sends no keys to your Mac.

Key sound follows your iPhone’s silent mode and plays without taking over other apps’ audio. If you hear no sound, check the silent switch or silent-mode setting, the iPhone volume, and any connected audio output.

When keyboard input is unavailable, the app gives a connection instruction instead of the normal sending response. Press feedback describes what happens on your iPhone; it is not a receipt from the Mac app.

Reconnect.

The Mac cannot find my iPhone.

Keep Pocket Keys visible on the iPhone and check that Bluetooth is on at both ends. Look for both the app name and your iPhone’s system name. Nearby-device lists may take time to refresh. If you see similar iPhone names, approve a pairing prompt only when it appears on the iPhone you intend to use.

It was paired before, but keys do not work.

Open the iPhone app again and check its connection state. Focus your target app on the Mac. If needed, open the Mac’s Bluetooth Settings and reconnect the existing iPhone entry. A paired Mac may reconnect automatically, so disconnecting can be temporary.

If reconnecting still fails, remove the pairing on both devices: use Forget This Device beside the Mac in iPhone Bluetooth Settings, and remove the iPhone from the Mac’s Bluetooth Settings. Return to Pocket Keys and repeat pairing. Deleting the app is not required and does not clear system pairing records.

The key is sent, but the action is different from what I expected.

Pocket Keys for Mac sends keyboard input to the Mac’s focused app. App-specific shortcuts, keyboard layouts, and input sources can change the result. Check the chosen combination on your Mac, then edit the action on your iPhone if needed. The iPhone does not read the Mac screen or report command completion.

Does it work with Windows?

Windows is not supported in this release. The product is intended for a nearby Bluetooth-enabled Mac. Do not purchase it for a Windows workflow.

What happens to my saved actions?

They remain in the app’s local storage when you close and reopen it. Deleting the app removes that installation’s data; system backups may retain or restore it. Pairing records are separate operating-system settings. See the privacy policy for details.

Get help.

Pocket Keys for Mac is provided by JONGMIN CHOI.

Include your app version, iPhone model and iOS version, Mac model and macOS version, and the connection message you see. Tell us whether this is first pairing or a reconnect.

A screenshot can help. Share only the parts needed to explain the issue; hide personal device names or unrelated document content if you prefer.

Contact support on GitHub

Support requests are public. Your GitHub profile, message, and attachments can be read by the developer and others. Posting requires a GitHub account. Share only the details needed to explain the issue; do not post passwords, pairing codes, private documents, or other sensitive information.

For privacy questions or a request to remove support content, use the same support channel and identify the issue without repeating sensitive details. See website and support privacy.