Virtual Keyboard · Getting started

Virtual Keyboard turns your iPhone or iPad into a keyboard, trackpad and remote for your Mac. The first connection usually takes about two minutes.

Before you start

  • Mac: macOS 14 or later, on Apple Silicon or Intel.
  • iPhone or iPad: iOS / iPadOS 15 or later.
  • Install eTouch (the menu bar app) on the Mac and Virtual Keyboard on the phone.
  • The Mac app needs Accessibility permission; the phone needs Bluetooth and Local Network access.
  • Choose one connection: Bluetooth, LAN on the same Wi-Fi, or a data-capable USB cable.

The iOS app is in preparation for the App Store. Once released, install it from the App Store. The Mac app is not distributed through the Mac App Store; download it from this site.

Install the Mac app

  1. Open the Downloads page and get the latest eTouch package.
  2. Open the DMG and drag eTouch into Applications.
  3. Launch eTouch. On first launch it asks for Accessibility permission.
  4. Open System Settings → Privacy & Security → Accessibility, find eTouch and turn it on.
  5. If input still does not work, quit eTouch and open it again.

eTouch stays in the menu bar and listens on Bluetooth, LAN and USB at the same time. As long as it is running, the phone can connect.

Install the iOS app

  1. Install Virtual Keyboard from the App Store (release in preparation).
  2. Allow Bluetooth and Local Network on first launch.
  3. Keep the app in the foreground with the screen on; locking the phone or switching apps disconnects input.

First connection

Bluetooth

  1. Make sure eTouch is running on the Mac.
  2. On the phone home screen, choose Bluetooth.
  3. The Mac menu bar or eTouch window shows a 6-digit pairing code.
  4. Enter the code on the phone. The Mac is remembered and reconnects automatically next time.

LAN

  1. Connect the phone and Mac to the same Wi-Fi.
  2. On the phone home screen, choose LAN.
  3. Wait for Bonjour to find nearby Macs and select yours.
  4. Enter the 6-digit code shown on the Mac.

Discovery needs Local Network permission. VPNs, guest networks and router isolation can block it.

USB cable

  1. Connect the phone and Mac with a data-capable Lightning or USB-C cable.
  2. Unlock the phone and choose Trust if the system asks whether to trust the computer.
  3. The phone detects the USB tunnel and switches to it automatically. No pairing code is needed.

When you plug the cable in during a wireless session, the app switches from Bluetooth or LAN to USB. If the cable is removed and no connection returns within four seconds, it falls back to the previous wireless mode.

Universal Bluetooth (lab)

Universal Bluetooth turns the phone into a standard Bluetooth HID device, so the target does not need eTouch. It is off by default: enable it under Settings → Lab Features → Universal Bluetooth, then choose that mode on the phone's connection page.

On the Mac, open System Settings → Bluetooth and connect to the device named like VK-<phone name>. The first connection is manual. Clipboard, dictation, non-ASCII text keys and some media keys are unavailable in this mode; it is best for basic keyboard and mouse input.

Home screen and pages

  • The top of the home screen shows connection state, the current input target and latency.
  • The Trackpad, Keyboard, AI Remote and Gamepad cards open their pages.
  • Connection Management switches transports, lists nearby or paired Macs, and shows diagnostics.
  • Settings covers appearance, device role, start page, multiple Macs and lab features.

Keep the connection alive

  • The phone app must stay in the foreground. Locking the phone, switching apps or system suspension disconnects it.
  • Bluetooth and LAN reconnect automatically after pairing. If you choose Disconnect manually, it stays disconnected for the rest of the session.
  • After a Mac or eTouch restart, the phone tries to reconnect to the Mac it used last.

Next