MiBand Raspberry Pi Unofficial API

Library to work with Xiaomi MiBand (Tested on MiBand3, Might work on 2) Read the Article here

Contributors & Info Sources

1. Base lib provided by Leo Soares
2. Additional debug & fixes was made by Volodymyr Shymanskyy
3. Some info that really helped, found at Freeyourgadget team
4. I forked the repository from yogeshojha not sure if he edited the original code or it works for MiBand3 out of the box. the original code belongs to Andrey Nikishaev
5. Tested on Raspberry Pi 3B+ and Raspberry Pi Zero W with official Raspbian image.

System requirements

Install the following python and bluetooth related libs

$ sudo apt-get install python-pip python3-pip libglib2.0-dev python-dev python3-dev

Install dependencies

pip install -r requirements.txt from within the folder.

Make sure to Unpair you MiBand from current mobile apps and accounts you have.

Find out your MiBand MAC address using the following command

sudo hcitool lescan

set the MAC Address that you've found inside the main.py script.

If it's your first time running the code, set the INIT flag inside main.py as True, later change it to False Execute the script:

python main.py

If you having problems (BLE can glitch sometimes) sudo hciconfig hci0 reset

Donate

This library and code wouldn't be possible without Andrey Nikishaev If you like it and you find it useful, you can consider donating him pepsi-money by paypal: https://www.paypal.me/creotiv