Read this in other languages: 简体中文 · English · 日本語 · 한국어 · Deutsch · Français · Русский · Español · Português (Brasil)
GameToyProtocolBridge (GTPB) is a Buttplug v3 protocol bridge that lets games (e.g. MultiFunPlayer) control hardware devices via WebSocket.
Data path:
Game (MultiFunPlayer, etc.) → GTPB (ws://127.0.0.1:12345, Buttplug v3)
→ parse / map / transform → Intiface Central → toy hardware
- Dual WebSocket + TCP proxy — bidirectional communication between games and Intiface Central
- Channel mapping — flexible mapping of game channels to hardware actuators
- OSR6 six-axis mode — maps game OSR6 six-axis output to real hardware (L0 stroke / L1 in-out / L2 left-right / R0 twist / R1 roll / R2 pitch)
- Stroke simulation (Pulse / V1.0.1) — simulates stroke-style reciprocating motion for "velocity-type piston" devices (e.g. TryFun Meta2): on any non-zero signal the device pushes forward, then a delayed zero resets it, approximating OSR series reciprocation. Per-channel, with adjustable reset delay (
pulse_ms) - Channel delay (V1.0.1) — per-channel send delay, positive or negative, for calibrating multi-axis signal timing (negative delays are relative to the most-negative value as baseline)
- Dedupe / send-on-change (V1.0.1) — identical consecutive values are not forwarded; only value changes are sent, preventing repeated auto-triggering during stroke simulation
- Signal meter (V1.0.1) — real-time live bar chart at the bottom of the mapping page, color-coded by actuator type (Vibrate blue / Rotate orange / Linear green), ~33fps, showing current values on top
- Tooltip (V1.0.1) — hover over any setting (connection, mapping, buttons, meter) to show a delayed explanation of what it does
- Emergency stop — one-click interception of all device commands, sends StopAllDevices
- Multi-language support — Simplified Chinese, English, 日本語, Deutsch, Français, Русский, Español, Português (Brasil), 한국어
- Profile management — load, save, save-as for different connection configs and channel mapping schemes
- Port conflict detection — checks game and backend port conflicts on startup
- Logging system — system log, GameRx/Tx protocol log, capture log
- Install and start Intiface Central
- Make sure your toy device is connected via Intiface Central
# Install dependencies
pip install -r requirements.txt
# GUI mode
python main.py
# Headless mode
python main.py --headless
# Specify profile and parameters
python main.py --profile profiles/my.json --listen 0.0.0.0 --ws-port 12345 --backend ws://127.0.0.1:12346pip install pyinstaller
pyinstaller gtpb.specThe two ports must be different!
| Port | Default | Description |
|---|---|---|
| WebSocket port | 12345 | Port where games connect to GTPB (game-side convention, usually unchanged) |
| Backend Intiface | ws://127.0.0.1:12346 | Port where GTPB connects to Intiface Central |
If they are the same, the data flow loops into an infinite loop. GTPB auto-detects and warns on startup.
Fix: Intiface Central → Settings → Server → change Listening Port (suggest 12346), then update the GTPB "Backend Intiface" accordingly.
gtpb-python/
├── gtpb/ # Core modules
│ ├── __init__.py
│ ├── backend.py # Intiface backend connection
│ ├── buttplug.py # Buttplug v3 protocol parsing
│ ├── config.py # Configuration loading (INI + JSON Profile)
│ ├── gui.py # Tkinter GUI
│ ├── i18n.py # Multi-language support
│ ├── logs.py # Log manager
│ ├── mapping.py # Channel mapping engine
│ ├── models.py # Data models
│ ├── proxy.py # Bridge service core
│ ├── pulse.py # Stroke simulation + channel delay + level sampling (V1.0.1)
│ ├── safety.py # Safety mechanism (emergency stop)
│ └── transform.py # Value transforms
├── profiles/default.json # Default profile
├── tests/ # Unit tests
├── tools/ # Development helper tools
├── configsetting.ini # Factory config (do not modify)
├── main.py # Program entry
└── requirements.txt # Python dependencies
| File | Description |
|---|---|
profiles/*.json |
Your profiles (connection settings + channel mapping) |
.gtpb_settings |
Internal state (language, last loaded profile path) |
gtpb.log |
Rolling log (10KB cap, auto-trims old entries) |
| Argument | Description |
|---|---|
--headless |
Headless mode |
--profile <path> |
Specify profile file |
--listen <addr> |
Listen address (overrides profile) |
--ws-port <port> |
WebSocket port (overrides profile) |
--tcp-port <port> |
TCP port (overrides profile) |
--backend <url> |
Backend Intiface address (overrides profile) |
MIT