Connections and troubleshooting
Check these first; they locate most problems:
- Is eTouch running on the Mac, with its menu bar icon visible?
- Has macOS granted eTouch Accessibility permission?
- Has the phone allowed Bluetooth and Local Network access?
- Is the phone app in the foreground with the screen on?
- Does the selected transport match the link the Mac is using?
Bluetooth will not connect
- Make sure eTouch is running. The Mac initiates Bluetooth connections; the phone cannot scan for Macs.
- Press Reconnect in Connection Management, or turn Bluetooth off and on again on the Mac.
- Remove the old pairing record and pair again; you will need the 6-digit code shown on the Mac.
- If many Bluetooth devices are nearby, turn off the ones you do not need to reduce 2.4GHz interference.
- The connection interval is controlled by the Mac. If latency suddenly rises, check whether the Mac is using Bluetooth audio or many peripherals.
LAN cannot find the Mac
- Make sure the phone and Mac are on the same Wi-Fi, not a guest network, and that client isolation is off.
- Check Settings → Privacy & Security → Local Network and allow Virtual Keyboard.
- Turn off VPNs, proxies or security tools that block mDNS and try again.
- Confirm eTouch is running and the Mac firewall is not blocking it.
- LAN reconnects automatically only to the last Mac used. Other Macs must be selected under Available Devices.
- If discovery still fails, connect a USB cable and bypass the network.
The USB cable does nothing
- Try a data-capable cable. Charge-only cables do not work.
- Unlock the phone and choose Trust if the system asks whether to trust the computer.
- Confirm eTouch is running on the Mac.
- Plugging in should switch the phone from wireless to USB automatically. If the state does not change, choose USB once in Connection Management.
- If the cable is removed and no connection returns within four seconds, the app falls back to the previous wireless mode. If it stays on USB, check the cable and port.
Pairing code problems
- The 6-digit code is shown in the Mac menu bar, eTouch popover or main window.
- A wrong code shows how many attempts remain. When it expires or runs out, press Get a new code to have the Mac generate another.
- If the Mac still has an old pairing record, remove it first under Settings → Connection → Paired Devices, then pair again.
The Mac receives no input
Check these in order:
- Accessibility permission: open System Settings → Privacy & Security → Accessibility and make sure eTouch is on. If it still does nothing after granting, quit and reopen eTouch.
- Secure Input: when a password field, sudo, an authorisation panel or Terminal Secure Keyboard Entry is active, macOS discards synthetic keys. The keyboard page shows a lock; use the Mac keyboard or Universal Bluetooth instead.
- Login window / FileVault: not supported. Sign in first.
- Foreground state: locking the phone, switching apps or system suspension disconnects. Return to the app and wait for reconnection.
- Target Mac: with several Macs connected, make sure the target row points at the one you are using.
- Keyboard page focus: confirm you are on the keyboard page, not the trackpad page. If keys give feedback but the Mac receives nothing, check Accessibility and Secure Input first.
The trackpad does not move or gestures misbehave
- Make sure the trackpad page is in the foreground and you are not triggering a system edge gesture or the Home bar.
- Four and five-finger gestures need enough distance and time; too fast or too small may not trigger.
- On phones without pressure sensing, hold to drag instead of expecting a light press.
- A two-finger horizontal swipe scrolls by default. For Back / Forward, enable Compatibility Mode in trackpad settings.
- Palm rejection can treat a large edge contact as a palm. Change your grip or adjust the setting.
Latency or stutter
- Prefer USB first, then LAN on the same Wi-Fi, then Bluetooth.
- On LAN, keep the phone and Mac near the router, prefer 5 GHz, and pause large downloads or video streams.
- Turn off VPNs, proxies and network tools that scan the LAN.
- Lower pointer acceleration or disable touch effects in trackpad settings; enable Performance Mode in General settings.
- Bluetooth latency depends on the Mac-side connection interval. If Bluetooth audio is in use, try wired audio or enable Bluetooth Audio Priority.
Disconnects, locking and backgrounding
- The phone app must stay in the foreground with the screen on. Locking it, switching apps, an incoming call or another app taking the foreground can disconnect.
- Turn on Keep Screen Awake under Settings → General to prevent automatic locking.
- After choosing Disconnect manually, the app will not auto-reconnect this session. Choose a transport again or restart the app.
- After the Mac sleeps, eTouch quits or restarts, the phone retries with backoff; wait or press Reconnect.
Universal Bluetooth problems
- Universal Bluetooth is off by default. Enable it under Settings → Lab Features.
- The host must connect to
VK-<phone name>from its own Bluetooth settings. A Mac needs one manual connection the first time, then reconnects automatically. - If the phone says connected but the host receives nothing, press Re-broadcast first; if that fails, turn Bluetooth off and on again on the host.
- After reinstalling or restarting the app, macOS may cache the old HID descriptor. Ignore the old record in Bluetooth settings and pair again.
- Clipboard, dictation, non-ASCII text keys and some media keys are unavailable in Universal Bluetooth. Switch to Bluetooth, LAN or USB when you need them.
- Horizontal scrolling is off by default. Enable it in Connection Management; the host must reconnect.
Multiple Macs or phones
- One phone can remember several Macs. Switching the target releases keys held on the old Mac first.
- One Mac can accept several phones. If input goes to the wrong phone, check the target row and the Auto-switch Input Target setting.
- In Universal Bluetooth with several hosts, input follows the Default Host. Change it in Connection Management.
Still stuck
Use the feedback page and include:
- Phone model and iOS / iPadOS version.
- Mac model, macOS version and eTouch version.
- The transport in use (Bluetooth, LAN, USB or Universal Bluetooth).
- What happens, when it started and whether it reproduces reliably.
- If possible, the link, encryption, target, latency and Secure Input rows from Diagnostics in Connection Management.
Do not include passwords, pairing codes or other sensitive content.