LS-Buttplug

Control of Chinese Toys Vibrations via ESP32

The LS-Buttplug project is designed to control vibrations of cheap Chinese sex toys that work with the MuSe / Love Spouse app.
The goal of the project is to expand the functionality of available devices, since most cheap toys have limited software, and the Love Spouse app works with restrictions and failures in some regions.

The project supports 4 operation modes and provides smooth power control 0-9

---

⚙️ Features

• Manual smooth control via local Web interface
• Support for Lovense games on PC
• Compatibility with Buttplug.io / Intiface Central on both PC and mobile devices
• Support for XToys.App
• Lovense Remote support (limited)

---

🛠 Installation and Setup

1. Preparing ESP32

1. Download the .zip archive and unpack it on your PC.
2. Flash the ESP32:

PlatformIO

• Open the PlatformIO folder in PlatformIO
• Select your board in platformio.ini or add a new one
• Flash the ESP32

2. Running LS-Buttplug

pip install -r requirements.txt

1. Run LS-Buttplug.py
   • A Web page will open automatically or go to http://localhost:5000
2. Select the COM port where your ESP32 is connected
3. Control:
   • With mouse slider or scroll wheel
   • 4 random vibration modes
4. Enable Lovense Game for direct game support
   • In game settings go to Lovense
   • Set HOST: 127.0.0.1, PORT: 30010 (or others matching Web interface)
   • Uncheck "Connect via SSL" (if available)
   • Press "Connect / Test Connection"
   • Enjoy
5. Enable Keyboard to bind vibrations to keyboard keys
   • Enter any symbol in Key field — assign vibration level and press Add
   • Add as many symbols as you want
   • You can assign vibration level to each keyboard key separately
   • Type text — enjoy
   • Play any games without Lovense/Buttplug.io/Intiface Central support
   • Works system-wide on Windows

   ⚠️ No support for F1-F12, space, enter, and other system keys

3. Intiface Central

• Running LS-Buttplug.py is not required
• Launch Intiface Central on PC or mobile and scan for devices — the device will appear as Lovense
• Run a game or app with Buttplug.io support
• Enjoy control

4. XToys.App

• Running LS-Buttplug.py is not required
• Choose any Lovense Vibrator device
• Connect and enjoy

---

🎮 Tested in Games

Direct Lovense Connection

• Helping the Hotties
• Innocent Witches

Intiface Central (ver. 2.6.8)

• Stardew Valley — Buttplug Valley (GitHub) | Nexus Mods
• Terraria — Viberaria (GitHub)
• Celeste — CelestePlug (GameBanana)
• Minecraft — Minegasm (official site) | GitHub

---

⚠️ Issues and Notes

• Small vibration delays may occur when working with Intiface Central.

• Works with the Lovense Remote app in offline mode. Sometimes it also works online, but only if you first turn off the internet, connect the device, and then turn the internet back on. Your toy may be disconnected at any time.

• If the device does not respond to commands, use the additional firmware to determine the HEX values BLE-HEX-Picker

---

🚀 Future Plans

• Support for dual-channel devices (vibration/rotation, vibration/color)
• ESP32 flashing via Web interface
• Extended patterns or record/playback
• Scheduled vibration

---

💡 Support and Feedback

If you have any questions or suggestions, you can contact me:

• 📧 Email: miha.shym@icloud.com
• Please include in subject: LS-Buttplug

If you like this project, support it ⭐

---