eufy-sync 1.5.0__tar.gz

eufy_sync-1.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elias Sturim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eufy_sync-1.5.0/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: eufy-sync
+Version: 1.5.0
+Summary: Sync Eufy smart scale body composition data to Garmin Connect and Strava
+License-Expression: MIT
+Project-URL: Repository, https://github.com/sturimcode/eufy-sync
+Project-URL: Issues, https://github.com/sturimcode/eufy-sync/issues
+Keywords: garmin,garmin connect,strava,eufy,eufylife,smart scale,body composition,fit file,weight sync
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: keyring>=25.0.0
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: setuptools>=68.0
+Dynamic: license-file
+
+# eufy-sync
+
+[![PyPI](https://img.shields.io/pypi/v/eufy-sync)](https://pypi.org/project/eufy-sync/)
+[![Downloads](https://img.shields.io/pypi/dm/eufy-sync)](https://pypi.org/project/eufy-sync/)
+![Python](https://img.shields.io/pypi/pyversions/eufy-sync)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+Syncs body composition data from a Eufy smart scale to Garmin Connect and/or Strava. Weight, body fat %, muscle mass, bone mass, hydration, BMR, visceral fat, and metabolic age all come through to Garmin. Strava gets weight updates.
+
+> macOS only. Requires Python 3.9+ and a terminal. Setup is guided - you just answer a few prompts.
+
+## The problem
+
+Eufy scales sync to Apple Health, Fitbit, and Google Fit - but not Garmin or Strava. If you use either for training, your body comp data is stuck in a separate app. This fixes that.
+
+## Why not just use python-garminconnect?
+
+Every Python library that talked to Garmin broke in March 2026. Garmin put Cloudflare in front of their SSO, which blocks any login that doesn't come from a real browser. [garth](https://github.com/matin/garth) is [deprecated](https://github.com/matin/garth/discussions/222), [python-garminconnect](https://github.com/cyberjunky/python-garminconnect) can't authenticate anymore, and there's no official API.
+
+This project gets around it with Playwright. On first run, a real Chromium window opens and you log in normally. OAuth2 tokens get saved to your system keychain and refresh on their own for about a year. After that first login, no browser needed - body comp data goes up as FIT files through Garmin's upload endpoint.
+
+## Install
+
+You need Python 3.9+, a Eufy scale with cloud sync, and a Garmin Connect and/or Strava account.
+
+First, install pipx if you don't have it:
+```bash
+brew install pipx
+```
+Or if you don't use Homebrew: `pip3 install pipx`
+
+Then install and run:
+```bash
+pipx install eufy-sync
+eufy-sync
+```
+
+Setup is guided on first run - choose your sync targets (Garmin, Strava, or both), enter your credentials, and your data syncs automatically.
+
+> **Note:** If you've cloned this repo, run pipx commands from outside the repo directory to avoid path conflicts (e.g., `cd /tmp && pipx install eufy-sync`).
+
+## Usage
+
+```bash
+eufy-sync                      # sync new measurements to all configured targets
+eufy-sync --status           # check last sync + token health
+eufy-sync --dry-run          # preview without uploading
+eufy-sync --setup-strava     # connect Strava (add to existing setup)
+eufy-sync --reauth           # re-login to all targets
+eufy-sync --reauth garmin    # re-login to Garmin only
+eufy-sync --reauth strava    # re-authorize Strava only
+eufy-sync --update-password  # change stored passwords
+eufy-sync --backfill-days 30 # sync last 30 days
+eufy-sync --verbose          # show detailed sync logs
+eufy-sync --install-agent   # set up automatic sync
+eufy-sync --uninstall-agent # remove automatic sync
+eufy-sync --uninstall       # remove all data and clean up
+```
+
+## Updating
+
+The tool checks for updates weekly and will let you know when a new version is available. To update:
+
+```bash
+pipx install --force eufy-sync
+```
+
+## Automatic sync (macOS)
+
+On first run, you'll be asked if you want to sync automatically every 4 hours. If you say yes, a macOS Launch Agent is installed that runs in the background - weigh yourself, open your laptop later, and it syncs on its own.
+
+Logs go to `~/.garmin-sync/sync.log`. You get a macOS notification if something fails.
+
+To disable: `eufy-sync --uninstall-agent`
+
+## Adding Strava
+
+If you already have Garmin set up and want to add Strava:
+
+1. Create a Strava API application at https://www.strava.com/settings/api
+2. Set the redirect URI to `http://localhost:8089/callback`
+3. Run `eufy-sync --setup-strava` and enter your Client ID and Secret
+4. Authorize in the browser when it opens
+
+Future syncs will update both Garmin and Strava automatically. Strava receives weight only (no body composition - Strava's API limitation).
+
+## How it works
+
+```
+                                                  /--> garmin_client.py --> Garmin Connect
+Eufy Cloud API --> eufy_client.py --> transform.py     (FIT file + upload)
+(fetch history)    (auth + pull)     (filter, dedup) \
+                                          |           \--> strava_client.py --> Strava
+                                      state.db              (weight update)
+                                   (sync watermark)
+```
+
+1. Authenticate to Eufy cloud API, pull measurement history
+2. Check local SQLite DB for what's already been synced (per target)
+3. For Garmin: check for existing entries on the same date (multi-machine dedup)
+4. Generate a FIT binary file and upload to Garmin Connect
+5. Update athlete weight on Strava
+6. Record syncs in DB
+
+## Security
+
+Your passwords and OAuth tokens are stored in your system keychain (macOS Keychain) - not in plaintext files. Config files in `~/.garmin-sync/` only contain email addresses and Strava API app credentials, with `600` permissions. Credentials are only sent to Eufy, Garmin, and Strava's own servers over HTTPS. They are never logged, uploaded, or transmitted anywhere else. The only other outbound call is a weekly version check to `pypi.org` (no credentials sent). You can verify this yourself - the codebase is small and the outbound calls are in `eufy_client.py`, `garmin_auth.py`, `strava_client.py`, and the update checker in `cli.py`.
+
+On systems without keychain support (headless Linux), credentials fall back to file-based storage with `600` permissions.
+
+## Known quirks
+
+**Weight precision:** The Eufy cloud API returns weight at ~0.05 kg resolution, which can differ slightly from what the Eufy app displays (the app may read from Bluetooth/local storage with higher precision). In testing, most days match within 0.1 lbs, but occasional readings can be off by up to ~0.5 lbs. If Garmin displays in lbs, the kg-to-lbs conversion adds a bit more rounding on top.
+
+## Tests
+
+```bash
+pytest tests/ -v
+```
+
+## Disclaimer
+
+Uses unofficial APIs for Eufy and Garmin, and the official Strava API. Could break if any of these companies change things. Use at your own risk.
+

eufy_sync-1.5.0/README.md

@@ -0,0 +1,124 @@
+# eufy-sync
+
+[![PyPI](https://img.shields.io/pypi/v/eufy-sync)](https://pypi.org/project/eufy-sync/)
+[![Downloads](https://img.shields.io/pypi/dm/eufy-sync)](https://pypi.org/project/eufy-sync/)
+![Python](https://img.shields.io/pypi/pyversions/eufy-sync)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+Syncs body composition data from a Eufy smart scale to Garmin Connect and/or Strava. Weight, body fat %, muscle mass, bone mass, hydration, BMR, visceral fat, and metabolic age all come through to Garmin. Strava gets weight updates.
+
+> macOS only. Requires Python 3.9+ and a terminal. Setup is guided - you just answer a few prompts.
+
+## The problem
+
+Eufy scales sync to Apple Health, Fitbit, and Google Fit - but not Garmin or Strava. If you use either for training, your body comp data is stuck in a separate app. This fixes that.
+
+## Why not just use python-garminconnect?
+
+Every Python library that talked to Garmin broke in March 2026. Garmin put Cloudflare in front of their SSO, which blocks any login that doesn't come from a real browser. [garth](https://github.com/matin/garth) is [deprecated](https://github.com/matin/garth/discussions/222), [python-garminconnect](https://github.com/cyberjunky/python-garminconnect) can't authenticate anymore, and there's no official API.
+
+This project gets around it with Playwright. On first run, a real Chromium window opens and you log in normally. OAuth2 tokens get saved to your system keychain and refresh on their own for about a year. After that first login, no browser needed - body comp data goes up as FIT files through Garmin's upload endpoint.
+
+## Install
+
+You need Python 3.9+, a Eufy scale with cloud sync, and a Garmin Connect and/or Strava account.
+
+First, install pipx if you don't have it:
+```bash
+brew install pipx
+```
+Or if you don't use Homebrew: `pip3 install pipx`
+
+Then install and run:
+```bash
+pipx install eufy-sync
+eufy-sync
+```
+
+Setup is guided on first run - choose your sync targets (Garmin, Strava, or both), enter your credentials, and your data syncs automatically.
+
+> **Note:** If you've cloned this repo, run pipx commands from outside the repo directory to avoid path conflicts (e.g., `cd /tmp && pipx install eufy-sync`).
+
+## Usage
+
+```bash
+eufy-sync                      # sync new measurements to all configured targets
+eufy-sync --status           # check last sync + token health
+eufy-sync --dry-run          # preview without uploading
+eufy-sync --setup-strava     # connect Strava (add to existing setup)
+eufy-sync --reauth           # re-login to all targets
+eufy-sync --reauth garmin    # re-login to Garmin only
+eufy-sync --reauth strava    # re-authorize Strava only
+eufy-sync --update-password  # change stored passwords
+eufy-sync --backfill-days 30 # sync last 30 days
+eufy-sync --verbose          # show detailed sync logs
+eufy-sync --install-agent   # set up automatic sync
+eufy-sync --uninstall-agent # remove automatic sync
+eufy-sync --uninstall       # remove all data and clean up
+```
+
+## Updating
+
+The tool checks for updates weekly and will let you know when a new version is available. To update:
+
+```bash
+pipx install --force eufy-sync
+```
+
+## Automatic sync (macOS)
+
+On first run, you'll be asked if you want to sync automatically every 4 hours. If you say yes, a macOS Launch Agent is installed that runs in the background - weigh yourself, open your laptop later, and it syncs on its own.
+
+Logs go to `~/.garmin-sync/sync.log`. You get a macOS notification if something fails.
+
+To disable: `eufy-sync --uninstall-agent`
+
+## Adding Strava
+
+If you already have Garmin set up and want to add Strava:
+
+1. Create a Strava API application at https://www.strava.com/settings/api
+2. Set the redirect URI to `http://localhost:8089/callback`
+3. Run `eufy-sync --setup-strava` and enter your Client ID and Secret
+4. Authorize in the browser when it opens
+
+Future syncs will update both Garmin and Strava automatically. Strava receives weight only (no body composition - Strava's API limitation).
+
+## How it works
+
+```
+                                                  /--> garmin_client.py --> Garmin Connect
+Eufy Cloud API --> eufy_client.py --> transform.py     (FIT file + upload)
+(fetch history)    (auth + pull)     (filter, dedup) \
+                                          |           \--> strava_client.py --> Strava
+                                      state.db              (weight update)
+                                   (sync watermark)
+```
+
+1. Authenticate to Eufy cloud API, pull measurement history
+2. Check local SQLite DB for what's already been synced (per target)
+3. For Garmin: check for existing entries on the same date (multi-machine dedup)
+4. Generate a FIT binary file and upload to Garmin Connect
+5. Update athlete weight on Strava
+6. Record syncs in DB
+
+## Security
+
+Your passwords and OAuth tokens are stored in your system keychain (macOS Keychain) - not in plaintext files. Config files in `~/.garmin-sync/` only contain email addresses and Strava API app credentials, with `600` permissions. Credentials are only sent to Eufy, Garmin, and Strava's own servers over HTTPS. They are never logged, uploaded, or transmitted anywhere else. The only other outbound call is a weekly version check to `pypi.org` (no credentials sent). You can verify this yourself - the codebase is small and the outbound calls are in `eufy_client.py`, `garmin_auth.py`, `strava_client.py`, and the update checker in `cli.py`.
+
+On systems without keychain support (headless Linux), credentials fall back to file-based storage with `600` permissions.
+
+## Known quirks
+
+**Weight precision:** The Eufy cloud API returns weight at ~0.05 kg resolution, which can differ slightly from what the Eufy app displays (the app may read from Bluetooth/local storage with higher precision). In testing, most days match within 0.1 lbs, but occasional readings can be off by up to ~0.5 lbs. If Garmin displays in lbs, the kg-to-lbs conversion adds a bit more rounding on top.
+
+## Tests
+
+```bash
+pytest tests/ -v
+```
+
+## Disclaimer
+
+Uses unofficial APIs for Eufy and Garmin, and the official Strava API. Could break if any of these companies change things. Use at your own risk.
+

eufy_sync-1.5.0/eufy_sync/__init__.py

@@ -0,0 +1,20 @@
+"""Sync Eufy smart scale body composition data to Garmin Connect and Strava."""
+
+__version__ = "1.5.0"
+
+# Public API for programmatic use
+from eufy_sync.garmin_auth import GarminAuth
+from eufy_sync.eufy_client import EufyClient, EufyMeasurement
+from eufy_sync.fit import FitEncoder
+from eufy_sync.strava_client import StravaClient
+from eufy_sync.transform import GarminBodyComposition, transform
+
+__all__ = [
+    "GarminAuth",
+    "EufyClient",
+    "EufyMeasurement",
+    "FitEncoder",
+    "GarminBodyComposition",
+    "StravaClient",
+    "transform",
+]