Home Documentation Blog Login
Home Documentation Blog Privacy Terms

Watchdrip: Connect your Amazfit smartwatch with Nightscout

Watchdrip app for Amazfit watches (Zepp OS). Display glucose from xDrip+ on your watch face. Installation, setup, supported models, and watch faces.

Watchdrip - glucose on your Amazfit smartwatch (Zepp OS)

While writing documentation for glucose monitoring apps, I could not ignore a project that is gaining real traction among Amazfit smartwatch users. I mean Watchdrip - an app that displays glucose readings directly on the watch face using data from xDrip+.

If you use a watch with Zepp OS and want constant access to your glucose level, this guide is for you. I will cover the essentials: the author, supported models, installation, and the most common problems.

What is Watchdrip? An app for the DIY community

Watchdrip is a miniprogram (miniapp) designed for smartwatches running Zepp OS (Amazfit and some Xiaomi models). Its main job is to receive glucose data from your phone (where xDrip+, Juggluco, or AAPS is running) and send it to your smartwatch.

Unlike official manufacturer solutions, Watchdrip is a community project built by DIY diabetes enthusiasts. It frees you from checking your phone all the time - you can check your wrist instead. That is a huge convenience, especially during exercise, driving, or at night.

Author and development

Watchdrip was created by a developer known as bigdigital. He actively develops the app, releases updates, and listens to user feedback. The project can be supported on Patreon, where bigdigital publishes the latest beta versions and progress updates.

This matters because Watchdrip changes quickly, especially when Zepp OS changes (for example, updates to version 3.5 or 4.0 often break compatibility). For users, that means it is worth following the creator's channels so you do not miss important fixes.

How does Watchdrip work? (Architecture)

The idea is simple, but you need to understand it to configure everything correctly:

  1. Phone (xDrip+): An app such as xDrip+ receives data from your CGM system (Dexcom, Libre with a bridge, etc.).

  2. Bridge (WatchDrip+ app): You install an additional app on your phone - WatchDrip+ (Android). It pulls data from xDrip+ and sends it via Bluetooth to the watch.

  3. Watch (Watchdrip miniapp): You install the Watchdrip miniprogram on the watch (the Zepp OS version). It runs in the background and receives data from the phone.

  4. Watch face: You install a special watch face programmed to display data from the Watchdrip miniprogram.

In short: xDrip+ -> WatchDrip+ (phone) -> Bluetooth -> Watchdrip (watch) -> Watch face.

Supported smartwatches and requirements

This is the crucial section - not every Amazfit watch will work. Watchdrip is designed for models with Zepp OS (version 1.0 or newer). Older models with RTOS (for example Bip, Bip S, GTS, GTR 1 and 2) are not supported.

