Skip to main content

Python implementation of the Buttplug Intimate Hardware Control Protocol.

Project description


This project will be deprecated and archived at some point in the future (still not sure when that is), with the Python implementation of buttplug moving to an FFI layer on top of buttplug-rs. Bugs are currently being triaged from this library to buttplug-rs-ffi.

The new project will be at

The API will change, though minimally (mostly connection in methods), and we will most likely still distribute the pypi package under the same name ("buttplug").

You may continue to use this repo for the time being (so far it's been a year and I've gotten nowhere on that upgrade, and this library still works fine!), just wanted everyone to be aware of the changes happening in the near future.


PyPi version Python version

Patreon donate button Discord Twitter

Buttplug-py is a python implementation of the Core and Client portions of the Buttplug Sex Toy Control Protocol. It allows users to write applications that can connect to Buttplug Servers, such as the Intiface Desktop Application or Intiface Rust CLI.

For more information on the Buttplug project, check out the project website at

Table Of Contents

Support The Project

If you find this project helpful, you can support us via Patreon or Github Sponsors! Every donation helps us afford more hardware to reverse, document, and write code for!


Library and API Documentation for buttplug-py is available at

Other recommended reading includes


Example code is available in the examples/ directory. Examples are heavily commented to hopefully make usage of the library clearer.


Buttplug is BSD 3-Clause licensed. More information is available in the LICENSE file.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for buttplug, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size buttplug-0.2.1.tar.gz (11.8 kB) File type Source Python version None Upload date Hashes View
Filename, size buttplug-0.2.1-py3-none-any.whl (15.2 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page