Skip to content

Zepp OS extras

Experimental settings

Some Zepp OS features are experimental - they are not fully tested, and they can be unstable. Use them at your own risk.

To enable them:

  1. Open " Settings → Developer options" in the main menu, and enable "Experimental settings".
  2. Open " Device specific settings" for the watch. Go to "Experimental settings", and enable the features that you want to use.
  3. Reconnect the watch.
Setting Description
App management Manage the installed apps from Gadgetbridge. It is possible to uninstall system apps, which may be dangerous. The UI sometimes does not refresh.
Assistant service Receive the voice from the Alexa / Zepp Flow assistant. This adds the "Voice Assistant" screen in "Developer settings", with debug options and the voice service preferences.

Assistant voice service

Not yet released

Support for this feature has been added to Gadgetbridge's codebase, but is not yet released. It is already available in the nightly releases.

Added in pull request #7233.

Gadgetbridge can send the voice from the watch assistant (Alexa / Zepp Flow) to a voice service app on the phone. The voice service app can then send a text reply back, and the watch displays it.

To use it:

  1. Enable the assistant service experimental setting, and reconnect the watch.
  2. Open "Device specific settings" → "Developer settings" → "Voice Assistant".
  3. Set "Voice service package" and "Voice service class" to the package name and the full class name of the service in the voice service app.

Voice Service API

Gadgetbridge binds to the configured service with the following action:

nodomain.freeyourgadget.gadgetbridge.VOICE_COMMAND

Gadgetbridge sends Messages to the service's Messenger. Each message has a replyTo messenger.

what Direction Extras Description
0 Gadgetbridge → Service VOICE_DATA (byte array), VOICE_ENCODING (always "OPUS") One Opus frame, 16 kHz, mono.
1 Gadgetbridge → Service none The recording ended. The service can now send its reply.
100 Service → Gadgetbridge TITLE, SUBTITLE, TEXT (strings) The reply to show on the watch. If TITLE and SUBTITLE are empty, the watch shows only TEXT.
101 Service → Gadgetbridge TEXT (string) An error message to show on the watch.

Decoding workout summary

The workout summary consists of 2 bytes containing the summary version, followed by a protobuf encoded payload.

You can decode it using the following, for version 0x0080:

cat null_summary.bin | \
    dd bs=1 skip=2 | \
    protoc --decode WorkoutSummary --proto_path ~/workspace/Gadgetbridge/app/src/main/proto huami.proto

Change region

You can use the Device Settings Intent API to change the device region, by setting the device_region string preference (added in commit 483ef27a4f). The region should be a 2-letter code (eg. de for Germany).