https://github.com/dudanov/hassio-ftms
Home Assistant custom component for Bluetooth Fitness Equipment (FTMS).
https://github.com/dudanov/hassio-ftms
bluetooth custom-component fitness ftms home-assistant homeassistant homeassistant-custom-component python
Last synced: 11 months ago
JSON representation
Home Assistant custom component for Bluetooth Fitness Equipment (FTMS).
- Host: GitHub
- URL: https://github.com/dudanov/hassio-ftms
- Owner: dudanov
- License: apache-2.0
- Created: 2024-05-29T19:43:54.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-24T14:50:28.000Z (over 1 year ago)
- Last Synced: 2024-10-25T08:19:31.169Z (over 1 year ago)
- Topics: bluetooth, custom-component, fitness, ftms, home-assistant, homeassistant, homeassistant-custom-component, python
- Language: Python
- Homepage:
- Size: 94.7 KB
- Stars: 7
- Watchers: 3
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Fitness Machine Service
[Home Assistant](https://www.home-assistant.io/) [HACS](https://hacs.xyz/) custom component for working with fitness equipment with a Bluetooth interface.
The component is based on the [pyftms](https://github.com/dudanov/pyftms) library, which complies with the [Bluetooth Fitness Machine Service v1.0 standard](https://www.bluetooth.com/specifications/specs/fitness-machine-service-1-0/).
Component capabilities:
1. Automatically detect Bluetooth fitness devices nearby, notifying the user about it;
2. Setup Wizard, which allows you to easily configure the device by determining its type and set of sensors in automatic or manual modes. The set of sensors can be changed.
3. Collects training data from fitness equipment and allows you to set training parameters specific to the type of equipment.
Supported fitness machines:
1. **Treadmill**
2. **Cross Trainer** (Elliptical Trainer)
3. **Rower** (Rowing Machine)
4. **Indoor Bike** (Spin Bike)
Device view example for `FitShow FS-BT-D2 Indoor bike` fitness machine:
## Installation
### HACS
Follow [this guide](https://hacs.xyz/docs/faq/custom_repositories/) to add this git repository as a custom HACS repository. Then install from HACS as normal.
### Manual Installation
Copy `custom_components/ftms` into your Home Assistant `$HA_HOME/config` directory, then restart Home Assistant.
## Disclaimer
Since there is a lot of different equipment that I do not own, and given the fact that not all manufacturers follow the FTMS standard strictly, some functions may not work correctly or not work at all.
Please create an [issue](https://github.com/dudanov/hassio-ftms/issues), and I will try to help solve the problem.
## Support
If you find the component useful and want to support me and my work, you can do this by sending me a donation in [TONs](https://ton.org/): `UQCji6LsYAYrJP-Rij7SPjJcL0wkblVDmIkoWVpvP2YydnlA`.