Discover advertisements from affordable Bluetooth scales, thermometers and other BLE gadgets — no vendor app or cloud account required for supported broadcasts. Recognizing a device is not the same as having ESPHome YAML: our LC026 scale is currently the only profile with independently verified YAML generation.
Before flashing: the initial BLE Scanner replaces any firmware already on your ESP32. Back up an existing ESPHome configuration first. Use a spare board when possible. Only click Install on the correct USB device.
Select the board you own, e.g. ESP32 DevKit / WROOM-32. This same selection is used for the temporary scanner AND the final ESPHome YAML.
Type to search.
… ESP32 models listed; … have ready-to-install scanners.
Board list loaded. Initializing scanner controls… If this message stays, reload the page or open the full generator tab (JavaScript is not running).
Check your ESP32 model and USB port.
Checking BLE Scanner firmware…
Warning: installing the scanner replaces any firmware already on your ESP32. Back up first or use a spare board. If your model is “YAML preview only”, use a supported ESP32 for live scanning or import a compatible scan rather than attempting an unsupported installation.
Live scan: install the temporary SHWM BLE Scanner firmware from Step 1, connect your ESP32 via USB, then click Scan nearby BLE and select its COM port. Wake your Bluetooth device to make it advertise. Devices and supported decoded measurements appear below. Normal ESPHome firmware does not send scanner JSON data; this website cannot read ESPHome sensors automatically.
Ready to scan. Requires an ESP32 with temporary SHWM scanner firmware and USB cable.
Live results: new devices are added to the bottom of a stable list. Measurements refresh roughly once per second; BLE capture continues at full speed. Click Select to view a device. No devices? Check the scanner firmware, USB port and whether your gadget is advertising.
| Choose | Device name | Signal | Reading | Packets | Last seen |
|---|
First appearance and significant changed messages, oldest first. At most 300 records are retained in this browser tab; no data is uploaded. A history record may include a Bluetooth address.
| Time | Device | Signal | Captured result |
|---|
Copy JSON lines from the SHWM USB Scanner serial output and paste them below (one JSON object per line). Then click Read pasted data. You do not copy RAW into Decoded — both are automatically displayed in Step 3.
Decoder engine: Loading…
Received 0 packets; recognized devices: 0; waiting for BLE advertisements.
No device selected. Click Scan nearby BLE in Step 2 and wake your device.
Your decoded reading will appear here.
YAML requires a verified, stable LC026 scale reading. Other recognized devices do not yet have validated YAML templates.
RAW is the original Bluetooth message. Decoded is what the decoder understood. Both are read-only results; you do not paste anything between them.
No device selected
No device selected
Your YAML will target the ESP32 selected in Step 1. Change board ↑
Only the independently validated LC026 scale profile has a YAML generator today. Results recognized by Theengs do not automatically become ESPHome sensor drivers.
secrets.yaml, click Validate, then Install → Manual download to compile the final firmware.Remember: installing ESPHome replaces the temporary scanner. ESPHome Web does not compile YAML; compilation happens in Device Builder. Choosing an ESP32 board alone cannot generate code for unknown Bluetooth devices.