Fitness Machine Service
dudanov/hassio-ftms · vv0.24.6
Home Assistant custom component for Bluetooth Fitness Equipment (FTMS).
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) |
What people report
Bluetooth FTMS fitness machines are supported in principle, but several treadmills and trainers fail to be discovered or have invalid values.
- Partly works1
- Requested2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Wahoo Kickr Core v2 trainer | Partly works Local | Invalid values break setup; a workaround from issue 31 confirmed workingSaved copySee #31 for a potential solution, confirmed working for a Kickr Core v2, which has similar invalid values. Who is the vendor of your bike trainer? Excerpt saved from GitHub on 2026-10-23. | Issue #22 · 2025-02 | |
| FitHome DJ-6058 cross trainer | Requested Local | Needs connection and subscription to Cross Trainer or Indoor Bike DataSaved copyHi @dudanov, Could you add support for the FitHome DJ-6058? It advertises itself through BLE and subsequently requires an active connection and subscription to the characteristic "Cross Trainer Data" or "Indoor Bike Data" to retrieve the training values. Here's the data I collected from the LightBlue app. ``` Generic Acces Device name Service UUID 00001800-0000-1000-8000-00805f9b34fb Value 0x464D537465707065722D45423134 Generic Attribute Service changed Service UUID 00001801-0000-1000-8000-00805f9b34fb Client Characteristic Configuration 00002902-0000-1000-8000-00805f9b34fb Device Information … Excerpt saved from GitHub on 2026-10-23. | Issue #34 · 2025-07 | |
| Toputure H40F treadmill | Requested Local | FitShow controller advertises FTMS but integration found no compatible deviceSaved copyHi there, thanks for this project! I'm hoping to get help adding support for a certain model of treadmill - one which appears to support FTMS protocol, as tested using nRF Connect per this article. Here is an Amazon link to the product. And here is a manual for one of the same/similar controller model. I would love to help however I can. Thank you. Excerpt saved from GitHub on 2026-10-23. | Issue #13 · 2024-10 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local push
Talks to the device on your network, and the device tells Home Assistant the moment something changes.
Found automatically over
- Bluetooth
Details
| Installs (analytics) | 170 (0.02%) |
|---|---|
| GitHub stars | 74 |
| Latest version | v0.24.6 (2025-03-01) |
| Set up in the UI | Yes |
| Maintainers | @dudanov |
| License | Apache-2.0 |
Notable forks
Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| chkuendig/hassio-ftms Newer code | ★ 5 | 2026-01-29 | Home Assistant custom component for Bluetooth Fitness Equipment (FTMS). |
| michaelw/hassio-ftms Newer code | ★ 1 | 2026-06-19 | Home Assistant custom component for Bluetooth Fitness Equipment (FTMS). |
| thejosejorge/hassio-ftms-eb900b Newer code | ★ 0 | 2026-08-31 | Home Assistant FTMS custom component adapted for the self-powered Domyos/Decathlon EB900 B bike. |
| marsimiklos/hassio-ftms Newer code | ★ 0 | 2026-06-06 | Home Assistant custom component for Bluetooth Fitness Equipment (FTMS). |
| krzmaz/hassio-ftms Newer code | ★ 0 | 2026-07-14 | Home Assistant custom component for Bluetooth Fitness Equipment (FTMS). |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/dudanov/hassio-ftms/blob/master/README.md
- Source code: https://github.com/dudanov/hassio-ftms
- Issues: https://github.com/dudanov/hassio-ftms/issues
- HACS: https://hacs.xyz
