iOS Connection Issues
Having trouble connecting your iPhone or iPad? This page covers common Bluetooth pairing and connection problems for each platform.
For Windows Users
Due to a Windows Bluetooth limitation, you may find that after successfully pairing your iPhone or iPad, the connection no longer works the next time you launch the app.
Workaround — re-pair before reconnecting:
- Open Bluetooth settings on your PC
- Find and remove the paired device (it may appear as
VT-HIDor your iOS device name) - Pair again by selecting the device named
VT-HID - Return to the app and connect again
If the old pairing still appears on your iOS device, remove it there as well and start the pairing process from scratch.
We apologize for this inconvenience. This is a known limitation of how Windows handles Bluetooth HID devices, and we are working to improve it in a future update.
Tip: If you switch the app to the background briefly and bring it back to the foreground, the connection may restore automatically — as long as the app hasn’t been fully closed.
Quick Check for Any Platform
If the connection fails or your computer does not appear in the scan list, try turning Bluetooth off and back on again on both devices before pairing again.
For Mac Users
- Same Apple Account is required — Your Mac and your iPhone or iPad must be signed in to the same Apple Account. If they use different accounts, your Mac may not appear in the scan results and you will not be able to connect.
- Duplicate device names in scan results — If you see multiple devices with the same name, try connecting to a different one until you find the correct one.
- Connection not working after a previous attempt — Remove the existing Bluetooth pairing and try again:
- On your iPhone or iPad, go to Settings → Accessibility → Touch → AssistiveTouch → Devices → Bluetooth Devices
- Tap the
ⓘbutton next to the target device, then tap Forget This Device - Re-open the VirtualTablet: Bluetooth app and connect again
- Still not connecting — Try rebooting both your iPhone/iPad and your Mac to reset the Bluetooth state.
For Linux Users
For Ubuntu 25 and newer, you don’t need to do anything - it just works.
But for older Ubuntu releases (20~24), you need to check Bluez configuration.
-
Step 1 — Enable HID plugins in BlueZ
sudo nano /etc/bluetooth/main.conf-
Add:
[General] Enable=HID Experimental=true
-
-
Step 2 — Restart Bluetooth
sudo systemctl restart bluetooth -
Step 3 — Load HIDP (classic HID) kernel driver
sudo modprobe hidp-
Persistent load:
echo hidp | sudo tee -a /etc/modules
-
-
Step 4 — Repair/pair your device