GitHub - datenbazi/switchbot-w3400010: Passive BLE scanner for SwitchBot W3400010 thermo-hygrometer on Linux — no pairing, no cloud, web UI + Telegram alerts

Passively reads temperature, humidity, and battery from SwitchBot Indoor/Outdoor Thermo-Hygrometer (Model W3400010) over BLE on Linux. No pairing. No official app. No cloud.

_{Image: smarthomescene.com}

Platform Support

Fully static binary — no runtime dependencies, no CGO, no shared libraries. If it runs Linux and has a Bluetooth adapter, it will work.

Features

• Passive BLE scanning — receives broadcasts without pairing or connecting
• Live web UI — real-time charts via SSE, auto-detects new devices
• REST API — query latest readings, history, and export CSV/JSON
• SQLite storage — local, no external dependencies
• Telegram alerts — configurable threshold rules with sustain + cooldown logic
• Privacy mode — toggle MAC address redaction in the UI
• systemd integration — ships with a service unit and a management script

Quick Start

Download a release

Grab the latest release for your architecture from the Releases page:

tar xzf switchbot-temp-<ver>-linux-<arch>.tar.gz
cd switchbot-temp-<ver>/
sudo ./install.sh          # copies to /opt/switchbot-temp, enables systemd service

Or run directly without installing:

sudo ./bt-up.sh            # ensure Bluetooth adapter is ready
sudo ./switchbot-temp      # start scanning; web UI at http://localhost:7700

Build from source

git clone https://github.com/datenbazi/switchbot-w3400010
cd switchbot-w3400010
CGO_ENABLED=0 go build -ldflags="-s -w" -o switchbot-temp .
sudo ./switchbot-temp

Requires Go 1.23+. Cross-compile for ARM:

CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=7 go build -ldflags="-s -w" -o switchbot-temp-armv7l .

Web UI

Open http://localhost:7700 after starting.

• Live temperature and humidity charts per device
• Battery indicator per sensor
• Toast notification on new device discovery
• MAC address redaction toggle (for screenshots / privacy)
• CSV / JSON export

Telegram Alerts

Edit alerts.json with your bot token and chat ID, then start with:

sudo ./switchbot-temp -alerts alerts.json

Alert and recovery messages are sent when thresholds are breached. See USER.md for setup instructions.

Management Script

switchbot.sh manages the daemon without typing raw commands:

./switchbot.sh check      # pre-flight: BT hardware, BlueZ, port, binary
sudo ./switchbot.sh start
sudo ./switchbot.sh stop
./switchbot.sh status
./switchbot.sh log
sudo ./switchbot.sh enable   # install + start as systemd service
sudo ./switchbot.sh disable  # remove systemd service

Documentation

• USER.md — full setup guide, CLI flags, Telegram configuration, troubleshooting
• DEVELOPER.md — architecture, BLE protocol, DB schema, API reference, release packaging

Privacy & Security

Tested Hardware

Other SwitchBot BLE sensors using company ID 0x0969 may work but are untested.

License

MIT