https://github.com/huyuwei1996/integration_yunmai_scale
custom components for Yunmai body scales
https://github.com/huyuwei1996/integration_yunmai_scale
customcomponents home-assistant home-assistant-integration
Last synced: 13 days ago
JSON representation
custom components for Yunmai body scales
- Host: GitHub
- URL: https://github.com/huyuwei1996/integration_yunmai_scale
- Owner: huyuwei1996
- License: gpl-3.0
- Created: 2025-03-12T20:47:42.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-15T06:52:16.000Z (about 1 year ago)
- Last Synced: 2025-03-15T07:26:52.516Z (about 1 year ago)
- Topics: customcomponents, home-assistant, home-assistant-integration
- Language: Python
- Homepage:
- Size: 27.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Yunmai Scale Integration for Home Assistant
A custom component for Home Assistant that integrates Yunmai body scales using Bluetooth Low Energy (BLE).
## Features
- Automatically discovers Yunmai scales in BLE range
- Displays weight and body composition metrics
- Supports user-specific configuration (gender, height, age)
- Customizable scan interval
## Tested Models
- Yunmai SE 3S (YMBS-M267)
## Supported Models
- Yunmai SE 3S
- Yunmai Mini 2S
## Installation
1. Copy the `custom_components/yunmai_scale` folder to your Home Assistant's `custom_components` directory.
2. Restart Home Assistant.
3. Go to Configuration -> Integrations -> Add Integration and search for "Yunmai Scale".
4. Follow the setup wizard to configure your scale.
## Available Sensors
- **Weight**: Current weight in kg
- **BMI**: Body Mass Index
- **Body Fat**: Body fat percentage
- **Muscle Mass**: Muscle mass percentage
- **Water Percentage**: Body water percentage
- **Bone Mass**: Bone mass in kg
- **Skeletal Muscle**: Skeletal muscle percentage
- **Lean Body Mass**: Lean body mass in kg
- **Visceral Fat**: Visceral fat level
- **Scale Status**: Current status of the scale (measuring, stable, idle)
## Requirements
- Home Assistant 2024.12.5 or newer
- A compatible Yunmai scale
- Bluetooth adapter that supports BLE
## Development Setup
### Install Development Dependencies
```bash
pip install -r requirements-dev.txt
```
### Setup Pre-commit Hooks
```bash
pre-commit install
```
This will automatically run ruff and lint checks on your code before each commit.
## Thanks
Thanks to the following open source projects and resources:
- [yunmai-mqtt](https://github.com/Paxy/yunmai-mqtt) - For providing integration between Yunmai scales and MQTT systems
- [openScale](https://github.com/oliexdev/openScale) - Open source weight and body metrics tracking application
- [https://bbs.hassbian.com/thread-14002-1-1.html](https://bbs.hassbian.com/thread-14002-1-1.html) - `Yunmai` scale ble advertisement data parse