Withings Body+ Scale Synced to Home Assistant via ESP32, Bypassing Cloud

Local Control for Your Smart Scale

The Withings Body+ smart scale, a popular device for tracking weight, body composition, and more, typically relies on cloud synchronization to send data to the Withings Health Mate app and other connected services. For users prioritizing privacy, local control, or simply seeking to integrate their health data into a self-hosted smart home ecosystem like Home Assistant, this cloud dependency can be a significant drawback. A recent project detailed on Hacker News demonstrates a clever solution: bypassing the cloud entirely by using an ESP32 microcontroller to intercept and process the scale's data locally.

The core of this project involves reverse-engineering the communication protocol between the Withings Body+ scale and its mobile app. Unlike many Wi-Fi-enabled devices that offer open APIs or local network access, Withings scales primarily communicate via Bluetooth Low Energy (BLE) to a smartphone, which then uploads the data to their servers. The challenge, therefore, is to capture this BLE communication and translate it into a format Home Assistant can understand, all without relying on external servers.

The author of the project utilized an ESP32, a popular and versatile microcontroller known for its Wi-Fi and Bluetooth capabilities, to act as the intermediary. The ESP32 is programmed to scan for BLE advertisements from the Withings Body+ scale. These advertisements contain encrypted data packets representing the scale's measurements. The critical step is decrypting these packets. While Withings does not publicly document their encryption methods, the open-source community has often found ways to reverse-engineer such protocols. In this case, the ESP32 firmware is designed to perform this decryption, making the raw measurement data accessible.

Once the data is decrypted, the ESP32 then formats it into a message that Home Assistant can consume. This is typically achieved by publishing the data over MQTT (Message Queuing Telemetry Transport), a lightweight messaging protocol well-suited for IoT devices and smart home integration. Home Assistant, running on a local server, subscribes to the relevant MQTT topics. When the ESP32 publishes the scale's measurements, Home Assistant receives them and can then create sensor entities for weight, BMI, body fat percentage, muscle mass, and water percentage. This allows users to track their health metrics directly within their Home Assistant dashboard, alongside other smart home devices.

The implementation details are crucial for replication. The project involves flashing custom firmware onto the ESP32. This firmware needs to be robust enough to handle the BLE scanning, packet decryption, and MQTT publishing reliably. The specific encryption keys and algorithms are derived from analyzing the communication between the scale and the official Health Mate app, a process that requires technical expertise and specialized tools for network and BLE traffic analysis. The author's blog post provides insights into the challenges faced and the methods employed to overcome them.

Advantages of Local Integration

The benefits of this local integration are manifold. Firstly, it significantly enhances user privacy. Health data is sensitive, and by keeping it within a local network, users reduce the risk of data breaches or unauthorized access that can occur with cloud-based services. The data never leaves the user's home network, providing a higher degree of control and peace of mind.

Secondly, it improves reliability and responsiveness. Cloud services can experience downtime, latency issues, or changes in their API that can break integrations. A local solution is typically more stable, as it depends only on the user's local network infrastructure. Data updates can be near real-time, without the delays associated with cloud round-trips.

Thirdly, it fosters interoperability within a smart home ecosystem. By bringing the scale's data into Home Assistant, users can create powerful automations. For example, a user could set up an automation to adjust the smart thermostat based on their body temperature readings (if the scale provides such data, though typically not), or trigger reminders to weigh themselves if the data hasn't been updated recently. It also allows for custom dashboard creation, consolidating all health and home data in one place.

The project also highlights the growing trend of users taking control of their data and seeking open, customizable solutions for their smart home devices. While manufacturers often push proprietary cloud ecosystems, a dedicated community of makers and developers continues to find ways to liberate devices from these constraints, enabling deeper integration and greater user autonomy. This approach is not unique to smart scales; similar efforts are ongoing for various IoT devices that are otherwise locked into vendor-specific clouds.