Skip to content

DaryanLab/garminwo-extension

Repository files navigation

GarminWO — Chrome Extension

GarminWO Chrome License Languages


🇫🇷 Français

Présentation

GarminWO est une extension Chrome gratuite qui permet d'importer des séances d'entraînement running directement dans Garmin Connect depuis :

  • 📸 Une photo ou screenshot de plan d'entraînement (JPG, PNG)
  • 📝 Une sélection de texte sur n'importe quelle page web (Facebook, forum, site coach…)
  • 📂 Un fichier JSON exporté depuis Garmin Connect

L'analyse visuelle ou textuelle est réalisée par une IA (Google Gemini gratuit ou Anthropic Claude payant) qui détecte automatiquement les étapes, allures et conditions de chaque séance.

Une fois importé dans Garmin Connect, l'entraînement peut être transféré vers la montre via le câble USB connecté à l'ordinateur, ou depuis l'application mobile Garmin Connect.

Fonctionnalités

Fonctionnalité Description
📸 Import via image Glisse une photo ou screenshot → l'IA analyse et importe
📝 Import via texte Sélectionne du texte → clic droit → "Envoyer à GarminWO"
📂 Import JSON Fichier JSON Garmin exporté — sans appel IA
🖱️ Menu clic droit Clic droit sur image ou texte sélectionné sur n'importe quelle page
🗑️ Suppression multiple Cases à cocher dans la liste Garmin → suppression en masse
🔄 Bouton Réessayer Relance l'analyse en cas d'erreur API temporaire
❓ Aide intégrée Bouton ? dans le modal → ouvre le guide PDF dans la langue du navigateur
🌍 6 langues Français, Anglais, Espagnol, Allemand, Italien, Russe
🔒 Vie privée Aucun serveur — aucune donnée collectée — clé API stockée localement
🆓 Gratuit Open source — Gemini offre 1500 analyses gratuites par jour

Installation

Option 1 — Chrome Web Store (recommandé)

  1. Ouvrez le Chrome Web Store
  2. Recherchez GarminWO
  3. Cliquez sur Ajouter à Chrome
  4. Confirmez avec Ajouter l'extension

Option 2 — Chargement manuel (mode développeur)

  1. Téléchargez et décompressez ce dépôt
  2. Dans Chrome, ouvrez chrome://extensions
  3. Activez le Mode développeur (bouton en haut à droite)
  4. Cliquez sur Charger l'extension non empaquetée
  5. Sélectionnez le dossier décompressé

Configuration

Gemini (Gratuit — recommandé)

  1. Rendez-vous sur aistudio.google.com/apikey
  2. Connectez-vous avec votre compte Google
  3. Cliquez sur Créer une clé API et copiez-la
  4. Cliquez sur l'icône GarminWO dans Chrome → collez la clé → Sauvegarder

🆓 Gemini 2.5 Flash est gratuit jusqu'à 1500 requêtes/jour

Claude Anthropic (~0.01€ par analyse)

  1. Créez un compte sur console.anthropic.com (5$ de crédit offerts)
  2. Allez dans API Keys → Create Key et copiez la clé
  3. Dans le popup GarminWO, sélectionnez l'onglet Claude → collez la clé → Sauvegarder

Utilisation

  1. Connectez-vous sur connect.garmin.comEntraînements
  2. Cliquez sur le bouton 📸 Lire image ou JSON (apparu automatiquement)
  3. Glissez votre photo ou screenshot → AnalyserImporter
  4. L'entraînement s'ouvre automatiquement dans Garmin Connect
  5. Transférez-le sur votre montre via câble USB ou l'application mobile

🇬🇧 English

Overview

GarminWO is a free Chrome extension that imports running workouts directly into Garmin Connect from:

  • 📸 A photo or screenshot of a training plan (JPG, PNG)
  • 📝 Selected text from any web page (Facebook, forum, coach website…)
  • 📂 A JSON file exported from Garmin Connect

Visual or text analysis is performed by AI (Google Gemini free or Anthropic Claude paid) which automatically detects steps, paces and conditions for each session.

Once imported into Garmin Connect, the workout can be transferred to your watch via USB cable connected to your computer, or from the Garmin Connect mobile app.

Features

Feature Description
📸 Import from image Drop a photo or screenshot → AI analyses and imports
📝 Import from text Select text → right-click → "Send to GarminWO"
📂 JSON import Exported Garmin JSON file — no AI call required
🖱️ Right-click menu Right-click any image or selected text on any web page
🗑️ Bulk delete Checkboxes in Garmin list → delete multiple workouts at once
🔄 Retry button Re-runs analysis on temporary API errors
❓ Built-in help ? button in modal → opens PDF guide in browser language
🌍 6 languages French, English, Spanish, German, Italian, Russian
🔒 Privacy No server — no data collected — API key stored locally
🆓 Free Open source — Gemini offers 1500 free analyses per day

Installation

Option 1 — Chrome Web Store (recommended)

  1. Open the Chrome Web Store
  2. Search for GarminWO
  3. Click Add to Chrome
  4. Confirm with Add extension

Option 2 — Manual load (developer mode)

  1. Download and unzip this repository
  2. In Chrome, open chrome://extensions
  3. Enable Developer mode (toggle in the top right)
  4. Click Load unpacked
  5. Select the unzipped folder

Configuration

Gemini (Free — recommended)

  1. Go to aistudio.google.com/apikey
  2. Sign in with your Google account
  3. Click Create API Key and copy it
  4. Click the GarminWO icon in Chrome → paste the key → Save

🆓 Gemini 2.5 Flash is free up to 1500 requests/day

Claude Anthropic (~$0.01 per analysis)

  1. Create an account at console.anthropic.com ($5 free credit)
  2. Go to API Keys → Create Key and copy it
  3. In the GarminWO popup, select the Claude tab → paste the key → Save

Usage

  1. Sign in at connect.garmin.comWorkouts
  2. Click the 📸 Import from image or JSON button (injected automatically)
  3. Drop your photo or screenshot → AnalyseImport
  4. The workout opens automatically in Garmin Connect
  5. Transfer it to your watch via USB cable or the mobile app

Privacy Policy

🇫🇷 Politique de confidentialité | 🇬🇧 Privacy Policy


Changelog

See CHANGELOG.md for the full version history.


Support


Made with ❤️ for the running community — Powered by Claude & Gemini

About

An extension capable of importing workouts into Garmin Connect from an image or a screenshot under Google Chrome. / Cette extension permet d'importer depuis une photo ou une image des séances d'entrainements dans Garmin Connect sous Google Chrome

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages