https://github.com/korkuttum/tuya_body_fat_scale
Tuya Body Fat Scale Custom Integration for Home Assistant
https://github.com/korkuttum/tuya_body_fat_scale
home-assistant integrations tuya
Last synced: 6 months ago
JSON representation
Tuya Body Fat Scale Custom Integration for Home Assistant
- Host: GitHub
- URL: https://github.com/korkuttum/tuya_body_fat_scale
- Owner: Korkuttum
- License: mit
- Created: 2025-06-03T14:30:41.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-12-12T06:51:10.000Z (6 months ago)
- Last Synced: 2025-12-13T15:50:21.191Z (6 months ago)
- Topics: home-assistant, integrations, tuya
- Language: Python
- Homepage:
- Size: 158 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tuya Body Fat Scale Custom Integration for Home Assistant
This integration is designed to retrieve comprehensive body composition data from Tuya-based smart scales that support body fat and other advanced measurements. It provides detailed analytics beyond just weight, making it more advanced than the basic scale support in the official Tuya integration.
## Features
- Weight measurement (kg)
- Body Fat percentage
- Muscle Mass
- Bone Mass
- Body Water percentage
- Protein Rate
- BMI calculation
- Basal Metabolism
- Body Age
- Visceral Fat
- Multiple user support
- Real-time measurements
## Prerequisites
### Enable Tuya Cloud Service
Before using this integration, you must enable the Body Fat Scale API service in your Tuya IoT Platform account:
1. Log in to [Tuya IoT Platform](https://developer.tuya.com/)
2. Go to **Cloud** > **Project Management**
3. Click on **Open Project** (select your project)
4. Navigate to **Service API** tab
5. Click on **Go to Authorize** button on the right side
6. Find and select **Body Fat Scale Open Service**
7. Click **OK** to confirm and enable the service
⚠️ **Important**: The integration will not work without activating the Body Fat Scale service in your Tuya Cloud account, even if you have valid authentication credentials.
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=Korkuttum&repository=tuya_body_fat_scale&category=integration)
### Method 1: HACS Installation (Recommended)
1. Make sure you have [HACS](https://hacs.xyz/) installed in your Home Assistant instance.
2. Click on `HACS` in the sidebar.
3. Click on the three dots in the top right corner and select `Custom Repositories`.
4. Add this repository URL `https://github.com/Korkuttum/tuya_body_fat_scale` and select `Integration` as the category.
5. Click `ADD`.
6. Find and click on "Tuya Body Fat Scale" in the integrations list.
7. Click `Download` and install it.
8. Restart Home Assistant.
### Method 2: Manual Installation
To install manually, upload all the files into the custom_components/tuya_body_fat_scale folder inside your Home Assistant configuration directory.
## Configuration
Once installed (either through HACS or manually), you must restart Home Assistant before proceeding. After the restart:
1. Go to Settings > Devices & Services
2. Click "Add Integration"
3. Search for "Tuya Body Fat Scale"
4. Enter your Tuya IoT Platform credentials:
- Access ID
- Access Secret
- Device ID
5. Add user information:
- User id
- Name
- Birth Date (DD.MM.YYYY)
- Gender
---
## File Structure
Make sure your folder structure looks like this (if installing manually):
```
custom_components/
└── tuya_body_fat_scale/
├── __init__.py
├── api.py
├── config_flow.py
├── const.py
├── coordinator.py
├── manifest.json
├── sensor.py
├── strings.json
├── translations/
├── en.json
└── tr.json
└── README.md
```
---
## Support My Work
If you find this integration helpful, consider supporting the development:
[](https://www.patreon.com/korkuttum)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Disclaimer
This integration is an independent project and is not affiliated with, endorsed by, or connected to Tuya Inc. in any way. This is a community project provided "as is" without warranty of any kind. Use at your own risk.