Buttplug.io and Intiface Central Setup Guide for Funscripts

How to set up Buttplug.io and Intiface Central for haptic device control. Works with 800+ devices and all browsers including Firefox and Safari. Step-by-step guide with troubleshooting.

Buttplug.io is an open-source protocol for controlling intimate devices, and Intiface Central is the desktop app that implements it. Together they let any browser — including Firefox and Safari — control 800+ Bluetooth, USB, and serial devices. HaptiQ has a built-in Buttplug.io client that connects to Intiface in seconds.

Why Use Buttplug.io Instead of Web Bluetooth?

Web Bluetooth only works in Chrome and Edge. If you prefer Firefox or Safari, or if your device doesn't advertise the right BLE service UUIDs for Web Bluetooth, Buttplug.io via Intiface Central is the answer. Intiface runs locally on your computer, handles Bluetooth pairing, and exposes a WebSocket API that HaptiQ connects to.

Buttplug.io also supports USB and serial devices that Web Bluetooth cannot reach, expanding compatibility to older toys and PC-connected hardware.

Installing Intiface Central

  1. 1. Visit intiface.com/central and download the installer for Windows, macOS, or Linux.
  2. 2. Run the installer and launch Intiface Central. The app opens to a dashboard showing server status and connected devices.
  3. 3. Click Start Server. Intiface opens a WebSocket server on port 12345 by default.
  4. 4. Click Scan for Devices. Intiface will scan Bluetooth and USB for compatible devices.
  5. 5. Your device should appear in the device list within 5–15 seconds. Click it to verify it responds.

Connecting HaptiQ to Intiface Central

  1. 1. Open HaptiQ in any browser (Firefox, Chrome, Safari, Edge — all work with Buttplug.io).
  2. 2. Open the Device panel and select Buttplug.io as the connection method.
  3. 3. The WebSocket address defaults to ws://localhost:12345. Click Connect.
  4. 4. HaptiQ will list all devices detected by Intiface. Select your device to confirm it's active.
  5. 5. Load a funscript and press play. Your device syncs to the script's keyframes in real time.

Common Buttplug.io Issues

Device not found after scanning: Make sure the device is powered on and in pairing mode. Some devices need to be "forgotten" from your OS Bluetooth settings before Intiface can claim them.

WebSocket connection refused: Intiface Central's server must be running before HaptiQ connects. Click Start Server in Intiface if the status shows "Stopped".

Device appears but doesn't respond: Some firmware versions need updating. Check the device manufacturer's app for firmware updates, then reconnect in Intiface.

High latency on funscript sync: Close other applications using Bluetooth. A dedicated USB Bluetooth 5.0 dongle placed near the device significantly reduces latency on Windows machines.

Frequently asked questions

What is Buttplug.io and do I need it to use HaptiQ?

Buttplug.io is a free open-source protocol that provides a universal abstraction layer for 800+ intimate haptic devices. Intiface Central is the desktop app that implements the protocol and exposes a local WebSocket server. HaptiQ has a built-in Buttplug.io v3 raw WebSocket client (no npm dependency) that connects to Intiface in about 3 seconds. You do not strictly need Buttplug.io — HaptiQ can connect directly via Web Bluetooth in Chrome and Edge without any middleware. But Buttplug.io is the right choice for Firefox or Safari users (which do not support Web Bluetooth), for devices with niche or proprietary protocols that need Intiface drivers, or for setups where you want a single middleware handling multiple apps that all control the same device.

How do I set up Intiface Central to work with HaptiQ?

Download Intiface Central from intiface.com/central — free, available for Windows, macOS, and Linux. Install and launch it. On first run, grant Bluetooth permission when the OS prompts. Click the start button (top right) to launch the WebSocket server on the default port 12345. In HaptiQ, go to Devices, click "Connect via Buttplug," and HaptiQ automatically finds the local Intiface server. In Intiface Central, click "Scan for Devices" — put your device in pairing mode and it appears in the list. Once connected in Intiface, it appears in HaptiQ device panel as well. You can close the Intiface window but leave it running in the background. Total setup time is typically under 2 minutes including the download. Reconnections on subsequent sessions happen automatically if the device is in range.

Which devices work with Buttplug.io and Intiface?

Buttplug.io supports over 800 devices across every major manufacturer — Lovense (Max 2, Nora, Lush 3, Hush 2, Domi 2, Edge 2, Gush, Diamo, Solace Pro), Kiiroo (Keon, TITAN, Onyx+, Pearl 2, Cliona, PowerBlow), WeVibe (Chorus, Sync, Vector, Melt), Satisfyer (Curvy, Pro, Double Joy), Svakom (Alex Neo, Ella Neo), XInput vibration devices, and many serial-connected multi-axis rigs like the OSR2+. The full device-support matrix is maintained at iostindex.com and also mirrored in HaptiQ own 872-device IoST index. Some proprietary devices (older Fleshlight Launch, some first-gen Lelo) do not have Buttplug drivers and must use vendor-specific apps. The Handy does not use Buttplug — it connects over WiFi via its own cloud API with HAMP/HDSP/HSSP modes, which HaptiQ supports natively.

Why does HaptiQ support Buttplug.io if Web Bluetooth already works?

Four reasons. First, browser compatibility: Web Bluetooth only works in Chrome and Edge. Firefox and Safari users need Intiface, and together they are roughly 25 percent of desktop browsing. Second, device coverage: some devices need specific Buttplug drivers the browser cannot provide — older Lelo products, certain serial multi-axis rigs, and niche devices like the OSR2+ require the full protocol stack. Third, reliability: Web Bluetooth has a known issue where backgrounded browser tabs stall connections after 5–10 minutes, whereas Intiface runs natively and stays connected indefinitely. Fourth, multi-app use: with Intiface running, HaptiQ, MultiFunPlayer, and ScriptPlayer can all see the same device without fighting for the BLE connection. HaptiQ recommends Web Bluetooth for speed and Buttplug.io for compatibility — the choice is yours.

Create a free HaptiQ account to generate a funscript from your own video.

Open in HaptiQ