Switchbota
Switchbota is a tool that replaces the factory firmware on the SwitchBot Smart Plug Mini over the air, enabling Tasmota without disassembling the device.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
21/100 Low
- Maintained
- 0last commit 978 days ago
- Popular
- 44150 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 201 serious finding, 5 minor, CI
Based on 4 of 5 factors.
Security check: 1 serious finding
- Uses proxy-addr 2.0.7, which has a known critical vulnerability (npm)
Automated checks on commit 8751423, 8 Nov 2026. Not an audit.
Availability: platform listings confirmed today, links checked 17 days ago
- GitHub stars
- 150
- Open issues
- 18
- Last commit
- 2024-03-18
- Latest release
- v1.1
- License
- GPL-3.0
- Activity
- stale
Checked 6 days ago - source: GitHub (kendallgoto/switchbota)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Add your SwitchBot API token and secret Enter the token and secret from your SwitchBot account in the app settings before starting. The app uses the secret to sign requests, so a missing or wrong value makes API calls fail. source
- Use a reachable HTTPS webhook URL If you use webhooks, give SwitchBot an HTTPS URL it can reach, such as a public domain or tunnel. If the URL is only local or typed wrong, device events won't arrive. source
Fetched 53 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Can I avoid opening the SwitchBot Smart Plug Mini to switch firmware?
Yes. Switchbota enables Tasmota without disassembling the device.
Does Switchbota update the plug over the air?
Yes. It replaces the default firmware via an OTA update.
Does Switchbota make Tasmota usable on the plug?
Yes. It enables the use of Tasmota open-source firmware.
Answers sourced from github.com
Community
- TrySwitchBot - Reddit (reddit)
- switchbot - Reddit (reddit)
Collected 49 days ago - public community threads