Confirmed and supported models (based on information from the author's website and changelog):

  • Amazfit Balance (and Balance Max)

  • Amazfit Active / Active 2 (round version and Square Premium - from v2.0.6+)

  • Amazfit Active Edge

  • Amazfit GTR 3 / GTR 3 Pro

  • Amazfit GTS 3 / GTS 4 / GTS 4 Mini

  • Amazfit T-Rex 3 (and T-Rex 3 Pro - from v2.0.7+)

  • Amazfit Band 7

  • Amazfit Bip 5 / Bip 6 (partially, requires an older Zepp version)

  • Amazfit Cheetah / Cheetah Pro

  • Xiaomi Mi Band 8 Pro (with Zepp OS)

NOTE: The latest models with Zepp OS 4.0 (for example some Amazfit Balance units after an update) and Zepp OS 3.5 may have issues. Always check the changelog for the latest app version. The creator responds quickly, but sometimes you have to wait for fixes.

How to check whether your watch is supported

  1. Go to watchdrip.org/apps/watchdrip-app/.

  2. Find your Zepp OS version (Settings -> System -> About on the watch).

  3. Check whether your model is listed in the description or changelog.

Step-by-step installation

Installation may look complicated, but after doing it once, it becomes straightforward. Here is the route I recommend:

1. Prepare your phone (Android)

  • Install and configure xDrip+ (or Juggluco) - the app must receive data from your CGM.

  • Download and install WatchDrip+ (available on the author's website or GitHub). This is the bridge app.

  • Launch WatchDrip+ and grant all required permissions (location, notifications). Make sure it can see data from xDrip+.

2. Prepare the watch and Zepp app

  • Open the Zepp app on your phone.

  • Pair the watch (if it is not paired yet).

  • Enable developer mode: in Zepp, go to Profile -> Settings -> About -> tap the Zepp logo several times until a message appears.

3. Install the Watchdrip miniprogram on the watch

  • Open a browser on your phone and go to: https://watchdrip.org/apps/watchdrip-app/

  • Find the QR code for the latest version (currently v2.0.7).

  • In the Zepp app, go to Profile -> Zepp OS -> Miniprograms -> + (add) -> Scan QR code.

  • Scan the QR code from the website.

  • Zepp will download and install the miniapp. If you see the error "Parse miniprogram package failed", it often means incompatibility with the specific Zepp OS version on your watch (look for an older miniapp version).

4. Install a dedicated watch face

  • You will find dozens of watch faces on watchdrip.org.

  • Choose a watch face (for example F17 Square Version, WD-Sport, or Big BG). Each one has its own QR code.

  • In Zepp: Profile -> My watch faces -> + -> Scan QR code and scan the watch face code.

  • The watch face will be added to your collection. Apply it on the watch.

5. Launch and test

  • Launch the Watchdrip miniprogram manually on the watch (you will find it in the app list).

  • It should show the connection status with the phone and the latest glucose value.

  • You can now return to the main watch face - it should display your current glucose level.

Common problems and fixes

Based on user comments (including those under the post on watchdrip.org), I prepared a list of frequent errors:

Error / Symptom

Likely cause

Fix

Scanning the QR code for the miniapp ends with an error: "Download failed, error code: null" or "Parse mini program package failed"

1. Developer mode is not enabled in Zepp
2. Zepp OS version incompatibility on the watch
3. Zepp account region

1. Make sure developer mode is enabled.
2. Try an older version of the Watchdrip miniapp (for example v1.3.1 or v2.0.2).
3. Change the Zepp account region to GBR or USA (VPN sometimes helps during scanning).

The watch face does not display values (shows ---, 0, or nothing). The miniapp shows "No data"

1. WatchDrip+ is not running in the background on the phone.
2. xDrip+ is not sending data.
3. Old miniapp version on the watch.

1. Check whether WatchDrip+ has battery optimizations disabled and can run in the background.
2. In xDrip+, check whether the data is current.
3. Update the Watchdrip miniapp to the latest version (or do the opposite - go back to an older, more stable one).
4. Restart the watch and phone.

It stopped working after a Zepp OS update (for example to 3.5 or 4.0).

Zepp OS API changes that break compatibility.

This is the most common problem. Check the author's Patreon or the xDrip forum for updates. Often you need to uninstall the miniapp and watch face, then install the latest version of Watchdrip (the creator usually reacts quickly). If the new version does not work, install an older one (sometimes newer Zepp OS requires an older miniapp).

The miniapp installs, but after launch it only shows "Watchdrip" and the version, with no data. Watch faces refuse to install.

1. Incorrect WatchDrip+ bridge installation.
2. Only the "old" miniapp version (v1.x) is installed on a new Zepp OS version.
3. The watch face is not made for your model.

1. Uninstall the Watchdrip miniapp and install a newer version (v2.0.x).
2. Reinstall the WatchDrip+ app on your phone.
3. Make sure the watch face you scan has Zepp OS in its name or comes from the newer list (for example WD-Rotor, WD-Simply).

After closing the miniapp or restarting the watch, data disappears from the watch face.

The miniapp is not set to start automatically in the background.

After restarting the watch, manually launch the Watchdrip miniapp at least once. Some watch faces include built-in miniapp "wake-up" behavior - check the watch face description.

Error while installing a watch face: "watch face does not support bound device"

The watch face is not compatible with your watch model (resolution, screen aspect ratio).

Look for watch faces marked Square or versions made for your model. The author often publishes separate versions for round and square screens.

Watchdrip - list of watch faces and their features

The author provides dozens of free watch faces on his website. There is no official store there - each watch face has its own QR code. Here are a few that stand out:

Watch face name

Characteristics

F17 / F17 Square Version

Classic and readable. Large BG display. One of the more popular options.

WD-Sport

Sport version with additional data (heart rate, steps, date).

Big BG / Big BG Square Version

Maximized glucose reading - ideal for people with weaker eyesight.

WD-Simply

Minimalist: only time and glucose. Saves battery.

WD-Orange

Color accents. BG levels change color depending on the range.

WD-Rotor (from comments)

A newer watch face, often recommended for models with Zepp OS 4.0.

Installing a watch face works the same way as installing the miniapp - scan the QR code through Zepp in the My watch faces section. After installation, you can also use watch faces from other sources (watchdrip.org), but make sure they are marked for Zepp OS.

Summary - is it worth it?

Definitely YES, if:

  • You use xDrip+ / AAPS.

  • You have a smartwatch with Zepp OS (Amazfit GTR 4, Balance, T-Rex 3, etc.).

  • You want a convenient glucose view on your wrist for free.

  • You are not afraid of configuration and understand that this is a community project (sometimes it requires a bit of "fighting" with updates).

Related articles

Zukka - xDrip for iPhone (iOS) Apple Store
Technology

Zukka - xDrip for iPhone (iOS) Apple Store

Juggluco - what is it and why are more and more people with diabetes using it?
Technology

Juggluco - what is it and why are more and more people with diabetes using it?

xDrip+ for CareLink - how to automatically sync data with Nightscout
Guide

xDrip+ for CareLink - how to automatically sync data with Nightscout