iOS Connection Issues

Having trouble connecting your iPhone or iPad? This page covers common Bluetooth pairing and connection problems for each platform.

⚠️
Most important note for Windows users: after your iOS device is paired once, Windows may fail to reconnect the next time you launch the app. In many cases, you must remove the existing pairing and pair again before reconnecting.

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:

  1. Open Bluetooth settings on your PC
  2. Find and remove the paired device (it may appear as VT-HID or your iOS device name)
  3. Pair again by selecting the device named VT-HID
  4. 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:
    1. On your iPhone or iPad, go to Settings → Accessibility → Touch → AssistiveTouch → Devices → Bluetooth Devices
    2. Tap the button next to the target device, then tap Forget This Device
    3. 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


Still Having Issues?

💬
Can’t solve your problem? Please contact us to get help. See Support page for details.