@switchbot/homebridge-switchbot
Advanced tools
The SwitchBot plugin allows you to access your SwitchBot device(s) from HomeKit.
The Homebridge SwitchBot plugin allows you to access your SwitchBot Device(s) from HomeKit with Homebridge.
@switchbot/homebridge-switchbot
token to Clipboardtoken into the config parametersecret to Clipboardsecret into the config parameterdeviceIddeviceId into the Device Configbluetoothctl 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 bluetoothrfkill unblock bluetoothAlso make sure, that the computer can discover the SwitchBot device:
sudo bluetoothctlscan onThis 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.
Security & Privacy -> Privacy to the node executable, eg /usr/local/bin/node
(This is what is intended in documentation for the noble bluetooth package prerequisites by "Add terminal app", however for HomeBridge it is node that needs the permission granted, not terminal.
Without this step, then you will receive the following error when the swichbot plugin launches, which will cause Homebridge or the child bridge process to restart:Error: Failed to initialize the Noble object: unauthorized
at Noble.<anonymous> (file:///usr/local/lib/node_modules/@switchbot/homebridge-switchbot/node_modules/node-switchbot/src/switchbot.ts:244:19)
at Object.onceWrapper (node:events:629:26)
at Noble.emit (node:events:514:28)
at Noble.onStateChange (/usr/local/lib/node_modules/@switchbot/homebridge-switchbot/node_modules/@stoprocent/noble/lib/noble.js:92:8)
at NobleMac.emit (node:events:514:28)
deviceId & deviceName to Device ConfigEnable Bluetooth Low Energy (BLE) Connection on Device ConfigdeviceId & deviceName to Device ConfigEnable Bluetooth Low Energy (BLE) Connection on Device ConfigdeviceId & deviceName to Device ConfigEnable Bluetooth Low Energy (BLE) Connection on Device ConfigdeviceId & deviceName to Device ConfigEnable Bluetooth Low Energy (BLE) Connection on Device ConfigOn or OffdeviceId & deviceName to Device ConfigEnable Bluetooth Low Energy (BLE) Connection on Device Config4.3.1 (2025-03-04)
Full Changelog: https://github.com/OpenWonderLabs/homebridge-switchbot/compare/v4.3.0...v4.3.1
FAQs
The SwitchBot plugin allows you to access your SwitchBot device(s) from HomeKit.
The npm package @switchbot/homebridge-switchbot receives a total of 392 weekly downloads. As such, @switchbot/homebridge-switchbot popularity was classified as not popular.
We found that @switchbot/homebridge-switchbot demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket now scans OpenVSX extensions, giving teams early detection of risky behaviors, hidden capabilities, and supply chain threats in developer tools.
Product
Bringing supply chain security to the next generation of JavaScript package managers
Product
A safer, faster way to eliminate vulnerabilities without updating dependencies