See noble prerequisites for your OS. (This is used for BLE connection.)
Click Install
Configuration
If using OpenAPI Connection
Download SwitchBot App on App Store or Google Play Store
Register a SwitchBot account and log in into your account
Generate an Token within the App
Click Bottom Profile Tab
Click Preference
Click App version 10 Times, this will enable Developer Options
Click Developer Options
Click Copy token to Clipboard
Input your token into the config parameter
Generate an Secret within the App
Click Bottom Profile Tab
Click Preference
Click App version 10 Times, this will enable Developer Options
Click Developer Options
Click Copy secret to Clipboard
Input your secret into the config parameter
If using BLE Connection
Download SwitchBot App on App Store or Google Play Store
Register a SwitchBot account and log in into your account
Click on Device wanting to connect too plugin
Click the Settings Gear
Click Device Info
Copy BLE Mac aka deviceId
Input your deviceId into the Device Config
Troubleshooting
If using Linux / Raspberry Pi OS
bluetoothctl must be installed on the device, otherwise it cannot communicate via Bluetooth. Enable it with sudo bluetoothctl power on.
If errors occur, while enabling it, restart the process:
rfkill block bluetooth
rfkill unblock bluetooth
Also make sure, that the computer can discover the SwitchBot device:
sudo bluetoothctl
scan on
This lists all discovered Bluetooth devices. The BLE address of the SwitchBot device should be included in this list, otherwise your computer does not discover it.