https://github.com/kwintenvdb/homebridge-divoom
https://github.com/kwintenvdb/homebridge-divoom
ditoo divoom hacktoberfest homebridge plugin
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/kwintenvdb/homebridge-divoom
- Owner: Kwintenvdb
- License: apache-2.0
- Created: 2020-09-26T09:59:46.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-03-04T10:38:49.000Z (over 2 years ago)
- Last Synced: 2024-04-24T04:11:46.220Z (about 1 year ago)
- Topics: ditoo, divoom, hacktoberfest, homebridge, plugin
- Language: TypeScript
- Homepage:
- Size: 440 KB
- Stars: 12
- Watchers: 4
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Homebridge Divoom Plugin
This [Homebridge](https://github.com/homebridge/homebridge) allows you to control your [Divoom](https://www.divoom.com/) devices from Apple's HomeKit.
**Note:** only tested on a single Divoom Ditoo, other types of Divoom devices or multiple devices might not be supported currently.
Credit to [node-divoom-timebox-evo](https://github.com/RomRider/node-divoom-timebox-evo) for doing the majority of the legwork to properly reverse-engineer the protocol and exposing it in a nice API.
## Prerequisites
**Only supports up to Node v12.x currently. Later versions will not work.**
On Linux, install the Bluetooth development packages in order to build [node-bluetooth-serial-port](https://github.com/eelcocramer/node-bluetooth-serial-port).
`apt-get install build-essential libbluetooth-dev`
## Installing the plugin
`npm install -g homebridge-divoom`
## Configuration
1. Ensure the Divoom device is paired with the device running the Homebridge server.
2. Find out the Divoom device's MAC address.
* I recommend using BlueZ, run `apt-get install bluez` then `bluetoothctl` to retrieve the MAC addresses of all paired devices.
### Homebridge config
After installing the plugin, add the following to the `platforms` array of your `config.json` or through the Config menu in the Homebridge UI. Replace `DIVOOM_MAC_ADDRESS` by the MAC address of the Divoom device.
```json
"platforms": [
{
"platform": "DivoomPlatform",
"devices": [
"DIVOOM_MAC_ADDRESS"
]
}
]
```
## Capabilities
Current features:
* Changing display brightness
* Changing display color
* Note: changing the display color wil automatically switch the device to the "time" channel.
* Changing volume
Planned features:
* TBD