buttshock-py
Python implementation of serial based control of the following devices:
Erostek ET-312 Electrostimulation Device
Erostek ET-232 Electrostimulation Device
Estim Systems 2B Electrostimulation Device
docs |
|
|---|---|
tests |
|
package |
Using pyserial 3.1.1 (thought may work with pyserial 2.6+, but untested)
Buttshock Project Goals
If you’re going to shock yourself in the butt (or other places) for sexual pleasure, don’t you want to be able to know exactly what and how you’re doing it? Even if you can’t understand it, wouldn’t it be nice for people that do to have access to the knowledge and data they need to make sure things are safe? Why is the best encryption open source, but electrostim toys are closed?
The Buttshock project exists to reverse engineer and document eletrostim devices so that any developer that wants to control their devices can, via their own code.
Some of the goals of this project include:
Documenting the communications protocols (serial or otherwise)
Reverse engineering the firmware (where possible)
Mapping the circuit boards and creating schematics
Installation
To install:
$ pip install buttshock --upgrade
Package is also available on PyPi at http://pypi.python.org/pypi/buttshock
Python Implementation Details
This is a python implementation of the RS-232 control protocol for the ErosTek ET-312 electrostimulation box.
Documentation of the link cable, protocol, and other information is at:
https://buttshock.com/doc/et312
This library was developed and tested using a ET-312B running v1.6 firmware. The ET-232 and 2B libraries are untested, but please let us know if you’ve used them and they do/don’t work!
Requirements
buttshock-py requires the pyserial library if you want to actually connect via serial. However, it can pass packets for each box over whatever medium you like.
Repo Contents
This repo contains the following:
src - Source code for the library
examples - Example code that uses the library
License
tl;dr: BSD 3-Clause license
Copyright (c) 2016, Buttshock Project
See LICENSE file for full text.
Versions
0.2.0 (2016-07-05)
Change module layout to plan for new hardware implementations
Add documentation tree
More tests
0.1.2 (2016-07-05)
Fixed serial initialization issue
0.1.1 (2016-07-04)
CI/automation changes
0.1.0 (2016-07-04)
Initial Release
Basic ET-312 functionality
Metadata
Release files for buttshock 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| buttshock-0.2.1.tar.gz | 8.9 kB | Without provenance | Details for buttshock-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| buttshock-0.2.1-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details for buttshock-0.2.1-py2.py3-none-any.whl |
Total release size: 20.3 kB
Release files / buttshock-0.2.1.tar.gz
| Download URL | buttshock-0.2.1.tar.gz |
|---|---|
| Size | 8.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a8d56950a1a2bf8d692d3ae8203fba371a240646bc48ebb3673c3b10c9216803
|
|
BLAKE2b-256 checksum How to use checksums |
8555418b6e66a08bd08341d16feec9c9c994e74f67955df0a5c60e8b8dc3e493
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / buttshock-0.2.1-py2.py3-none-any.whl
| Download URL | buttshock-0.2.1-py2.py3-none-any.whl |
|---|---|
| Size | 11.4 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
49fd582e50797c6c5d7c508b6fb913b35f7b84151e8ff1c2d7ceaf9d7dd1ce1e
|
|
BLAKE2b-256 checksum How to use checksums |
b687018559e371018f25df3baecfbd0c79f685e5a3428d7e12c51ad8a1e0f48f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for buttshock 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.