homebridge-sleepys-elite
v1.2.5
Published
Homebridge dynamic platform plugin for Sleepy's Elite / BOX25 adjustable beds
Maintainers
Readme
homebridge-sleepys-elite
Unofficial Homebridge dynamic-platform plugin for Sleepy's Elite / BOX25 adjustable beds.
Features
- Head, feet, and lumbar position control
- Under-bed light on/off, 0–100% brightness, and full RGB color control
- Persistent Bluetooth connection with an hourly lightweight connection check, stale-session detection, bounded reconnect backoff, and one-shot command retry
- Hard timeouts for discovery, connection, GATT setup, command writes, and cleanup so stalled BlueZ calls cannot block recovery
- Serialized Bluetooth writes, stale-device removal, and full D-Bus session cleanup on reconnect
- Physical-remote position, light-power, and RGB color updates reflected in HomeKit
- Debounced slider commands
- Queued motor requests with one motor movement at a time
- Native Node.js Bluetooth over BlueZ/D-Bus
- No Python, virtual environment, or Bleak setup
Requirements
- Homebridge 2.x
- Node.js 22.12+ or 24.x
- Linux/Homebridge host with Bluetooth and BlueZ
On a standard Homebridge Raspberry Pi image, installation is intended to be:
- Install the plugin in Homebridge.
- Leave the Bluetooth name prefix as
Star25unless your bed advertises differently. - Save/restart Homebridge.
No Python setup is required.
Configuration
- Name: HomeKit accessory name.
- Bed Bluetooth Name Prefix: defaults to
Star25.
Current status
Tested with a Sleepy's Elite BOX25 controller advertising as Star25....
Disclaimer
This is an unofficial community project. It is not affiliated with, endorsed by, sponsored by, or supported by Sleepy's or Mattress Firm.
Sleepy's and related names and trademarks are the property of their respective owners. Product names are used only to identify compatibility with this software.
Use this software at your own risk. This project communicates directly with adjustable-bed hardware over Bluetooth and is provided without warranty.
Credits
This project benefited from Bluetooth protocol research and documentation in the ha-adjustable-bed project by Kristoffer R. and its contributors:
https://github.com/kristofferR/ha-adjustable-bed
See THIRD_PARTY_NOTICES.md for attribution details.
License
MIT
Split-bed systems
The plugin supports one adjustable-base controller per Homebridge plugin instance. Split-bed configurations with two independent controllers are not supported.
