MIBAND 4 - Python Slide Control

Library to control Slides with Xiaomi MiBand4. Only works on linux.

Updates(3/15/2021)

• smaller version of master which allows you to get commands to your linux machine with miband4

Contributors

MiBand 4 provides superset of services provided by MiBand 2/3. For the services that were similar for both devices, the bluetooth characteristics, UUIDs and request/response byte sequence were the same. Therefore, I utilized some of the informations already uncovered by Freeyourgadget team and made use of the code by Andrey Nikishaev for MiBand2. I reverse engineered snooped ACL packets to fill in the pieces of the puzzle.

AuthKey

MiBand 4 with updated firmware requires server based pairing. This means, that you absolutely must use MiFit app to make the initial pairing, retrieve the pairing key and then use this key to pair with this library. Only some of the features of this library work without AuthKey of the band. Read Server based pairing for further details.

There are several ways to obtain the key.

Obtaining unique Authkey

On rooted phone you may grab the key from MiFit database which means that you must:

• install MiFit
• create an account
• pair the band/watch
• Then, execute the following command in a root shell terminal:

sqlite3 /data/data/com.xiaomi.hm.health/databases/origin_db_[YOURDBNAMEHERE] "select AUTHKEY from DEVICE"

On a non rooted phone you may consider using https://www.freemyband.com/

NOTICE: Every time you hard reset the band/watch, the Bluetooth MAC Address will be changed and you must grab a new key! Also, anytime you unpair your band/watch from MiFit, the pairing key will be invalidated and you must make new pairing in MiFit app.

Setup and demo

• Clone this repo to your local machine using https://github.com/satcar77/miband4.git

1. Install the dependencies. Libglib2 is required for bluepy.

   sudo apt-get install libglib2.0-dev
   pip3 install -r requirements.txt
   

2. (Optional) Find AuthKey for your device and put it to auth_key.txt file in the current directory with the script.

3. Turn off your Bluetooth on your mobile device paired with MIBand 4

4. Find out your MiBand4 MAC address using hcitool

   sudo hcitool lescan
   // if you are having trouble
   sudo hciconfig hci0 reset 
   

5. Run the miband4_console

   python3 miband4_console.py -m MAC_ADDRESS 
   

Contributing

Step 1

• Option 1

  • 🍴 Fork this repo!

• Option 2

  • 👯 Clone this repo to your local machine

Step 2

• HACK AWAY! 🔨🔨🔨

Step 3

• 🔃 Create a new pull request