Zepp2Hass - Connect your Amazfit/Zepp Watch to Home Assistant!

Share your Projects! Custom Integrations
1

Hi everyone! :waving_hand:

I’m excited to share a project I’ve been working on: Zepp2Hass!

:red_question_mark: The Problem

If you own an Amazfit or Zepp smartwatch (like the T-Rex, GTR 4, Balance, Cheetah, etc.), you might have noticed that getting your health and activity data into Home Assistant is not possible. I wanted a way to push data directly and locally from my watch to Home Assistant.

:light_bulb: The Solution

Zepp2Hass is a two-part solution:

  1. A Home Assistant Custom Integration (available via HACS).
  2. A Zepp OS Watch App (available independently).

The watch app sends your data directly to a local webhook in Home Assistant. No cloud delays, no middleware!

:sparkles: Key Features

  • :satellite_antenna: Real-time Data: Pushes heart rate, steps, battery level, and more directly to HA.
  • :battery: Battery Efficient: Configurable update intervals (1-5 mins) to balance data freshness and battery life.
  • :bar_chart: Comprehensive Sensors:
    • Health: Heart Rate (last, resting, max), SpO2, Stress, Body Temp.
    • Activity: Steps, Calories, Distance, Stand count.
    • Sleep: Sleep score, duration, deep sleep, sleep stage times.
    • Device: Battery level, screen status, device info.
  • :globe_with_meridians: Easy Setup: The integration provides a dedicated web interface to easily get your webhook URL.

:mobile_phone: Supported Devices

Works on most devices running Zepp OS 3.0 or higher.

:rocket: How to Install

  1. Home Assistant:

    • Search for “Zepp2Hass” in HACS and install it.
    • Go to Settings → Devices & Services, add the integration, and follow the instructions to get your Webhook URL.

  2. Watch:

    • Open the Zepp App on your phone.
    • Go to the App Store and search for “zepp2hass”.
    • Install it on your watch.
    • In the app settings (on the phone), enter your Webhook URL.

:link: Links

I’d love to hear your feedback! Let me know if you have any questions or feature requests. :backhand_index_pointing_down:

Happy tracking! :man_running:

3 Likes
2

Nice, I will definitely give it a try. I’m using HA Companion on a Balance to control HA, but retrieving sensor data from the watch is patchy ATM.

Do you have some dashboards built around those sensors to share (would love a cardio graph and maybe a sleep graph too) ?

3

I’m running my Home Assistant through a reverse proxy. So should I still use the webhook as posted by the integration? I can’t seem to get any of the sensors to populate. Perhaps it only works when the watch/phone is connected locally to the network?

4

Nevermind. I just adjusted the custom webhook url in the integration and it works like a charm. Thank you so much for this.

5

Hi, sorry, I’m new at HomeAssistant, but I can’t find the Integration “Zepp2Hass”… . what do I wrong? I go to settings, Devices and Services, Add Integration and search for Zepp2Hass, but nothing is found…

6

Hi,

I’ve been trying to understand how Zepp2Hass achieves reliable background sensor sync. From my understanding of Zepp OS architecture, HTTP requests from the watch must go through the phone’s Zepp App (Side Service), which gets suspended by the OS when idle - especially on iOS.

How does Zepp2Hass work around this limitation? Do users need to disable battery optimization for the Zepp App, or is there another technique being used?

Thanks!

7

Bonjour,
Le weebhook ne fonctionne pas :frowning:

8

Has anyone else had any issues since the last update? The app on the watch says its sync’ing ok but all my sensor in Home Assistant are showing as “Unavailable”.

image
image1309×903 67.8 KB

9

Hi @davidepalleschi , I have just installed but when opening the zepp2hass configuration on phone I just get a blank screen.

Tried to use with an amazfit bip 6 on samsung galaxy phone.

Any suggestion ?

10

Today it just worked, maybe it need some time or are using any server resource that was not available yesterday.