encodedLife / hassio_garmin_scale_sync

Garmin Scale Sync integration allows Home Assistant to interact with your Garmin account

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Validate with hassfest Validate with Hacs

Garmin Scale Sync Integration for Home Assistant

Known Issues

Currently, the Garmin Connect integration is a work in progress and is classified as "In Development." Please be aware that, given its early stage, the integration might contain some bugs that have not yet been identified. I have not conducted extensive user testing, but I'm actively working on detecting and fixing any issues within the codebase.

I am dedicated to enhancing this integration and will roll out updates as fixes and improvements are implemented. Should you encounter any problems, I encourage you to report them. Your feedback is crucial for identifying and addressing issues promptly and will be incredibly helpful in prioritizing fixes in the development queue.

I appreciate your patience and any contributions you might make during this developmental phase. Detailed reports on any known issues that persist after initial testing will be provided, along with their current status and the approach being taken to resolve them.

Thank you for your support and stay tuned for continuous improvements.

Overview

The Garmin Scale Sync integration allows Home Assistant to interact with your Garmin account, enabling the synchronization of various health metrics such as body weight, body fat percentage, muscle mass, and visceral fat. This integration aims to bridge your health data from your home environment into the Garmin ecosystem for a comprehensive health and activity tracking.

Features

  • Data Sync: sends scale measurements from Home Assistant to Garmin Connect.
  • Health Metrics: Supports syncing multiple health metrics, including body weight, body fat percentage, muscle mass, and visceral fat rating.
  • Timestamp Synchronization: Ensures that the time of the measurement is accurately reflected in the Garmin Connect data.

Installation

Configuration

Configuration is performed through the Home Assistant UI. Once authenticated, you can select which metrics to sync and configure the frequency of synchronization.

Usage

Once configured, the Garmin Connect integration makes several entities available in Home Assistant representing various health metrics. These entities are meant to be populated with data by the user.

When you're ready to send the updated information to Garmin Connect, simply press the "Send" button provided by the integration. This action triggers the integration to read the current states of the entities, compile the data, and transmit it directly to Garmin Connect.

Please ensure that you've entered the latest data into the respective entities before initiating the send operation for accurate syncing with your Garmin Connect account.

Dependencies

  • garth: An amazing Python library to interface with Garmin Connect API and MFA. Developed by matin
  • fit_tool: A very useful utility library for creating FIT files compatible with Garmin's requirements. Developed by mtucker

Contributing

Contributions to the Garmin Scale Sync integration are welcome! Please submit pull requests with any enhancements, bug fixes, or improvements you wish to share.

Support

For support and discussions, please open an issue on the GitHub repository.

About

Garmin Scale Sync integration allows Home Assistant to interact with your Garmin account

License:Apache License 2.0


Languages

Language:Python 100.0%