Xiaomi &para;

No-vendor pairInitial pair can be done in Gadgetbridge without needing the proprietary vendor app.

Highly supportedAll features or at least all major features are supported, which is enough to cover almost all cases.

Extras

Known firmware versionsClick to see list of known firmware versions for this gadget.

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¶

No-vendor pairInitial pair can be done in Gadgetbridge without needing the proprietary vendor app.

Highly supportedAll features or at least all major features are supported, which is enough to cover almost all cases.

Extras

Known firmware versionsClick to see list of known firmware versions for this gadget.

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

Mi Band 1S¶

No-vendor pairInitial pair can be done in Gadgetbridge without needing the proprietary vendor app.

Highly supportedAll features or at least all major features are supported, which is enough to cover almost all cases.

Extras

Known firmware versionsClick to see list of known firmware versions for this gadget.

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

Mi Band 2¶

No-vendor pairInitial pair can be done in Gadgetbridge without needing the proprietary vendor app.

Highly supportedAll features or at least all major features are supported, which is enough to cover almost all cases.

Extras

Known firmware versionsClick to see list of known firmware versions for this gadget.

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¶

No-vendor pairInitial pair can be done in Gadgetbridge without needing the proprietary vendor app.

Highly supportedAll features or at least all major features are supported, which is enough to cover almost all cases.

Extras

Known firmware versionsClick to see list of known firmware versions for this gadget.

Mi Band 4¶

Requires Huami token to pairYou need to pair with vendor (Mi Fit, Zepp or Zepp Life) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.

Highly supportedAll features or at least all major features are supported, which is enough to cover almost all cases.

Extras

Known firmware versionsClick to see list of known firmware versions for this gadget.

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¶

Requires Huami token to pairYou need to pair with vendor (Mi Fit, Zepp or Zepp Life) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.

Highly supportedAll features or at least all major features are supported, which is enough to cover almost all cases.

Extras

Known firmware versionsClick to see list of known firmware versions for this gadget.

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

Mi Band 6¶

Requires Huami token to pairYou need to pair with vendor (Mi Fit, Zepp or Zepp Life) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.

Highly supportedAll features or at least all major features are supported, which is enough to cover almost all cases.

Extras

Known firmware versionsClick to see list of known firmware versions for this gadget.

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¶

Requires Huami token to pairYou need to pair with vendor (Mi Fit, Zepp or Zepp Life) app first, then obtain the authentication key and put into Gadgetbridge. Click to learn more.

Highly supportedAll features or at least all major features are supported, which is enough to cover almost all cases.

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¶

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.

Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.

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¶

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.

Highly supportedAll features or at least all major features are supported, which is enough to cover almost all cases.

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¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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¶

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.

Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.

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¶

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.

Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.

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¶

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.

Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.

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¶

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.

Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.

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¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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.

Redmi Watch 5 Lite¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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.

Support added based on feedback from matrix.

Xiaomi protobuf device

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

Watch S1¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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¶

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.

Unknown supportIt is supported by Gadgetbridge, but we don't have information about its working/missing features. You can help us by testing yourself!

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¶

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.

Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.

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¶