---
title: "Etekcity Fitness Scale BLE"
description: "Etekcity Fitness Scale BLE is a Marketplace integration for Home Assistant. It has 160 installs sharing analytics, works locally and was last updated October 13, 2026."
canonical: "https://vulpo.app/integrations/marketplace/ronnnnnnnnnnnnn-etekcity-fitness-scale-ble"
url: "https://vulpo.app/integrations/marketplace/ronnnnnnnnnnnnn-etekcity-fitness-scale-ble.md"
last-updated: "2026-10-22"
version: "1.4"
---

# Etekcity Fitness Scale BLE

> Etekcity Fitness Scale BLE is a Marketplace integration for Home Assistant. It has 160 installs sharing analytics, works locally and was last updated October 13, 2026.

Etekcity Fitness Scale BLE connects Etekcity Bluetooth fitness scales to Home Assistant for local weight readings. It talks to the scale directly over Bluetooth, so neither an internet connection nor the VeSync app is needed. Sensors report weight and impedance, and supported models can add body composition values such as body fat, muscle mass and metabolic age, with an optional athlete mode and an alternative calculation per user. Several people can share one scale: the integration matches a reading to a user by weight history, can skip users whose linked person entity is away, and sends actionable notifications when a reading is ambiguous. Actions let a pending measurement be assigned, reassigned or removed, and history retention can be limited by days or by count. The scale is found automatically and added through the UI, with a choice of kg or lb display.

Automatic summary of the README and code of ronnnnnnnnnnnnn/etekcity\_fitness\_scale\_ble. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=ronnnnnnnnnnnnn&repository=etekcity_fitness_scale_ble&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=ronnnnnnnnnnnnn&repository=etekcity_fitness_scale_ble&category=integration)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **Found by itself**: Home Assistant spots it on the network and offers to add it.
- **From the Marketplace**: Installed through the Marketplace, formerly HACS.
- **Actively maintained**: Its author released or pushed a change in the last six months.

## Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

### Connect

- **Device**
- **Scale display unit**

### Configure scale

- **Scale display unit**

### Choose scale model

- **Scale model**

### Add User Profile

- **User name**
- **Person entity (optional)**: Only used when this scale has multiple users, to skip this user when their linked person is away from home at weigh-in time. Requires the person to have a working device tracker (e.g. their phone via the Home Assistant companion app). Leave blank to match by weight only.
- **Mobile devices for actionable notifications (optional)**: Select mobile devices to receive actionable notifications for ambiguous measurements. If not configured, you'll still receive the Home Assistant persistent notification.
- **Enable body composition metrics**

### Body Composition Settings

- **Sex**
- **Height**
- **Date of birth**
- **feet**
- **inches**
- **Athlete mode**: Applies the athlete-tuned body fat calculation, matching the VeSync app's Athlete Mode. Recommended for users who train regularly and have above-average muscle mass.
- **Use alternative body composition algorithm**: By default the values match the VeSync app for this scale model. Try this if they don't match what you expect. Changing it causes a one-time jump in this user's body composition history.

### Body metrics

- **Sex**
- **Height**
- **Date of birth**

### After setup

