KristianP26/ble-scale-sync

📱 Công cụ đồng bộ cân BLE thông minh không cần điện thoại

Đọc dữ liệu cân và thành phần cơ thể từ 25+ thương hiệu cân BLE, tự động đồng bộ sang Garmin Connect, Strava, MQTT và nhiều nền tảp khác — chỉ cần bước lên cân, dữ liệu xuất hiện ngay.

BLE Scale Sync là một công cụ CLI độc lập chạy trên Raspberry Pi, Linux, macOS và Windows. Nó kết nối trực tiếp với các cân thông minh hỗ trợ BLE (như Renpho, Xiaomi, Eufy, Yunmai...) thông qua adapter Bluetooth và thu thập dữ liệu cân nặng cùng các chỉ số thành phần cơ thể (body composition) dựa trên BIA (bioelectrical impedance analysis). Không cần ứng dụng điện thoại, không cần nhập tay — mọi thứ được tự động hóa.

✨ Điểm nổi bật

• Hỗ trợ 25+ thương hiệu cân BLE: Xiaomi (Mi Scale 2 phát sóng thụ động), Renpho, Eufy, Yunmai, Beurer, Sanitas, Medisana và nhiều thương hiệu khác.
• Đồng bộ 11 nền tảng: Garmin Connect, Strava, Intervals.icu, Runalyze, Wger, MQTT (Home Assistant), InfluxDB, Webhook, Ntfy, Telegram, File (CSV/JSONL).
• 10 chỉ số cơ thể: Cân nặng + trở kháng điện sinh học để tính phần trăm mỡ, cơ, nước, xương...
• Đa người dùng tự động: Nhận diện qua trọng lượng, mỗi người có exporter riêng.
• Đồng bộ lịch sử: Phát lại bộ nhớ cache ngoại tuyến của cân với timestamp gốc.
• Hỗ trợ ESP32 proxy: Relay dữ liệu BLE qua WiFi nếu không có Pi gần cân.
• Cài đặt qua Docker, Home Assistant Add-on hoặc Node.js trực tiếp.
• Công cụ chuẩn đoán BLE: npm run diagnose để khắch hằng Bluetooth.

💡 Vì sao đáng chú ý

BLE Scale Sync giải quyết bài toán lớn: hầu hết các cân BLE đều không thể đồng bộ trực tiếp với Garmin Connect. Trước đây, người dùng phải mở app trên điện thoại, chờ đồng bộ, rồi gõ tay từng con số — mỗi lần một lần. Với công cụ này, một Raspberry Pi Zero 2W đặt cạnh cân sẽ tự động lắng nghe và gửi dữ liệu ngay khi bạn bước lên. Hoặc nếu không có Pi, một ESP32 rẻ tiền poxy BLE qua WiFi. Phù hợp cho người dùng Home Assistant, yêu thích sức khỏe cá nhân hóa (quantified-self), hoặc muốn giữ dữ liệu trên thiết bị của mình.

#BLE #SmartScale #GarminConnect #HomeAssistant #MQTT #InfluxDB #RaspberryPi #BodyComposition #OpenSource #TiniX