Link your switchbot devices to homebridge!
npm install @joseantmazon/homebridge-switchbot 
SwitchBot meets Homekit! This plugins uses SwitchBot's Open API to connect your devices to Homekit through Homebridge.
1. Go to Plugins from the Homebridge web UI
2. Find @joseantmazon/homebridge-switchbot
3. Hit Install
You only need to set your SwitchBot keys to get started. To do so, you'll have to:
1. Download SwitchBot App on App Store or Google Play Store and log in
3. Generate your keys within the App
- Click Profile on the bottom navigation menu
- Click Preferences
- Click App version 10 times to enable Developer Options
- Click Developer Options
- Input your token and secret into the configuration parameters.
Your homebridge config file would look similar to this afterwards:
``json`
{
"platforms": [
{
"platform": "Homebridge Switchbot Reloaded",
"name": "@joseantmazon/homebridge-switchbot",
"settings": {
"api": {
"token": "
"secret": "
"url": "https://api.switch-bot.com/v1.1"
}
}
}
]
}
Bear in mind that Switchbot's API does not allow to query the status of IR devices and therefore I may only provide a best effort approach by storing the result of the most recent operation. Hence, operating infrared devices by means other than this plugin may result in an inaccurate display of information through Homebridge.
Capabilities
- On/Off
- Volume controls
Capabilities
- On/Off
- Temperature
- Operation mode (auto, heat or cool)auto
- Fan speed (, low, medium or high)
Overrides
- auto operation mode can be overriden through the configuration so it behaves as heat or cool.`
- For all devices:
json`
{
"platforms": [{
"platform": "Homebridge Switchbot Reloaded",
"name": "@joseantmazon/homebridge-switchbot",
"settings": {
"overrides": {
"thermostats": {
"all": {
"autoOperationMode": "heat"
}
}
}
}
}]
}
`
- For a single device:
json``
{
"platforms": [{
"platform": "Homebridge Switchbot Reloaded",
"name": "@joseantmazon/homebridge-switchbot",
"settings": {
"overrides": {
"thermostats": {
"
"autoOperationMode": "heat"
}
}
}
}
}]
}
Note: single device settings override global directives
Do you want to take part in the development? Please, head to CONTRIBUTING to get started.
The motivation for this plugin was to improve @switchbot/homebridge-switchbot for my personal use case. Therefore, support for other devices is not guaranteed and it will highly depend on contributions, which are more than welcome.