niaproxy / mi-action

:computer: :watch: Access Xiaomi Miband from Linux using Bluetooth LE and activate actions with it in an easy and intuitive way

Installation

Clone the repository and enter the directory using cd

git clone https://github.com/arielroque/Mi-action.git
cd Mi-action

Use venv to avoid dependecies erros, but you may opt not to use it

virtualenv -p python3.6 venvmiaction

Source the venv to activate it.

source venvmiaction/bin/activate

Use pip to install the requirements from backend

pip3 install -r requirements.txt

Install node dependencies from frontend

cd frontend
npm install

Usage

From the root directory, allow the initializer script to run on virtualenv

chmod 777 ./start.sh

To start Mi Action application, run the following script:

sudo ./start.sh

Notice: We need a sudo request to allow use Bluetooth Features

Device compatibility

This application was tested with success in Miband 3 and probably works so with Miband 2. Needs to check yet the compatibility with Miband 4.

Screenshots

Contributing

Pull request are also welcome , please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

• Check issue templates for the suggested issue formats

Acknowledgments

This application was built based on the work of

• yogeshojha - MiBand3

• Creotiv - MiBand2