Skip to content

Installation

Donavan Becker edited this page Oct 9, 2021 · 1 revision

1. Install

Homebridge UI

  • Simply go to the 'Plugins' page
  • Search switchbot
  • Find @switchbot/homebridge-switchbot
  • Click Install
  • Finally Configure

Manually

This will only work if you are using a platform which installs plugins globally.

sudo npm install -g --unsafe-perm @switchbot/homebridge-switchbot

2. Configure

If you use the Homebridge UI then a configuration screen will appear after installing the plugin where you can enter your Switchbot OpenAPI you got from the SwitchBot App. If you are wanting to use BLE connection then got to Plugin UI Device section and copy Device ID and input into BLE Settings under Advance Settings.

See the Configuration page for JSON configuration templates and other optional settings if editing the configuration manually.

3. Restart

And voila your supported SwitchBot devices are added to your Homebridge instance and Home App.