How to Use the Handy with Funscripts

Step-by-step guide to using the Handy with funscripts in HaptiQ via The Handy over Wi-Fi (any browser, including iPhone) — plus how script motion maps to this onahole.

The Handy connects to HaptiQ over Wi-Fi with its connection key, so there is no Bluetooth pairing and it works in any browser, including Safari on iPhone and iPad. HaptiQ uses HDSP mode and sends position commands.

What The Handy supports

From Buttplug’s device config (v4.198), built into HaptiQ:

Stroke (position): Position output. HaptiQ sends a timed move for every action in the script, so the toy goes to the scripted position in the scripted time.

Connect The Handy over Wi-Fi

Set The Handy up on Wi-Fi with The Handy’s own app first. Its Wi-Fi light should be blue.
Copy the connection key from The Handy app.
In HaptiQ, open Devices, find The Handy (Wi-Fi), paste the key and press Connect.
Run Device Doctor once: it checks the toy is online, switches it to HDSP mode if needed, and measures the round trip so it can set the sync offset.
Buttplug’s config also lists Bluetooth for firmware 4 units, but Wi-Fi is the route HaptiQ supports on every platform.

Device Doctor fixes

Bluetooth is off: Device Doctor checks this first. On Windows turn it on in Settings → Bluetooth & devices; on a Mac use Control Centre; on Android pull down the quick settings. Then press Connect toy again.
Bluetooth permission was blocked: Click the icon left of the address bar → Site settings and allow Bluetooth for haptiq.app. On Android, allow Nearby devices for Chrome (Settings → Apps → Chrome → Permissions) or for the HaptiQ app.
The Bluetooth list is empty: The toy is not advertising. Usual causes: it is off or asleep, it is still connected to the maker’s app or your phone, or it is too far away. Wake it, close the other app, keep it within a metre and press Connect toy again. If the list is still empty, run Device Doctor and press Send diagnostic log so the case can be checked.
Found, but it does not answer or keeps dropping: Close every other app that might hold the toy (the maker’s app, Lovense Remote, Intiface), turn the toy off and on, charge it, and keep it close. Device Doctor reconnects it and runs a feel test. For JoyHub toys, Advanced → Classic Bluetooth mode is a second path if the first one stalls.
Wrong mode: The Handy must be in HDSP mode for web playback; Device Doctor switches it for you. Some JoyHub models show “This model runs smoother in Classic Bluetooth mode” after connecting; press Switch.
Connected, but nothing moves: Run Device Doctor: it sends a test command and asks whether you felt it. Also check the part of the script you are playing actually moves; a flat section of a funscript produces genuine stillness.

Open Device Doctor

Sync offset calibration

Connect the toy, then open Device Doctor (Devices → Device Doctor, or haptiq.app/devices?doctor=1).
Let it run to the Sync calibration step. It measures how late the toy acts and saves that as the toy’s sync offset, so commands go out that many milliseconds early.
If the lag cannot be measured, HaptiQ uses the typical offset other owners of the same toy calibrated, or none at all; the Doctor says which.
The offset is stored per toy and per connection type (built-in Bluetooth, Intiface, Wi-Fi), within ±1000 ms. Run the Doctor again after you change how the toy connects.
Steady lag is what an offset fixes. Lag that comes and goes is signal: move closer, charge the toy, and keep 2.4 GHz Wi-Fi traffic away from it.

The Handy questions

Why does The Handy say it is in the wrong mode?

Web playback needs HDSP. Device Doctor switches it for you; if the message comes back, restart The Handy and run the Doctor again.

Does The Handy work on iPhone?

Yes. It connects over Wi-Fi, not Bluetooth, so it works in Safari and every other iPhone browser today.

All The Handy devices · All brands

Troubleshooting

Why won't my The Handy show up when I try to connect?

Three things account for almost every case. First, the browser: Web Bluetooth exists only in Chrome, Edge, Opera and other Chromium browsers, so in Safari or Firefox the device can never appear no matter what you do. Second, an existing connection: Bluetooth LE toys accept one connection at a time, so close the manufacturer app and disconnect it from your phone first. Third, pairing mode — most units need a button held until the LED changes before they advertise at all.

Do I need to install anything to use the Handy with HaptiQ?

No. BT4LE or WiFi is reachable from the browser, so there is nothing to install — no Intiface Central, no desktop app, no driver. If a guide tells you otherwise it is describing a different connection type.

The script plays but the device doesn't move. What's wrong?

The connection and the script are separate steps, and this symptom means the script is fine but commands are not arriving. Confirm the device still shows as connected — browsers drop a Bluetooth link when the tab is backgrounded on some platforms — then check the device is charged and not simultaneously connected somewhere else. A funscript with a flat section will also produce genuine stillness, so scrub to a section with obvious motion before concluding it is broken.

Why is the motion out of sync with the video?

A direct Bluetooth LE link is one of the shortest paths available, so a fixed delay should be small. If it is consistent, correct it with your player offset. If it comes and goes, that is radio interference rather than latency: 2.4 GHz is shared with WiFi, so move closer, remove obstacles, and charge the device — weak batteries cause sluggish response well before a device dies.

Can I use the Handy with funscripts I did not make myself?

Yes. A funscript is a plain motion file and carries no device information, so any script plays on any supported hardware. HaptiQ can also generate one from your own video, which matters when an existing script was timed to a different cut — that mismatch causes drift no offset can fix.

The Handy overview · Funscripts for strokers & masturbators · Create a free HaptiQ account

Open in HaptiQ