Sensors

Zepp2Hass

davidepalleschi/zepp2hass · vv1.0.8

HACSLocal push

Connect your Zepp smartwatch to Home Assistant and track your health & fitness data in real-time

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

Entity	Shows up as	Note
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`sensor`	Sensor (temperature, humidity, air quality…)

What people report

Many Amazfit watches are listed as supported, but recent users report the Active, Active 2 and T-Rex 3 never sync. Older models like GTS 4 Mini are not supportable.

Works4
Partly works1
Not working3
Won’t be supported1

Device	In Home Assistant	What they said	Source
Amazfit Balance	Works	Listed as supported Saved copy Supported devices: Amazfit Balance; Amazfit Balance 2; Amazfit Balance 2 XT; Amazfit T-Rex Ultra; Amazfit T-Rex 3; Amazfit T-Rex 3 Pro (44mm); Amazfit T-Rex 3 Pro (48mm); Amazfit Cheetah (Round); Amazfit Cheetah (Square); Amazfit Cheetah Pro; Amazfit Cheetah Pro Kelvin Kiptum; Amazfit Active; Amazfit Active Edge; Amazfit Active Max; Amazfit Active 2 (Round); Amazfit Active 2 NFC (Round); Amazfit Active 2 (Square); Amazfit Active 2 NFC (Square); Amazfit GTR 4; Amazfit GTR 4 Limited Edition; Amazfit GTS 4; Amazfit Bip 5 Unity; Amazfit Bip 5 Core; Amazfit Bip 6; Amazfit Falcon. Excerpt saved from the README on 2026-10-23.	README
Amazfit Bip 6	Works	Sensors went unavailable on HA 2026.1, then recovered on their own Saved copy After upgrading to HA 2026.1 the integration stopped working. Sensors from my Amazfit Bip 6 are unavaliable. In the HA logs I can se the following error: ``` ^[[31m2026-01-09 22:19:23.874 ERROR (MainThread) [aiohttp.server] Error handling request from 192.168.100.55 Traceback (most recent call last): File "/usr/local/lib/python3.13/site-packages/aiohttp/web_protocol.py", line 510, in _handle_request resp = await request_handler(request) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.13/site-packages/aiohttp/web_app.py", line 569, in _handle return await handler(request) … Excerpt saved from GitHub on 2026-10-23.	Issue #6 · 2026-01
Amazfit Cheetah Pro	Works	Listed as supported Saved copy Supported devices: Amazfit Balance; Amazfit Balance 2; Amazfit Balance 2 XT; Amazfit T-Rex Ultra; Amazfit T-Rex 3; Amazfit T-Rex 3 Pro (44mm); Amazfit T-Rex 3 Pro (48mm); Amazfit Cheetah (Round); Amazfit Cheetah (Square); Amazfit Cheetah Pro; Amazfit Cheetah Pro Kelvin Kiptum; Amazfit Active; Amazfit Active Edge; Amazfit Active Max; Amazfit Active 2 (Round); Amazfit Active 2 NFC (Round); Amazfit Active 2 (Square); Amazfit Active 2 NFC (Square); Amazfit GTR 4; Amazfit GTR 4 Limited Edition; Amazfit GTS 4; Amazfit Bip 5 Unity; Amazfit Bip 5 Core; Amazfit Bip 6; Amazfit Falcon. Excerpt saved from the README on 2026-10-23.	README
Amazfit GTR 4	Works	Listed as supported Saved copy Supported devices: Amazfit Balance; Amazfit Balance 2; Amazfit Balance 2 XT; Amazfit T-Rex Ultra; Amazfit T-Rex 3; Amazfit T-Rex 3 Pro (44mm); Amazfit T-Rex 3 Pro (48mm); Amazfit Cheetah (Round); Amazfit Cheetah (Square); Amazfit Cheetah Pro; Amazfit Cheetah Pro Kelvin Kiptum; Amazfit Active; Amazfit Active Edge; Amazfit Active Max; Amazfit Active 2 (Round); Amazfit Active 2 NFC (Round); Amazfit Active 2 (Square); Amazfit Active 2 NFC (Square); Amazfit GTR 4; Amazfit GTR 4 Limited Edition; Amazfit GTS 4; Amazfit Bip 5 Unity; Amazfit Bip 5 Core; Amazfit Bip 6; Amazfit Falcon. Excerpt saved from the README on 2026-10-23.	README
Amazfit Active Max	Partly works	Likely compatible per maintainer, but a user reports sync stuck Saved copy I am planning to purchase an Amazfit Active Max and I would like to integrate it into my Home Assistant using Zepp2Hass. I've checked the README and the current list of compatible devices, but this specific model is not explicitly listed. Before proceeding with the purchase, I would like to clarify the nature of this absence: - Technical Limitation: Is there a known technical limitation that prevents this model from working? - Untested/Unlisted: Is it simply a case where the device hasn't been tested yet, or the documentation hasn't been updated. - Extensibility: If it’s currently … Excerpt saved from GitHub on 2026-10-23.	Issue #23 · 2026-04
Amazfit Active	Not working	Integration does not work; curl to webhook succeeds but watch never syncs Saved copy For my Amazfit Active, the integration does not seem to work. Here are the technical details: - Home Assistant Supervised as docker container (version 2026.5.1) - Zepp2Hass Integration Version 1.0.7 - Webhook URL: http://192.168.178.25:8123/api/webhook/b237a ... - Amazfit Firmware version 6.2.8.1 - api level: 306 What works: - Using curl on another computer as described in the docs: status is ok and value appears in HA - Changing the Zepp2Hass settings in the Zepp app. When changing the interval and clicking "Apply Settings", the correct interval appears on my watch. What does not work: - … Excerpt saved from GitHub on 2026-10-23.	Issue #28 · 2026-05
Amazfit Active 2 (round and square)	Not working	No sync from the watch despite webhook working Saved copy For my Amazfit Active, the integration does not seem to work. Here are the technical details: - Home Assistant Supervised as docker container (version 2026.5.1) - Zepp2Hass Integration Version 1.0.7 - Webhook URL: http://192.168.178.25:8123/api/webhook/b237a ... - Amazfit Firmware version 6.2.8.1 - api level: 306 What works: - Using curl on another computer as described in the docs: status is ok and value appears in HA - Changing the Zepp2Hass settings in the Zepp app. When changing the interval and clicking "Apply Settings", the correct interval appears on my watch. What does not work: - … Excerpt saved from GitHub on 2026-10-23.	Issue #28 · 2026-06
Amazfit T-Rex 3	Not working	Webhook works via curl but watch sync never runs (firmware 4.8.3.5) Saved copy the same problem T-Rex 3. firmware 4.8.3.5 Zepp2Hass 1.4.0 Zepp2Hass Integration Version 1.0.7 Home Assistant HAOS. Core 2026.2.2 Supervisor 2026.05.0Operating System17.1 Excerpt saved from GitHub on 2026-10-23.	Issue #28 · 2026-05
Amazfit GTS 4 Mini	Won’t be supported	Maintainer cannot add; watch OS lacks required APIs Saved copy Hi @miffe, Thank you for your request. Unfortunately, I cannot add support for the GTS4 Mini. The application requires a minimum set of APIs and OS features to function properly, and the current requirements are already set to the minimum. Devices running older operating systems or lower API levels simply do not have the necessary capabilities to run Zepp2Hass. For this reason, I’m afraid this model cannot be supported. I'll close this issue for now. Thank you for understanding! Excerpt saved from GitHub on 2026-10-23.	Issue #18 · 2026-03

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local push

Talks to the device on your network, and the device tells Home Assistant the moment something changes.

Details

Installs (analytics)	335 (0.05%)
GitHub stars	63
Latest version	v1.0.8 (2026-08-31)
Set up in the UI	Yes
Maintainers	@davidepalleschi
License	MIT

Devices listed in its README

Amazfit Balance
Amazfit Balance 2
Amazfit Balance 2 XT
Amazfit T-Rex Ultra
Amazfit T-Rex 3
Amazfit T-Rex 3 Pro (44mm)
Amazfit T-Rex 3 Pro (48mm)
Amazfit Cheetah (Round)
Amazfit Cheetah (Square)
Amazfit Cheetah Pro
Amazfit Cheetah Pro Kelvin Kiptum
Amazfit Active
Amazfit Active Edge
Amazfit Active Max
Amazfit Active 2 (Round)
Amazfit Active 2 NFC (Round)
Amazfit Active 2 (Square)
Amazfit Active 2 NFC (Square)
Amazfit GTR 4
Amazfit GTR 4 Limited Edition
Amazfit GTS 4
Amazfit Bip 5 Unity
Amazfit Bip 5 Core
Amazfit Bip 6
Amazfit Falcon

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.

Sources

Documentation: https://github.com/davidepalleschi/zepp2hass
Source code: https://github.com/davidepalleschi/zepp2hass
Issues: https://github.com/davidepalleschi/zepp2hass/issues
HACS: https://hacs.xyz