Security News
CISA Brings KEV Data to GitHub
CISA's KEV data is now on GitHub, offering easier access, API integration, commit history tracking, and automated updates for security teams and researchers.
By Sarah Gooding - Jan 29, 2025
New Case Study:See how Anthropic automated 95% of dependency reviews with Socket.Learn More →
buttplug-js
buttplug-js is a core implementation in Typescript for the Buttplug Sex Toy Control Protocol and Server Architecture. It contains the classes needed to implement either Buttplug clients or servers.
The buttplug-js module is required for both web and node builds, but only contains websocket connectors and bluetooth device management for the web. If you want to build a buttplug application in native node, check out the Helper Libraries section for more node modules that will aid development.
Table Of Contents
- Support The Project
- Installation
- API Documentation
- Usage Example
- Using Buttplug with Webpack
- Helper Libraries
- Applications Using Buttplug-JS
- License
Support The Project
If you find this project helpful, you can support Metafetish projects via Patreon! Every donation helps us afford more hardware to reverse, document, and write code for!
Installation
Node and NPM
To install buttplug-js in your node project via npm, a simple add call should do it.
npm add buttplug
Web CDN
As of version 0.4.0, the buttplug-js repo is also built as a browser script via webpack, meaning you can just include it off a CDN and start writing code!
<html>
<body>
...
<script src='https://cdn.jsdelivr.net/npm/buttplug@[version]/dist/web/buttplug.min.js'></script>
<script type='text/javascript'>
// Buttplug library is umd, exposed as:
// - Global: Buttplug
// - amd: buttplug-amd
// - commonjs: buttplug-commonjs
// Here's hoping we don't see w3c make a Buttplug spec and collide this.
var bpclient = new Buttplug.Client("My very own buttplug web client");
// Now go off and do clienty things.
</script>
</body>
</html>
API Documentation
buttplug-js API Documentation is available at https://metafetish.github.io/buttplug-js.
The documentation is rebuilt on every commit/merge to master.
We highly recommend reading through the Buttplug Protocol Spec to get an idea of what messages are available. The Protocol Spec is available at https://metafetish.github.io/buttplug.
Usage Example
An example of how a simple HTML/JS web app can use Buttplug-js is available in the example directory, though you'll need to build the project first.
The example is also available for remix on Glitch at https://how-to-buttplug.glitch.me/.
Helper Libraries
- buttplug-noble-device-manager - Noble device manager for native Bluetooth Device management.
- buttplug-node-websockets - Websocket Client/Server for native Node applications.
- vue-buttplug-material-component - Vue.js component using Vue Material Design. Provides a simple interface for Buttplug server connection, device management, etc.
Applications Using Buttplug-js
- Buttplug Playground - Simple testing/demo application for buttplug supported toys.
- Syncydink - Video player with sex toy synchronization features via Buttplug.
License
buttplug-js is BSD 3-Clause licensed.
Copyright (c) 2017, Metafetish
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of the project nor the names of its
contributors may be used to endorse or promote products derived
from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Keywords
FAQs
Buttplug Client Implementation for Typescript/Javascript
The npm package buttplug receives a total of 9,775 weekly downloads. As such, buttplug popularity was classified as popular.
We found that buttplug demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Package last updated on 09 Jan 2018
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Related posts
Security News
Opengrep Emerges as Open Source Alternative Amid Semgrep Licensing Controversy
Opengrep forks Semgrep to preserve open source SAST in response to controversial licensing changes.
By Sarah Gooding - Jan 28, 2025
Security News
Node.js EOL Versions CVE Dubbed the "Worst CVE of the Year" by Security Experts
Critics call the Node.js EOL CVE a misuse of the system, sparking debate over CVE standards and the growing noise in vulnerability databases.
By Sarah Gooding - Jan 24, 2025