Skip to content

Xiaomi

Mi Bands usually have fairly accurate step and heart rate sensors. Total sleep hours are measured and info is provided but sleep cycles (light/deep sleep) are not accurately discovered, but the heart rate pattern allows you to observe your sleep patterns very well. Support in Gadgetbridge includes workout tracking and also workouts that require GPS.

Good support

Mi Bands have gained a lot of popularity and have good support in Gadgetbridge.

Mi Band 1

It looks like it is not feasible to have both Mi Fit (now Zepp Life) and Gadgetbridge installed at the same time. issue #330 suggests that Mi Fit (now Zepp Life) restarts itself and automatically connects to your Mi device, preventing Gadgetbridge from functioning properly.

Maybe it is sufficient to deactivate Mi Fit (now Zepp Life) instead of uninstalling it completely.

The first gen Moto G (2013) works fine with the Mi Band when updated to Android 5.1 (most should be), tested with Mi Band firmware 04.15.12.10. Everything seems to work.

Other versions like Android 4.4.x (KitKat) may have problems with the Mi Band - occurred with Mi Band firmware versions:

  • 1.4.0.3 (everything in Gadgetbridge works except fetching activity data)
  • 1.0.9.14 (nothing works, cannot even connect properly)

Mi Band 1A

Given details under Mi Band 1 also apply to this gadget.

Mi Band 1S

Given details under Mi Band 1 also apply to this gadget.

Mi Band 2

This gadget acts almost like the Amazfit Bip, and almost all features that work on the Mi Band 2 already work for Amazfit Bip.

Supported features by Gadgetbridge:

  • Rejecting phone calls
  • Ignoring calls
  • Weather forecast
  • Full text notifications with icons
  • Export of activities with GPS and HR data
  • Flash new watchfaces (with the firmware update tool)
  • Use button for actions
  • Reboot (debug menu)

To display text notifications, you might need to install a font, as those are sometimes not installed on the device by default. This process is identical to the firmware update process which is linked above. After extracting the APK, select the Mili_pro.ft.en file instead.

Some users reported that after initial adding to Gadgetbridge, using the "Disable Bluetooth Pairing" option was important to actually allow the connection to happen.

Mi Band 3

Mi Band 4

Not related with Mi Band 4C!

The Mi Band 4C is a completely different device, and is NOT supported by Gadgetbridge. See issue #2020 for details.

Mi Band 5

Essentially the same as Amazfit Band 5 but without the extra VO2 max sensor.

Mi Band 6

If you get a "Update the app to latest version" message on the band, make sure to check the "New Auth Protocol" in the device settings in Gadgetbridge.

If you are pairing the device for the first time, you can get to the Setting screen by long press on the device in the Discovery screen.

Mi Band 7

Also known as Xiaomi Smart Band 7.

Tested with firmware versions: 1.19.1.5, 1.20.3.1, 1.27.0.4, 2.0.0.2, and hardware versions: 0.91.177.3.

Zepp OS device

See the Zepp OS page for a list of features and issues common to Zepp OS gadgets.

Mi Band 7 Pro

Mostly supported
Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Also known as the Xiaomi Smart Band 7 Pro. Not related with the Mi Band 7, and in fact uses a completely different protocol.

Added based on feedback from issue #2781.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Mi Band 8

Also known as the Xiaomi Smart Band 8. Not related with the Mi Band 7, and in fact uses a completely different protocol.

Tested with firmware versions: 2.1.8, 2.2.12, and hardware versions: M2239B1.

Most of the Xiaomi protobuf implementation was created for the Mi Band 8, so it is highly supported.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Mi Band 8 Active

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Also known as the Xiaomi Smart Band 8 Active.

Added based on feedback from issue #3614.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Mi Band 8 Pro

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Also known as the Xiaomi Smart Band 8 Pro.

Untested, added based on feedback from issue #3471.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Mi Band 9

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Also known as the Xiaomi Smart Band 9.

Support added on pull request #4118, with limited access to the device. It should work, but was not tested extensively. If you confirm it works or face any issues, please open an issue or reach out on Matrix.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Mi Band 9 Pro

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Not yet released

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

Also known as the Xiaomi Smart Band 9 Pro.

Support added on pull request #4363, based on feedback from matrix.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Mi Watch Color Sport

Mostly supported
Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Mi Watch Lite

Mostly supported
Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Redmi Smart Band 2

Mostly supported
Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Added based on feedback from issue #3274.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Redmi Smart Band Pro

Mostly supported
Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Added based on feedback from issue #3069.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Redmi Watch 2

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Added based on feedback from issue #3543.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Redmi Watch 2 Lite

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Added based on feedback from issue #2637.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Redmi Watch 3

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Support added on pull request #3582.

Multiple connection types

This watch supports both Bluetooth LE and Classic, depending on the firmware version. If you face issues pairing or connecting to the device, see the Multiple connection types page.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Redmi Watch 3 Active

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Multiple connection types

This watch supports both Bluetooth LE and Classic, depending on the firmware version. If you face issues pairing or connecting to the device, see the Multiple connection types page.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Redmi Watch 5 Active

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Support added on pull request #4118, without access to the device. It should work, but was not tested at all. If you confirm it works or face any issues, please open an issue or reach out on Matrix.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Watch S1

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Multiple connection types

This watch supports both Bluetooth LE and Classic, depending on the firmware version. If you face issues pairing or connecting to the device, see the Multiple connection types page.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Watch S1 Active

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Multiple connection types

This watch supports both Bluetooth LE and Classic, depending on the firmware version. If you face issues pairing or connecting to the device, see the Multiple connection types page.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Watch S1 Pro

Mostly supported
Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Added based on feedback from issue #3450.

Known issues:

  • sleep stages are not working.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.

Watch S3

Unknown support
Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!
Requires Xiaomi token to pairYou need to pair with vendor (Xiaomi Wear, Mi Fit, Mi Fitness) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

Support fixed on pull request #4118, confirmed to be working on issue #3791.

Supported features are unknown.

Xiaomi protobuf device

See the Xiaomi protobuf for a list of features and issues common to Xiaomi protobuf watches.