ga2mer / ha-zepp

Home Assistant companion for Zepp OS devices

Home Assistant companion for Zepp OS devices

Application that allows you to control Home Assistant

Features

• (Binary) Sensor status
• Toggle switch
• Toggle light, see its effect (if presented), change its brightness (if this possible)
• Media player support with play/pause, prev/next, volume control
• Input boolean
• Start/stop scripts
• Enable/disable automations
• Update sensors info to Home Assistant REST API (Not stable! Turn off notications on the wearable for most stable experience)

To Do:

• Fix some bugs in the ha-zepp settings page
• Editing colors for lights
• Open for suggestions

Devices supported

• Mi Band 7
• Amazfit Band 7
• Amazfit T-Rex 2
• All other Zepp OS devices, but there is no proper UI for them and you need to add the build configuration yourself

Preparations

Mi Band 7 only

• Modified Zepp App (registration required)
• You need to connect Mi Band 7 to Modified Zepp App the same way you would with Zepp Life (google auth is not supported)
• You can use the official Zepp App, but have to create a custom QR code. Follow this guide for the URL of the QR code you have to adapt.

General steps

• Download the official Zepp App
• You need to enable Developer Mode in Zepp app
• Build and install the ha-zepp application yourself using the Zeus CLI
• Open the application settings and specify the addresses of Home Assistant, Long-lived access token and select the sensors you want to display on Zepp OS device

Home Assistant

• Long-lived access token (you can generate it on your-ha-instance.local/profile page)
• "If you are not using the frontend in your setup then you need to add the api integration to your configuration.yaml file."

About the sensor updates to the Home Assitant REST API

Since it is not possible for the general public to access Huami's WEB API, I decided to make a background updater within this app to send the wearable sensor data to Home Assistant. It uses the alarm mechanism, which can open a page even when the device is inactive. When this page is opened, the POST requests are performed towards the HA REST API. However, notifications on the device (e.g. app notifications or the calendar notification) are remained open for a while (if you don't swipe it away), which can block this alarm mechanism from showing the ha-zepp page. If the ha-zepp page is blocked by a notification, you will see that if you swipe it away, the ha-zepp page will appear. If you don't swipe it away, the ZeppOS system eventually will remove all stored pages and notifications to save RAM and be more power efficient. If this ha-zepp page is not openend, ha-zepp is unable to create a new alarm, meaning the background updater will break. Therefore, it's best to DISABLE ALL SORT OF NOTIFICATIONS if you want this feature to work properly.

ha-zepp's Issues

Somtimes launches shifted to the right.

Sometimes when i load the app on my Amazfit band 7, everything is shifted to the right.

Mi Account auth

google auth is not supported
What about Mi Account auth support?

iOS Support - Xiaomi Smart Band 7

Any idea on how to make this available for iPhone as well?
I've noticed that the Zepp iOS app is officially supporting the Xiaomi Smart Band 7 - no need to trick the app with the custom QR code with Amazfit Band 7 device source number. However, there's no Developer Mode in device section after enabling it in Settings -> About.

If I use an android device logged into the same Huami/Zepp account to pair it and install the Mini App it unfortunately doesn't transport to the iOS app, not even the device itself.

If I try pairing on iOS with the custom QR with Amazfit Band 7 device source in the URL, I get the image below with the Amazfit Band 7 outline but it's switching automatically to Xiaomi Smart Band 7 when pairing finishes.

Is the developper mode even available for Amazfit Band 7 on iOS?
I managed to decrypt the Zepp ipa but not really sure how and what to modify once decompiled.

Jonah

Endless loading

I compiled the application from the sources and installed the .zab file, but when the application starts, the inscription is loading ... and that's it. Installed via gadgetbridge

Собрал приложение из исходников и установил .zab файл, но при запуске приложения надпись loading...
Установил через gadgetbridge

Usage with Gadgetbridge?

Hi,

the Bangles.js flavor of Gadgetbridge supports APIs for Intents and even full network access as well as limited app-management for the Mi Band 7 (all Gadgetbridge flavors). Is it feasible to make ha-zepp work with Gadgetbridge...?

/hp

Mi band 6

Is it possible to extend support to the Xiaomi Mi Band 6? Or is the guide for the mi band 7 also good for the mi band 6? A thousand thanks

where to input home assistant url? is it in zepp app?

Hi there, I am able to get custom zepp app, but cannot find where to input home assistant url.

Bigger assets

Hi,
do you have please a bigger assets somewhere? I want to increase size of them for T-Rex 2

Thanks :)

`Download failed, error` when scanning QR code

I managed to get the mi band 7 NFC into a modified Zepp app (v7.0.1 - only this version allowed me), I've built the app for mi-band7 with zeus cli, I got the QR code, but when I try to scan the code with the phone I get this error prompt:

Download failed, error
code: null

I've tried installing other apps (Toolbox) by QR code and that works.

Any idea what's wrong?
Thanks!

Home Assistant Voice

What are the possibilities of being able to use the microphone on the smartwatch to give voice commands to Home Assistant?

Too many loaded entities

sry mistake