- **User name**
- **Person entity (optional)**: Only used when this scale has multiple users, to skip this user when their linked person is away from home at weigh-in time. Requires the person to have a working device tracker (e.g. their phone via the Home Assistant companion app). Leave blank to match by weight only.
- **Mobile devices for actionable notifications (optional)**: Select mobile devices to receive actionable notifications for ambiguous measurements. If not configured, you'll still receive the Home Assistant persistent notification.
- **Enable body composition metrics**
- **Sex**
- **Height**
- **Date of birth**
- **feet**
- **inches**
- **Athlete mode**: Applies the athlete-tuned body fat calculation, matching the VeSync app's Athlete Mode. Recommended for users who train regularly and have above-average muscle mass.
- **Use alternative body composition algorithm**: By default the values match the VeSync app for this scale model. Try this if they don't match what you expect. Changing it causes a one-time jump in this user's body composition history.
- **User to edit**
- **User name**
- **Person entity (optional)**: Only used when this scale has multiple users, to skip this user when their linked person is away from home at weigh-in time. Requires the person to have a working device tracker (e.g. their phone via the Home Assistant companion app). Leave blank to match by weight only.
- **Mobile devices for actionable notifications (optional)**: Select mobile devices to receive actionable notifications for ambiguous measurements. If not configured, you'll still receive the Home Assistant persistent notification.
- **Enable body composition metrics**
- **Sex**
- **Height**
- **Date of birth**
- **feet**
- **inches**
- **Athlete mode**: Applies the athlete-tuned body fat calculation, matching the VeSync app's Athlete Mode. Recommended for users who train regularly and have above-average muscle mass.
- **Use alternative body composition algorithm**: By default the values match the VeSync app for this scale model. Try this if they don't match what you expect. Changing it causes a one-time jump in this user's body composition history.
- **User to remove**
- **Scale display unit**
- **Keep history forever**: Never delete weight measurements automatically. While enabled, the automatic cleanup limits below are ignored.
- **Enable library logging**: When enabled, logs from the underlying etekcity\_esf551\_ble library will be included in the integration's logs. Useful for troubleshooting BLE communication issues.
- **History retention (days)**: How many days to keep weight measurements. Older measurements will be automatically removed. Range: 1-365 days.
- **Max history size (measurements)**: Maximum number of measurements to store per user. When exceeded, oldest measurements are removed. Range: 10-1000 measurements.

Texts from the code of [ronnnnnnnnnnnnn/etekcity\_fitness\_scale\_ble](https://github.com/ronnnnnnnnnnnnn/etekcity_fitness_scale_ble).

## Actions

- **Assign measurement**: Manually assign a pending weight measurement to a specific user when automatic detection is ambiguous.
  Fields: Timestamp, User ID
- **Reassign measurement**: Reassign a user's last measurement to a different user.
  Fields: From User ID, To User ID
- **Remove measurement**: Remove a user's last measurement (revert to previous or mark unavailable).
  Fields: User ID

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.
- **Repair notices**: Notices it can show in Settings, Repairs:
  Passive Bluetooth scanning is not available

## From the README

> This custom integration allows you to connect your Etekcity Bluetooth Low Energy (BLE) fitness scale to Home Assistant. It provides real-time weight measurements and, for supported models, body composition metrics directly in your Home Assistant instance, without requiring an internet connection or the VeSync app.
>
> Health & safety note: Body-composition scales measure by passing a low electrical current through the body. This project does not support the manufacturers' zero-current, pregnancy or baby modes, and a mode enabled in the manufacturer's app is not guaranteed to be in effect while the scale is used through this integration.
>
> - Supported models: ESF-551 (full features: weight, impedance, body composition), FIT-8S (weight, impedance, body composition; experimental), ESF-24 (weight, impedance, body composition;…
> - Automatic discovery of Etekcity BLE fitness scales
> - Intelligent multi-user support:
> - Automatically detects which person is using the scale based on their weight history.
> - Uses an adaptive tolerance system that adjusts to each user's weight fluctuations over time.
> - Supports linking users to Home Assistant Person entities to exclude users who are not\_home.
> - Real-time weight and impedance measurements
> - Optional body composition metrics (all supported models), with optional per-user Athlete Mode and a per-user alternative-algorithm option, including:
> - Body Mass Index (BMI)
> - Body Fat Percentage
> - Fat Free Weight
> - Subcutaneous Fat Percentage

From the README of [ronnnnnnnnnnnnn/etekcity\_fitness\_scale\_ble](https://github.com/ronnnnnnnnnnnnn/etekcity_fitness_scale_ble#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [Health and wellbeing](https://vulpo.app/integrations/category/health-and-wellbeing.md)
- Number: 160 installs sharing analytics; 57 GitHub stars
- Connection: Works locally
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v0.8.5, last updated October 13, 2026
- Domain: `etekcity_fitness_scale_ble`
- Source: <https://github.com/ronnnnnnnnnnnnn/etekcity_fitness_scale_ble>
- Issues: <https://github.com/ronnnnnnnnnnnnn/etekcity_fitness_scale_ble/issues>

In Vulpo: Chart card, Apple Watch

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/ronnnnnnnnnnnnn-etekcity-fitness-scale-ble

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/ronnnnnnnnnnnnn-etekcity-fitness-scale-ble
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml
