Dev

CLAUDE.md

@@ -43,7 +43,7 @@ Buttplug is a framework for interfacing with intimate hardware devices. It uses
 - `btleplug` - Bluetooth LE (primary, cross-platform)
 - `serial`, `hid` - USB serial and HID devices
 - `lovense_dongle`, `lovense_connect` - Lovense-specific (deprecated)
-- `xinput` - Windows gamepad vibration
+- `sdl_gamepad` - Cross-platform gamepad rumble via SDL3 (opt-in)
 - `websocket` - WebSocket device forwarders
 - `simulated` - In-process simulated devices (no real hardware; lives in `buttplug_server`)
 

CONTEXT.md

@@ -17,7 +17,7 @@ The link between a **Client** and a **Server**. Encapsulates two concerns: the c
 _Avoid_: "Transport" (not a domain term in buttplug).
 
 **Hardware Manager**:
-A component that discovers and communicates with devices over a specific communication bus — Bluetooth LE, HID, Serial, USB, etc. Each bus has its own manager implementation (`HardwareCommunicationManager` trait). Named by bus: `btleplug` (BLE), `serial`, `hid`, `xinput`, etc.
+A component that discovers and communicates with devices over a specific communication bus — Bluetooth LE, HID, Serial, USB, etc. Each bus has its own manager implementation (`HardwareCommunicationManager` trait). Named by bus: `btleplug` (BLE), `serial`, `hid`, etc.
 _Avoid_: "Transport" when referring to hardware communication.
 
 **Client**:

Cargo.toml

@@ -8,13 +8,12 @@ members = [
     "crates/buttplug_server",
     "crates/buttplug_server_device_config",
     "crates/buttplug_server_hwmgr_btleplug",
-    "crates/buttplug_server_hwmgr_hid",
     "crates/buttplug_server_hwmgr_lovense_connect",
     "crates/buttplug_server_hwmgr_lovense_dongle",
     "crates/buttplug_server_hwmgr_serial",
     "crates/buttplug_server_hwmgr_websocket",
     "crates/buttplug_server_hwmgr_webbluetooth",
-    "crates/buttplug_server_hwmgr_xinput",
+    "crates/buttplug_server_hwmgr_sdl_gamepad",
     "crates/buttplug_tests",
     "crates/buttplug_transport_websocket_tungstenite",
     "crates/buttplug_wasm",
@@ -31,12 +30,11 @@ default-members = [
     "crates/buttplug_server",
     "crates/buttplug_server_device_config",
     "crates/buttplug_server_hwmgr_btleplug",
-    "crates/buttplug_server_hwmgr_hid",
     "crates/buttplug_server_hwmgr_lovense_connect",
     "crates/buttplug_server_hwmgr_lovense_dongle",
     "crates/buttplug_server_hwmgr_serial",
     "crates/buttplug_server_hwmgr_websocket",
-    "crates/buttplug_server_hwmgr_xinput",
+    "crates/buttplug_server_hwmgr_sdl_gamepad",
     "crates/buttplug_tests",
     "crates/buttplug_transport_websocket_tungstenite",
     "crates/intiface_engine",

README.md

@@ -77,7 +77,6 @@ Buttplug is currently capable of controlling toys via:
 - Lovense Devices via the Lovense Dongle (HID and Serial dongles, Desktop)
 - Lovense Connect App (Desktop and Android/iOS)
 - Websockets (for simulated and DIY devices, Desktop and Android/iOS)
-- XInput gamepads (Windows only)
 
 See [IOSTIndex](https://iostindex.com) for a full list of supported hardware (Filter on "Buttplug Rust").
 
@@ -100,12 +99,11 @@ This project consists of the following crates:
 | [buttplug_server](crates/buttplug_server/) | The core server implementation, including server and device structures, all protocol implementations, etc... |
 | [buttplug_server_device_config](crates/buttplug_server_device_config/) | Device configuration file loading and database implementation. |
 | [buttplug_server_hwmgr_btleplug](crates/buttplug_server_hwmgr_btleplug/) | Bluetooth LE device communication support |
-| [buttplug_server_hwmgr_hid](crates/buttplug_server_hwmgr_hid/) | HID device communication support |
 | [buttplug_server_hwmgr_lovense_connect](crates/buttplug_server_hwmgr_lovense_connect/) | Lovense Connect device communication support (soon to be deprecated) |
 | [buttplug_server_hwmgr_lovense_dongle](crates/buttplug_server_hwmgr_lovense_dongle/) | Lovense Dongle device communication support (soon to be deprecated) |
 | [buttplug_server_hwmgr_serial](crates/buttplug_server_hwmgr_serial/) | Serial device communication support |
 | [buttplug_server_hwmgr_websocket](crates/buttplug_server_hwmgr_websocket/) | Websocket device communication suppor, used for devices that may connect in ways not directly supported by other formats |
-| [buttplug_server_hwmgr_xinput](crates/buttplug_server_hwmgr_xinput/) | XInput gamepad support (windows only) |
+| [buttplug_server_hwmgr_sdl_gamepad](crates/buttplug_server_hwmgr_sdl_gamepad/) | Cross-platform gamepad rumble via SDL3 |
 | [buttplug_tests](crates/buttplug_tests/) | For tests that need the whole framework |
 | [buttplug_transport_websocket_tungstenite](crates/buttplug_transport_websocket_tungstenite/) | Communications transport for clients/servers using tokio-tungstenite |
 | [intiface_engine](crates/intiface_engine/) | Command line interface for running a Buttplug server |

crates/buttplug/CHANGELOG.md

@@ -1,3 +1,13 @@
+# 12.0.0 (2026-09-18)
+
+## Breaking Changes
+
+- The facade now re-exports the 12.x websocket transport API. Update websocket builders to use listen addresses and rebuild integrations against the coordinated 12.x manager/config contracts.
+
+## Other
+
+- Update internal dependencies to the coordinated release lines.
+
 # 11.0.0 (2026-07-28)
 
 ## Other

crates/buttplug/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "buttplug"
-version = "11.0.0"
+version = "12.0.0"
 
 authors = ["Nonpolynomial Labs, LLC <kyle@nonpolynomial.com>"]
 description = "Buttplug Intimate Hardware Control Library - Client Library"
@@ -20,5 +20,5 @@ doctest = true
 doc = true
 
 [dependencies]
-buttplug_client = { version = "11.0.0", path = "../buttplug_client" }
-buttplug_transport_websocket_tungstenite = { version = "11.0.0", path = "../buttplug_transport_websocket_tungstenite"}
+buttplug_client = { version = "11.0.1", path = "../buttplug_client" }
+buttplug_transport_websocket_tungstenite = { version = "12.0.0", path = "../buttplug_transport_websocket_tungstenite"}

crates/buttplug_client/CHANGELOG.md

@@ -1,3 +1,9 @@
+# 11.0.1 (2026-09-18)
+
+## Other
+
+- Patch release for the coordinated workspace dependency update; the client public contract remains compatible.
+
 # 11.0.0 (2026-07-28)
 
 ## Other

crates/buttplug_client/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "buttplug_client"
-version = "11.0.0"
+version = "11.0.1"
 authors = ["Nonpolynomial Labs, LLC <kyle@nonpolynomial.com>"]
 description = "Buttplug Intimate Hardware Control Library - Core Library"
 license = "BSD-3-Clause"
@@ -24,16 +24,16 @@ tokio-runtime = ["buttplug_core/tokio-runtime"]
 wasm = ["buttplug_core/wasm"]
 
 [dependencies]
-buttplug_core = { version = "11.0.0", path = "../buttplug_core", default-features = false }
-futures = "0.3.33"
-thiserror = "2.0.19"
-log = "0.4.33"
+buttplug_core = { version = "11.0.1", path = "../buttplug_core", default-features = false }
+futures = "0.3.34"
+thiserror = "2.0.20"
+log = "0.4.34"
 getset = "0.1.7"
 tokio = { version = "1.53.1", features = ["macros"] }
 dashmap = { version = "6.2.1" }
 tracing = "0.1.44"
 serde = { version = "1.0.229", features = ["derive"] }
 serde_json = "1.0.151"
-jsonschema = { version = "0.49.1", default-features = false }
+jsonschema = { version = "0.56.0", default-features = false }
 strum = "0.28.0"
 strum_macros = "0.28.0"

crates/buttplug_client_in_process/CHANGELOG.md

@@ -1,3 +1,12 @@
+# 12.0.0 (2026-09-18)
+
+## Breaking Changes
+
+- Remove the public `xinput-manager` feature and standalone XInput manager dependency; migrate consumers to `sdl-gamepad-manager`.
+- Add SDL gamepad to the default feature set, so default builds register SDL3 gamepads instead of XInput hardware.
+- The in-process client now uses the coordinated 12.x server, device-config, and manager contracts.
+
+
 # 11.0.0 (2026-07-28)
 
 ## Other

crates/buttplug_client_in_process/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "buttplug_client_in_process"
-version = "11.0.0"
+version = "12.0.0"
 authors = ["Nonpolynomial Labs, LLC <kyle@nonpolynomial.com>"]
 description = "Buttplug Intimate Hardware Control Library - Core Library"
 license = "BSD-3-Clause"
@@ -20,33 +20,31 @@ doc = true
 
 
 [features]
-default = ["tokio-runtime", "btleplug-manager", "hid-manager", "lovense-dongle-manager", "lovense-connect-service-manager", "serial-manager", "websocket-manager", "xinput-manager"]
+default = ["tokio-runtime", "btleplug-manager", "lovense-dongle-manager", "lovense-connect-service-manager", "serial-manager", "websocket-manager", "sdl-gamepad-manager"]
 btleplug-manager=["buttplug_server_hwmgr_btleplug"]
-hid-manager=["buttplug_server_hwmgr_hid"]
 lovense-dongle-manager=["buttplug_server_hwmgr_lovense_dongle"]
 lovense-connect-service-manager=["buttplug_server_hwmgr_lovense_connect"]
 serial-manager=["buttplug_server_hwmgr_serial"]
 websocket-manager=["buttplug_server_hwmgr_websocket"]
-xinput-manager=["buttplug_server_hwmgr_xinput"]
+sdl-gamepad-manager=["buttplug_server_hwmgr_sdl_gamepad"]
 tokio-runtime = ["buttplug_core/tokio-runtime", "buttplug_client/tokio-runtime", "buttplug_server/tokio-runtime"]
 wasm = ["buttplug_core/wasm", "buttplug_client/wasm", "buttplug_server/wasm"]
 
 [dependencies]
-buttplug_core = { version = "11.0.0", path = "../buttplug_core", default-features = false }
-buttplug_client = { version = "11.0.0", path = "../buttplug_client", default-features = false }
-buttplug_server = { version = "11.0.0", path = "../buttplug_server", default-features = false }
-buttplug_server_device_config = { version = "11.0.0", path = "../buttplug_server_device_config" }
-buttplug_server_hwmgr_btleplug = { version = "11.0.0", path = "../buttplug_server_hwmgr_btleplug", optional = true}
-buttplug_server_hwmgr_hid = { version = "11.0.0", path = "../buttplug_server_hwmgr_hid", optional = true}
-buttplug_server_hwmgr_lovense_connect = { version = "11.0.0", path = "../buttplug_server_hwmgr_lovense_connect", optional = true}
-buttplug_server_hwmgr_lovense_dongle = { version = "11.0.0", path = "../buttplug_server_hwmgr_lovense_dongle", optional = true}
-buttplug_server_hwmgr_serial = { version = "11.0.0", path = "../buttplug_server_hwmgr_serial", optional = true}
-buttplug_server_hwmgr_websocket = { version = "11.0.0", path = "../buttplug_server_hwmgr_websocket", optional = true}
-buttplug_server_hwmgr_xinput = { version = "11.0.0", path = "../buttplug_server_hwmgr_xinput", optional = true}
-futures = "0.3.33"
-futures-util = "0.3.33"
-thiserror = "2.0.19"
-log = "0.4.33"
+buttplug_core = { version = "11.0.1", path = "../buttplug_core", default-features = false }
+buttplug_client = { version = "11.0.1", path = "../buttplug_client", default-features = false }
+buttplug_server = { version = "12.0.0", path = "../buttplug_server", default-features = false }
+buttplug_server_device_config = { version = "12.0.0", path = "../buttplug_server_device_config" }
+buttplug_server_hwmgr_btleplug = { version = "12.0.0", path = "../buttplug_server_hwmgr_btleplug", optional = true}
+buttplug_server_hwmgr_lovense_connect = { version = "12.0.0", path = "../buttplug_server_hwmgr_lovense_connect", optional = true}
+buttplug_server_hwmgr_lovense_dongle = { version = "12.0.0", path = "../buttplug_server_hwmgr_lovense_dongle", optional = true}
+buttplug_server_hwmgr_serial = { version = "12.0.0", path = "../buttplug_server_hwmgr_serial", optional = true}
+buttplug_server_hwmgr_websocket = { version = "12.0.0", path = "../buttplug_server_hwmgr_websocket", optional = true}
+buttplug_server_hwmgr_sdl_gamepad = { version = "12.0.0", path = "../buttplug_server_hwmgr_sdl_gamepad", optional = true}
+futures = "0.3.34"
+futures-util = "0.3.34"
+thiserror = "2.0.20"
+log = "0.4.34"
 getset = "0.1.7"
 tokio = { version = "1.53.1", features = ["macros"] }
 dashmap = { version = "6.2.1" }

crates/buttplug_client_in_process/src/in_process_client.rs

@@ -30,7 +30,6 @@ use buttplug_server_device_config::DeviceConfigurationManagerBuilder;
 /// the devices you want, there are a couple of things to check:
 ///
 /// - Are you on a platform that the device communication manager supports?
-///   For instance, we only support XInput on windows.
 /// - Did the developers add a new Device CommunicationManager type and forget
 ///   to add it to this method? _It's more likely than you think!_ [File a
 ///   bug](https://github.com/buttplugio/buttplug/issues).
@@ -50,17 +49,41 @@ pub async fn in_process_client(client_name: &str) -> ButtplugClient {
     .unwrap();
 
   let mut device_manager_builder = ServerDeviceManagerBuilder::new(dcm);
+  register_comm_managers(&mut device_manager_builder);
+  let server_builder = ButtplugServerBuilder::new(device_manager_builder.finish().unwrap());
+  let server = server_builder.finish().unwrap();
+  let connector = ButtplugInProcessClientConnectorBuilder::default()
+    .server(server)
+    .finish();
+  let client = ButtplugClient::new(client_name);
+  client.connect(connector).await.unwrap();
+  client
+}
+
+/// Registers every comm manager selected by this crate's cargo features, and
+/// returns the names of the managers that were registered so tests can assert
+/// feature wiring (single source of truth: `in_process_client` uses this and
+/// ignores the result).
+// With no manager features enabled (how e.g. buttplug_tests consumes this
+// crate), nothing is registered and the builder parameter goes unused.
+#[allow(unused_mut, unused_variables)]
+fn register_comm_managers(
+  device_manager_builder: &mut ServerDeviceManagerBuilder,
+) -> Vec<&'static str> {
+  let mut registered = vec![];
   #[cfg(feature = "btleplug-manager")]
   {
     use buttplug_server_hwmgr_btleplug::BtlePlugCommunicationManagerBuilder;
     device_manager_builder.comm_manager(BtlePlugCommunicationManagerBuilder::default());
+    registered.push("btleplug");
   }
   #[cfg(feature = "websocket-manager")]
   {
     use buttplug_server_hwmgr_websocket::WebsocketServerDeviceCommunicationManagerBuilder;
     device_manager_builder.comm_manager(
       WebsocketServerDeviceCommunicationManagerBuilder::default().listen_on_all_interfaces(true),
     );
+    registered.push("websocket-server");
   }
   #[cfg(all(
     feature = "serial-manager",
@@ -69,12 +92,14 @@ pub async fn in_process_client(client_name: &str) -> ButtplugClient {
   {
     use buttplug_server_hwmgr_serial::SerialPortCommunicationManagerBuilder;
     device_manager_builder.comm_manager(SerialPortCommunicationManagerBuilder::default());
+    registered.push("serial");
   }
   #[cfg(feature = "lovense-connect-service-manager")]
   {
     use buttplug_server_hwmgr_lovense_connect::LovenseConnectServiceCommunicationManagerBuilder;
     device_manager_builder
       .comm_manager(LovenseConnectServiceCommunicationManagerBuilder::default());
+    registered.push("lovense-connect-service");
   }
   #[cfg(all(
     feature = "lovense-dongle-manager",
@@ -83,18 +108,33 @@ pub async fn in_process_client(client_name: &str) -> ButtplugClient {
   {
     use buttplug_server_hwmgr_lovense_dongle::LovenseHIDDongleCommunicationManagerBuilder;
     device_manager_builder.comm_manager(LovenseHIDDongleCommunicationManagerBuilder::default());
+    registered.push("lovense-dongle");
   }
-  #[cfg(all(feature = "xinput-manager", target_os = "windows"))]
+  // SDL gamepad manager is in the default feature set and is
+  // cross-platform: no OS gate.
+  #[cfg(feature = "sdl-gamepad-manager")]
   {
-    use buttplug_server_hwmgr_xinput::XInputDeviceCommunicationManagerBuilder;
-    device_manager_builder.comm_manager(XInputDeviceCommunicationManagerBuilder::default());
+    use buttplug_server_hwmgr_sdl_gamepad::SdlGamepadCommunicationManagerBuilder;
+    device_manager_builder.comm_manager(SdlGamepadCommunicationManagerBuilder::default());
+    registered.push("sdl-gamepad");
+  }
+  registered
+}
+
+#[cfg(all(test, feature = "sdl-gamepad-manager"))]
+mod tests {
+  use super::*;
+
+  #[test]
+  fn feature_registers_sdl_manager() {
+    let dcm = DeviceConfigurationManagerBuilder::default()
+      .finish()
+      .unwrap();
+    let mut builder = ServerDeviceManagerBuilder::new(dcm);
+    let registered = register_comm_managers(&mut builder);
+    assert!(
+      registered.contains(&"sdl-gamepad"),
+      "SDL gamepad manager must be registered when the feature is enabled, got {registered:?}"
+    );
   }
-  let server_builder = ButtplugServerBuilder::new(device_manager_builder.finish().unwrap());
-  let server = server_builder.finish().unwrap();
-  let connector = ButtplugInProcessClientConnectorBuilder::default()
-    .server(server)
-    .finish();
-  let client = ButtplugClient::new(client_name);
-  client.connect(connector).await.unwrap();
-  client
 }

crates/buttplug_core/CHANGELOG.md

@@ -1,3 +1,9 @@
+# 11.0.1 (2026-09-18)
+
+## Other
+
+- Patch release for the coordinated workspace dependency update; the core public contract remains compatible.
+
 # 11.0.0 (2026-07-28)
 
 ## Breaking Changes

crates/buttplug_core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "buttplug_core"
-version = "11.0.0"
+version = "11.0.1"
 authors = ["Nonpolynomial Labs, LLC <kyle@nonpolynomial.com>"]
 description = "Buttplug Intimate Hardware Control Library - Core Library"
 license = "BSD-3-Clause"
@@ -23,42 +23,36 @@ default=["tokio-runtime"]
 tokio-runtime=["tokio/rt", "tokio/time"]
 wasm=["wasm-bindgen-futures", "wasmtimer"]
 
-# Only build docs on one platform (linux)
-[package.metadata.docs.rs]
-targets = []
-# Features to pass to Cargo (default: [])
-features = ["default", "unstable"]
-
 [dev-dependencies]
 tracing-subscriber = "0.3.23"
 
 [build-dependencies]
 serde = "1.0.229"
 serde_json = "1.0.151"
-jsonschema = { version = "0.49.1", default-features = false }
+jsonschema = { version = "0.56.0", default-features = false }
 
 [dependencies]
-futures = "0.3.33"
-futures-util = "0.3.33"
+futures = "0.3.34"
+futures-util = "0.3.34"
 serde = { version = "1.0.229", features = ["derive"] }
 serde_json = "1.0.151"
 serde_repr = "0.1.21"
-thiserror = "2.0.19"
-displaydoc = "0.2.6"
-log = "0.4.33"
+thiserror = "2.0.20"
+displaydoc = "0.2.7"
+log = "0.4.34"
 getset = "0.1.7"
-jsonschema = { version = "0.49.1", default-features = false }
-cfg-if = "1.0.4"
+jsonschema = { version = "0.56.0", default-features = false }
+cfg-if = "1.0.5"
 tokio = { version = "1.53.1", features = ["sync", "macros"] }
 async-stream = "0.3.6"
 strum_macros = "0.28.0"
 strum = "0.28.0"
 derive_builder = "0.20.2"
 enum_dispatch = "0.3"
 tracing = "0.1.44"
-wasm-bindgen-futures = { version = "0.4.76", optional = true }
+wasm-bindgen-futures = { version = "0.4.78", optional = true }
 wasmtimer = { version = "0.4.3", optional = true }
-smallvec = { version = "1.15.2", features = ["serde", "const_generics"] }
+smallvec = { version = "1.16.1", features = ["serde", "const_generics"] }
 enumflags2 = "0.7.12"
 tokio-util = "0.7.19"
 dashmap = "6.2.1"