Intiface Central is a device control server for Buttplug-compatible devices (vibrators, e-stim, toys). This add-on runs it with a browser WebGUI, MQTT bridge and Home Assistant MQTT Discovery — no VNC, no X11.

On aarch64 (Raspberry Pi 4/5), the x64 intiface-engine binary runs via box64 emulation.

#Wiki Pages

Page	Purpose
Installation	Add repository, install, configure MQTT, start.
Architecture	Component map, MQTT bridge, WebGUI.
MQTT & HA Entities	Topics, auto-discovery, HA integration.
Device Support	Bluetooth LE, USB/HID, Lovense.
Troubleshooting	Bluetooth, box64, WebGUI issues.

#Minimum Operating Model

Browser        → WebGUI :12346
HA Automation  → MQTT → mqtt-bridge → Node.js → intiface-engine :12345
Bluetooth/USB  → Host kernel → intiface-engine

┌──────────────┐      ┌───────────────────────────────────┐
│ Browser      │─────▶│ WebGUI /api/* + SSE  :12346       │
└──────────────┘      └───────────────┬───────────────────┘
                                      │ Node.js
┌──────────────┐      ┌───────────────▼───────────────────┐
│ HA MQTT      │─────▶│ mqtt-bridge                       │
│ Automations  │      │ → device/motor → vibrate commands │
└──────────────┘      └───────────────┬───────────────────┘
                                      │
                      ┌───────────────▼───────────────────┐
                      │ intiface-engine :12345             │
                      │ (x64 on amd64 | box64 on aarch64) │
                      └───────────────┬───────────────────┘
                                      │
                      ┌───────────────▼───────────────────┐
                      │ Bluetooth LE + USB/HID             │
                      │ via host kernel passthrough        │
                      └───────────────────────────────────┘

#box64 on Raspberry Pi

The intiface-engine binary is x64-only. On aarch64 hosts, it runs via box64 x86_64 emulation. Bluetooth and USB run natively through the host kernel — no performance penalty for device communication.

#Step 1 — Add Repository

1. Open Home Assistant.
2. Go to Settings → Add-ons → Add-on Store.
3. Open ⋮ → Repositories.
4. Add:

https://github.com/pol4rfuchs/ha-apps

#Step 2 — Install

1. Search for Intiface Central.
2. Click Install and wait — the add-on builds locally (no pre-built image).

#Step 3 — Configure MQTT (Optional)

If you want MQTT integration, configure in the Configuration tab:

mqtt_host: "core-mosquitto"
mqtt_port: 1883
mqtt_username: "your_user"
mqtt_password: "your_password"
mqtt_discovery: true

#Step 4 — Start

1. Click Start.
2. Click Open Web UI — WebGUI opens at port 12346.

#MQTT Topics

Each device and motor is published as an MQTT topic:

intiface/devices/<device_id>/motor/<motor_index>/vibrate

Publish a value between 0.0 and 1.0 to control vibration intensity.

# Example: set device 0, motor 0 to 50% intensity
mosquitto_pub -t "intiface/devices/0/motor/0/vibrate" -m "0.5"

#Home Assistant MQTT Discovery

When mqtt_discovery: true, entities appear in HA automatically after the add-on starts and detects devices.

# Example HA automation
action:
  - service: mqtt.publish
    data:
      topic: "intiface/devices/0/motor/0/vibrate"
      payload: "0.8"

#Pattern Editor

The WebGUI includes a pattern editor for creating, saving and playing vibration patterns. Patterns can be triggered via the WebGUI or MQTT.

Protocol	Support	Notes
Bluetooth LE	✅	Via host BLE kernel passthrough. No additional config needed.
USB / HID	✅	Via host USB kernel passthrough.
Lovense (Bluetooth)	✅	Standard BLE protocol, works natively.
Lovense (USB Dongle)	✅	USB HID passthrough.

#Host Access

Bluetooth and USB are accessed directly through the host kernel. The add-on requires the privileged flag for device access. This is configured automatically by the add-on.

On Raspberry Pi, ensure Bluetooth is enabled in the HA OS settings and that the host Bluetooth service is not blocking the adapter.

Port	Protocol	Purpose
12345/tcp	WebSocket	Intiface Engine — for external clients (games, apps).
12346/tcp	HTTP	WebGUI — browser control interface.

/data/
└── patterns/    # Saved vibration patterns

HA backups include the add-on /data directory automatically.

Symptom	Cause	Fix
Web UI not opening	Port not mapped.	Check port 12346 in the Network tab.
Device not found	Bluetooth not enabled or blocked.	Ensure BT is enabled on HA host; restart add-on.
box64 error on ARM	Wrong engine version or incompatibility.	Check ENGINE_VERSION in Dockerfile against latest releases.
MQTT entities not appearing	No device connected or wrong broker.	Verify broker hostname and that MQTT integration is configured in HA.
Engine binary download fails	GitHub rate limit or wrong URL.	Check releases page and update ENGINE_VERSION.

Unofficial, community-maintained add-on wrapper. intiface-engine is BSD-3-Clause. The add-on wrapper is MIT.