Skip to content

Commit bd3fe84

Browse files
committed
doc: Create README and CHANGELOGs for all crates
Might as well be through.
1 parent ffaac5b commit bd3fe84

File tree

33 files changed

+900
-9
lines changed

33 files changed

+900
-9
lines changed

README.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@
4141

4242
## Are you in the right place?
4343

44-
If you're just looking to hook your hardware up to something that says it "supports Buttplug/Intiface", you're in the wrong place. For that you'll most likely want to go check out [Intiface Central](https://intiface.com/central).
44+
If you're just looking to hook your hardware up to something that says it "supports Buttplug/Intiface" (like one of the many apps/games in [our awesome list](https://awesome.buttplug.io)), you're in the wrong place. For that you'll most likely want to go check out [Intiface Central](https://intiface.com/central).
4545

4646
This is where we store all of the source code for the libraries that run your hardware. If you're a developer and interesting in that sort of thing, read on...
4747

@@ -68,6 +68,12 @@ We also produce [btleplug](https://github.com/deviceplug/btleplug), the host-sid
6868

6969
For a list of applications using Buttplug and Intiface, see the [awesome-buttplug repo](https://github.com/buttplugio/awesome-buttplug).
7070

71+
## Beta on main branch?! REALLY?
72+
73+
We've been working on the next version of our message spec for the better part of 3 years now, which has come with massive changes to the library. Rather than let this sit on our `dev` branch for another few months while we run through the beta process, we decided to promote beta to our main branch so it gets visibility. We'll still be marking beta versions in crates and releases, so package installs will still default to pre-beta version until we've released.
74+
75+
Also I hadn't updated the README on the project in several years and didn't want to have to rewrite for both the old and new libraries. So here we are.
76+
7177
## Hardware Support
7278

7379
Buttplug-rs is currently capable of controlling toys via:
@@ -94,8 +100,9 @@ This project consists of the following crates:
94100

95101
| Crate Name | Description |
96102
| ---- | ----------- |
97-
| buttplug | meta-crate, see README for more info |
103+
| buttplug | meta-crate that's just a rehost on buttplug_client, see README for more info |
98104
| buttplug_client | Buttplug Rust Client, useful for building application that will access Intiface Engine or Intiface Central. We recommend most developers use this. See crate README for more info. |
105+
| buttplug_client_in_process | Buttplug Rust Client w/ integrated Buttplug Server. Useful for building standalone applications and examples. |
99106
| buttplug_core | Contains the protocol message schema, message class implementations, and structures shared by the client and server implementations. Will be rarely needed as a direct dependency. |
100107
| buttplug_derive | Procedural macros used in the Buttplug rust implementation. Will be rarely needed as a direct dependency. |
101108
| buttplug_server | The core server implementation, including server and device structures, all protocol implementations, etc... |
File renamed without changes.

crates/buttplug/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,8 @@
3333

3434
<p align="center">
3535
<picture>
36-
<source media="(prefers-color-scheme: light)" srcset="images/buttplug_rust_docs.png">
37-
<source media="(prefers-color-scheme: dark)" srcset="images/buttplug_rust_docs_light.png">
36+
<source media="(prefers-color-scheme: light)" srcset="../../images/buttplug_rust_docs.png">
37+
<source media="(prefers-color-scheme: dark)" srcset="../../images/buttplug_rust_docs_light.png">
3838
<img src="https://raw.githubusercontent.com/buttplugio/buttplug/master/images/buttplug_rust_docs.png">
3939
</picture>
4040
</p>
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# 10.0.0-beta1 (2025-10-12)
2+
3+
## Features
4+
5+
- Client moved to its own crate
6+
- API updated to work with v4 message spec
7+
- API allows both discrete steps and float based commands
8+
9+
# Earlier Versions
10+
11+
- See [Buttplug Crate CHANGELOG.md](../buttplug/CHANGELOG.md)

crates/buttplug_client/README.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# Buttplug Client Library
2+
3+
[![Patreon donate button](https://img.shields.io/badge/patreon-donate-yellow.svg)](https://www.patreon.com/qdot)
4+
[![Github donate button](https://img.shields.io/badge/github-donate-ff69b4.svg)](https://www.github.com/sponsors/qdot)
5+
[![Discourse Forums](https://img.shields.io/discourse/status?label=buttplug.io%20forums&server=https%3A%2F%2Fdiscuss.buttplug.io)](https://discuss.buttplug.io)
6+
[![Discord](https://img.shields.io/discord/353303527587708932.svg?logo=discord)](https://discord.buttplug.io)
7+
[![Twitter](https://img.shields.io/twitter/follow/buttplugio.svg?style=social&logo=twitter)](https://twitter.com/buttplugio)
8+
[![bluesky](https://img.shields.io/bluesky/followers/buttplug.io)](https://bsky.app/profile/buttplug.io)
9+
10+
[![Crates.io Version](https://img.shields.io/crates/v/buttplug)](https://crates.io/crates/buttplug)
11+
[![Crates.io Downloads](https://img.shields.io/crates/d/buttplug)](https://crates.io/crates/buttplug)
12+
[![Crates.io License](https://img.shields.io/crates/l/buttplug)](https://crates.io/crates/buttplug)
13+
14+
If you want to build Rust-based applications that access programs like [Intiface Engine](../intiface_engine/) and [Intiface Central](https://intiface.com/central), you're in the right place.
15+
16+
This library contains everything you need to connect to Buttplug servers, scan for devices, and control their inputs and outputs.
17+
18+
## What if I want to use another language?
19+
20+
Check our [awesome list](https://awesome.buttplug.io) for Buttplug Client libraries in other languages.
21+
22+
## License
23+
24+
Buttplug is BSD 3-Clause licensed.
25+
26+
```text
27+
28+
Copyright (c) 2016-2025, Nonpolynomial, LLC
29+
All rights reserved.
30+
31+
Redistribution and use in source and binary forms, with or without
32+
modification, are permitted provided that the following conditions are met:
33+
34+
* Redistributions of source code must retain the above copyright notice, this
35+
list of conditions and the following disclaimer.
36+
37+
* Redistributions in binary form must reproduce the above copyright notice,
38+
this list of conditions and the following disclaimer in the documentation
39+
and/or other materials provided with the distribution.
40+
41+
* Neither the name of buttplug nor the names of its
42+
contributors may be used to endorse or promote products derived from
43+
this software without specific prior written permission.
44+
45+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
46+
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
47+
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
48+
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
49+
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
50+
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
51+
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
52+
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
53+
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
54+
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
55+
```
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# 10.0.0-beta1 (2025-10-12)
2+
3+
## Features
4+
5+
- In-process client moved to its own crate, mostly because of the dependency complexity
6+
7+
# Earlier Versions
8+
9+
- See [Buttplug Crate CHANGELOG.md](../buttplug/CHANGELOG.md)
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
# Buttplug
2+
3+
[![Patreon donate button](https://img.shields.io/badge/patreon-donate-yellow.svg)](https://www.patreon.com/qdot)
4+
[![Github donate button](https://img.shields.io/badge/github-donate-ff69b4.svg)](https://www.github.com/sponsors/qdot)
5+
[![Discourse Forums](https://img.shields.io/discourse/status?label=buttplug.io%20forums&server=https%3A%2F%2Fdiscuss.buttplug.io)](https://discuss.buttplug.io)
6+
[![Discord](https://img.shields.io/discord/353303527587708932.svg?logo=discord)](https://discord.buttplug.io)
7+
[![Twitter](https://img.shields.io/twitter/follow/buttplugio.svg?style=social&logo=twitter)](https://twitter.com/buttplugio)
8+
[![bluesky](https://img.shields.io/bluesky/followers/buttplug.io)](https://bsky.app/profile/buttplug.io)
9+
10+
[![Crates.io Version](https://img.shields.io/crates/v/buttplug)](https://crates.io/crates/buttplug)
11+
[![Crates.io Downloads](https://img.shields.io/crates/d/buttplug)](https://crates.io/crates/buttplug)
12+
[![Crates.io License](https://img.shields.io/crates/l/buttplug)](https://crates.io/crates/buttplug)
13+
14+
# Buttplug In-Process Client Library
15+
16+
**YOU PROBABLY SHOULDN'T USE THIS,** but we're including it anyways.
17+
18+
If you want to build stand-alone Rust-based applications using Buttplug, you're in the right place.
19+
20+
This library contains everything you need to scan for devices, and control their inputs and outputs.
21+
22+
## Why shouldn't I use this?
23+
24+
Building a standalone application with this library means you'll have to update when we do. We're constantly adding device and protocol support to the library, which means changes to the core rust system. Since we may not keep APIs the same, you'll be on the hook to upgrade when we do, or else your software will fall behind in support.
25+
26+
## Then why does this exist?
27+
28+
'cause it can make testing ideas, or just bringing up quick shitposts for sake of making a video or one-off project easier.
29+
30+
## License
31+
32+
Buttplug is BSD 3-Clause licensed.
33+
34+
```text
35+
36+
Copyright (c) 2016-2025, Nonpolynomial, LLC
37+
All rights reserved.
38+
39+
Redistribution and use in source and binary forms, with or without
40+
modification, are permitted provided that the following conditions are met:
41+
42+
* Redistributions of source code must retain the above copyright notice, this
43+
list of conditions and the following disclaimer.
44+
45+
* Redistributions in binary form must reproduce the above copyright notice,
46+
this list of conditions and the following disclaimer in the documentation
47+
and/or other materials provided with the distribution.
48+
49+
* Neither the name of buttplug nor the names of its
50+
contributors may be used to endorse or promote products derived from
51+
this software without specific prior written permission.
52+
53+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
54+
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
55+
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
56+
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
57+
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
58+
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
59+
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
60+
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
61+
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
62+
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
63+
```

crates/buttplug_core/CHANGELOG.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# 10.0.0-beta1 (2025-10-12)
2+
3+
## Features
4+
5+
- Core split into its own crate
6+
- Updated messages for v4
7+
- Core now only contains messages valid for the current version of the Buttplug Spec
8+
- JSON Message schema now built on program build, since if that doesn't build, neither will the rest
9+
of the library
10+
11+
# Earlier Versions
12+
13+
- See [Buttplug Crate CHANGELOG.md](../buttplug/CHANGELOG.md)
14+

crates/buttplug_core/README.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Buttplug Core Library
2+
3+
[![Patreon donate button](https://img.shields.io/badge/patreon-donate-yellow.svg)](https://www.patreon.com/qdot)
4+
[![Github donate button](https://img.shields.io/badge/github-donate-ff69b4.svg)](https://www.github.com/sponsors/qdot)
5+
[![Discourse Forums](https://img.shields.io/discourse/status?label=buttplug.io%20forums&server=https%3A%2F%2Fdiscuss.buttplug.io)](https://discuss.buttplug.io)
6+
[![Discord](https://img.shields.io/discord/353303527587708932.svg?logo=discord)](https://discord.buttplug.io)
7+
[![Twitter](https://img.shields.io/twitter/follow/buttplugio.svg?style=social&logo=twitter)](https://twitter.com/buttplugio)
8+
[![bluesky](https://img.shields.io/bluesky/followers/buttplug.io)](https://bsky.app/profile/buttplug.io)
9+
10+
[![Crates.io Version](https://img.shields.io/crates/v/buttplug)](https://crates.io/crates/buttplug)
11+
[![Crates.io Downloads](https://img.shields.io/crates/d/buttplug)](https://crates.io/crates/buttplug)
12+
[![Crates.io License](https://img.shields.io/crates/l/buttplug)](https://crates.io/crates/buttplug)
13+
14+
The basis of the Buttplug Framework. Contains definitions for all current protocol messages, as well as base traits for architecture shared between client and server (serializers, connectors, etc...) and utilities used throughout the library (async managers, stream creation, etc...).
15+
16+
## License
17+
18+
Buttplug is BSD 3-Clause licensed.
19+
20+
```text
21+
22+
Copyright (c) 2016-2025, Nonpolynomial, LLC
23+
All rights reserved.
24+
25+
Redistribution and use in source and binary forms, with or without
26+
modification, are permitted provided that the following conditions are met:
27+
28+
* Redistributions of source code must retain the above copyright notice, this
29+
list of conditions and the following disclaimer.
30+
31+
* Redistributions in binary form must reproduce the above copyright notice,
32+
this list of conditions and the following disclaimer in the documentation
33+
and/or other materials provided with the distribution.
34+
35+
* Neither the name of buttplug nor the names of its
36+
contributors may be used to endorse or promote products derived from
37+
this software without specific prior written permission.
38+
39+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
40+
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
41+
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
42+
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
43+
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
44+
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
45+
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
46+
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
47+
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
48+
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
49+
```
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# 10.0.0-beta1 (2025-10-12)
2+
3+
## Features
4+
5+
- Added Device Support:
6+
- Fredorch F2S1 (Updated controls algorithm)
7+
- Kiiroo PleasureDrive, Powershot
8+
- Hismith/Sinloli Piupiu (lube injector)
9+
- Sinloli Aston
10+
- Joyhub Persues, Divers, Peachy
11+
- Various Sexverse devices
12+
- Lovemazer devices
13+
- Duopeak Saphette
14+
- Adorime Penis Helmet Vibrator, Chastity Cage, Backy
15+
- Qingnan devices
16+
- Hannibal Kona
17+
- Pink Punch Peacaron
18+
- Server split into its own crate
19+
- Updated messages for v4
20+
- Deprecated Messages from v0-v3 now only exist in the server, since they're only needed for
21+
backward compat.
22+
- Completely rewrote the message conversion system for backward compat
23+
24+
# Earlier Versions
25+
26+
- See [Buttplug Crate CHANGELOG.md](../buttplug/CHANGELOG.md)

0 commit comments

Comments
 (0)