BrOrlandi/miscale-dashboard

选用指南

AI 根据 README 整理 · 2026/10/14 19:46:05

适用场景

适用于拥有小米体脂秤2的用户，在家庭或办公室等蓝牙范围内自托管体重与身体成分数据仪表盘。

查看 README 依据

# Mi Scale Dashboard A self-hosted, local-first dashboard for the **Xiaomi Mi Body Composition Scale 2**. A small server near the scale listens for its Bluetooth Low Energy broadcasts. Each weigh-in shows up live in your browser, gets matched to the right person, and is saved with its body composition. No Xiaomi account, no Zepp Life app, no cloud. [Português (Brasil)](README.pt-BR.md)  | Dashboard (light) | Dashboard (dark) | | --- | --- |

[Mercado Livre](https://meli.la/2XoPtSb). These are affiliate links: as an Amazon Associate and a Mercado Livre affiliate, I earn from qualifying purchases, at no extra cost to you. The older **Mi Smart Scale 2 (XMTZC04HM)** and other models use a different packet format and aren't supported yet. If you have one, a pull request is welcome; see [Contributing](#contributing). ### 2. A computer with Bluetooth Low Energy, near the scale This is a hard requirement. The server **must have a BLE-capable Bluetooth adapter** and be

目标用户

面向希望本地记录体重和身体成分、避免使用云服务的个人用户。

查看 README 依据

# Mi Scale Dashboard A self-hosted, local-first dashboard for the **Xiaomi Mi Body Composition Scale 2**. A small server near the scale listens for its Bluetooth Low Energy broadcasts. Each weigh-in shows up live in your browser, gets matched to the right person, and is saved with its body composition. No Xiaomi account, no Zepp Life app, no cloud. [Português (Brasil)](README.pt-BR.md)  | Dashboard (light) | Dashboard (dark) | | --- | --- |

使用方式

通过Docker或Python 3.11+在Linux主机上运行，浏览器访问仪表盘，支持PWA安装到手机。

查看 README 依据

The supported setup is **Linux with BlueZ** (the standard Bluetooth stack on Ubuntu, Debian and Raspberry Pi OS). The Docker container talks to the host's BlueZ over D-Bus. The scanner is built on [bleak](https://github.com/hbldh/bleak), so macOS and Windows may work when you run it without Docker, but they aren't tested. Check that the host can see Bluetooth LE devices: ```bash bluetoothctl show # should list a controller with "Powered: yes" sudo bluetoothctl scan le # step on the scale: a device named MIBFS should appear ``` ## Install with Docker (recommended) ```bash

- apparmor=unconfined # Docker's AppArmor profile blocks D-Bus ``` It doesn't need `privileged` or `network_mode: host`. On hosts without AppArmor (most Raspberry Pi OS installs), the `security_opt` line is harmless. ## Install without Docker Python 3.11+ on a Linux host with BlueZ: ```bash git clone https://github.com/BrOrlandi/miscale-dashboard.git cd miscale-dashboard python3 -m venv .venv && . .venv/bin/activate pip install -r requirements.txt MISCALE_DB=./data/miscale.db uvicorn app.main:app --host 0.0.0.0 --port 8800 ```

To run it as a service, use a systemd unit like this one: ```ini # /etc/systemd/system/miscale-dashboard.service [Unit] Description=Mi Scale Dashboard After=bluetooth.target network-online.target [Service] WorkingDirectory=/opt/miscale-dashboard Environment=MISCALE_DB=/opt/miscale-dashboard/data/miscale.db ExecStart=/opt/miscale-dashboard/.venv/bin/uvicorn app.main:app --host 0.0.0.0 --port 8800 Restart=always [Install] WantedBy=multi-user.target ``` ## Install it on your phone The dashboard is a Progressive Web App: it installs like an app, opens full screen with its

部署要求

需要小米体脂秤2（型号XMTZC05HM），以及一台带蓝牙低功耗适配器且在秤的蓝牙范围内的Linux主机（支持BlueZ）。

查看 README 依据

improved, what needs attention, and what to try next week. It is typed into the dashboard live as the model writes it, and goes out with the notifications. - English and Portuguese (Brazil); kg or lb; light, dark or automatic theme. - **Installable on your phone** as an app (PWA), with offline shell. - One container, SQLite, no external services. Chart.js is bundled, so it works offline. ## What you need ### 1. The scale **Xiaomi Mi Body Composition Scale 2**, model **XMTZC05HM**. It advertises as `MIBFS`. Where to buy it in Brazil: [Amazon](https://amzn.to/3TPrsph) or

[Mercado Livre](https://meli.la/2XoPtSb). These are affiliate links: as an Amazon Associate and a Mercado Livre affiliate, I earn from qualifying purchases, at no extra cost to you. The older **Mi Smart Scale 2 (XMTZC04HM)** and other models use a different packet format and aren't supported yet. If you have one, a pull request is welcome; see [Contributing](#contributing). ### 2. A computer with Bluetooth Low Energy, near the scale This is a hard requirement. The server **must have a BLE-capable Bluetooth adapter** and be

The supported setup is **Linux with BlueZ** (the standard Bluetooth stack on Ubuntu, Debian and Raspberry Pi OS). The Docker container talks to the host's BlueZ over D-Bus. The scanner is built on [bleak](https://github.com/hbldh/bleak), so macOS and Windows may work when you run it without Docker, but they aren't tested. Check that the host can see Bluetooth LE devices: ```bash bluetoothctl show # should list a controller with "Powered: yes" sudo bluetoothctl scan le # step on the scale: a device named MIBFS should appear ``` ## Install with Docker (recommended) ```bash

已知限制

仅支持小米体脂秤2，其他型号（如Mi Smart Scale 2）暂不支持；仪表盘无登录功能，仅建议在家庭网络或反向代理后使用。

查看 README 依据

[Mercado Livre](https://meli.la/2XoPtSb). These are affiliate links: as an Amazon Associate and a Mercado Livre affiliate, I earn from qualifying purchases, at no extra cost to you. The older **Mi Smart Scale 2 (XMTZC04HM)** and other models use a different packet format and aren't supported yet. If you have one, a pull request is welcome; see [Contributing](#contributing). ### 2. A computer with Bluetooth Low Energy, near the scale This is a hard requirement. The server **must have a BLE-capable Bluetooth adapter** and be

- **Wrong person?** Change it in the history; the body composition is recalculated for the new profile. Editing a profile's height or birth date recalculates their whole history. - **Accuracy:** bioimpedance is an estimate that shifts with hydration, meals and time of day. Weigh yourself at the same time every day and watch the trend, not single readings. This is not a medical device. ## Security The dashboard has **no login**. Run it on your home network only, or put it behind a reverse proxy with authentication (Traefik, Caddy or nginx with basic auth, Authelia, Tailscale...)