Garmin Connect Uploader v1.1.2-beta

v1.1.2-beta

[NOTE]
This is a beta release. Feedback regarding file compatibility is highly encouraged.

What's New:

Feat: Enhanced FIT file spoofing based on fit-file-faker.

Fix: Activities now correctly sync as Edge device files.

Fix: Enabled Garmin Training Effect/Metrics calculation for files containing HR and Power.

Tested: Confirmed working for Wahoo; TrainerDay and MyWhoos support is pending verification.

Garmin Connect Uploader v1.1.1

[1.1.1] - 2026-04-30

Changed (1.1.1)

• More reliable Garmin login setup: This release locks the app to the Garmin login version that worked in testing, so fresh sign-ins are more consistent.
• Update button now opens the right page: In-app update prompts now take you to the current GitHub releases page.

Fixed (1.1.1)

• Fixed some Garmin login problems on first setup: This should reduce the chance of hitting Garmin login errors when testing a new account.
• Fixed a bad environment mismatch: The app now warns you clearly if it is running with an unsupported Garmin login library.

---

⚠️ Windows Defender Notice

This application is not signed with a Microsoft code-signing certificate. Obtaining a certificate costs money, so this app remains unsigned. Windows Defender (and other antivirus tools) may flag or quarantine the executable due to its heuristic scanning — this is a false positive.

You are encouraged to read the full source code on GitHub before running this application. Use it at your own risk.

🛡️ How to prevent Defender from deleting the app

The most reliable workaround is to add the app's folder as an exclusion in Windows Defender:

1. Create a dedicated folder on your hard drive, e.g. C:\GarminUploader\
2. Extract or place the app files into that folder
3. Open Windows Security → Virus & threat protection → Manage settings
4. Scroll down to Exclusions → click Add or remove exclusions
5. Click Add an exclusion → choose Folder → select your C:\GarminUploader\ folder
6. Run GarminUploader.exe from that folder — Defender will no longer interfere

---

Two download options are available:

Option	File	Best for
Folder build (recommended)	GarminUploader-v1.1.1-folder.zip	Most users — less likely to trigger Windows Defender
Single-file build	GarminUploader-v1.1.1.exe	Advanced users who prefer a single executable

Option A: Folder build (recommended)

1. Download GarminUploader-v1.1.1-folder.zip from Releases
2. Extract the ZIP to a dedicated folder (e.g., C:\GarminUploader\)
3. Add that folder as a Windows Defender exclusion (see above)
4. Run GarminUploader.exe

Option B: Single-file build

1. Download GarminUploader-v1.1.1.exe from Releases
2. Place it in a dedicated folder and add that folder as a Windows Defender exclusion (see above)
3. Double-click to run

Garmin Connect Uploader v1.1.0

[1.1.0] - 2026-04-26

What's new in 1.1.0

• Two-Factor Authentication (MFA/2FA) support: The app now fully supports Garmin accounts with two-step verification enabled. When logging in for the first time (or when credentials change), you'll be prompted to enter your 6-digit verification code. Authentication tokens are securely saved and automatically reused, so you only need to enter the MFA code once.
• Test & Login button: Added a dedicated "Test & Login" button next to the password field in Garmin Settings. Use this to manually verify your Garmin credentials and save authentication tokens without triggering a full sync.
• Visual login status indicator: A green checkmark (✓) and "Logged in" text appear next to the password field when you have a valid Garmin session, providing clear visual feedback.
• Smart auto-start behavior: When the app starts with Windows:
  • If you have saved tokens: Silently resumes session and starts monitoring without any login prompts
  • If no tokens exist: Keeps window open and prompts you to click "Test & Login" instead of attempting automatic authentication
• Experimental Wahoo Edge spoof mode: Added an opt-in setting to process Wahoo uploads through a best-effort Garmin Edge compatibility path. Modified files are written to uploaded/modified, and detailed logs now show whether each upload used conversion, metadata modification, or fallback.
• In-app update checker: Added a Check for updates button in the About window that reads version.json from GitHub and compares against the running app version.
• Clickable release destination: When an update is available, the app now shows a clean GitHub Releases link plus an Open button.

Changed (1.1.0)

• Smarter credential validation: The app now only prompts to test Garmin credentials when they've actually changed, preventing unnecessary MFA prompts every time you save settings. The login state is tracked and preserved across sessions.
• Eliminated retry loops: Login attempts are now single-try instead of 3 retries to avoid triggering Garmin's rate limiting. If login fails, you'll get a clear error message instead of multiple failed attempts.
• Better rate limit handling: Added specific error detection and user-friendly messaging for Garmin's rate limiting (HTTP 429 errors), with clear instructions on what to do.
• Persistent login state: Once you successfully login with "Test & Login", the app remembers you're logged in and won't attempt to re-authenticate when you start auto-sync or save settings.
• Experimental spoof fallback behavior: In experimental Wahoo mode, conversion/modification now retries automatically and, if still unsuccessful, uploads the original file unchanged (without creating an extra fallback copy).
• Cleaner bottom action layout: Removed the old Actions heading/icon, moved core controls upward, and placed About & update on its own row for better visual balance.
• Updated experimental mode naming/help text: Renamed the setting to Experimental Garmin mode and refreshed the info dialog wording to clarify challenge credit and metric timing expectations.

Fixed (1.1.0)

• Fixed authentication failures caused by Garmin deprecating the old garth library authentication method. The new mobile SSO flow is the official, supported method.
• Fixed rate limiting issues where the app would trigger Garmin's security measures by making too many login attempts on startup or during normal operation.
• Fixed redundant login attempts - the app now properly reuses saved authentication tokens instead of logging in every time you start auto-sync or restart the application.

---

⚠️ Windows Defender Notice

This application is not signed with a Microsoft code-signing certificate. Obtaining a certificate costs money, so this app remains unsigned. Windows Defender (and other antivirus tools) may flag or quarantine the executable due to its heuristic scanning — this is a false positive.

You are encouraged to read the full source code on GitHub before running this application. Use it at your own risk.

🛡️ How to prevent Defender from deleting the app

The most reliable workaround is to add the app's folder as an exclusion in Windows Defender:

1. Create a dedicated folder on your hard drive, e.g. C:\GarminUploader\
2. Extract or place the app files into that folder
3. Open Windows Security → Virus & threat protection → Manage settings
4. Scroll down to Exclusions → click Add or remove exclusions
5. Click Add an exclusion → choose Folder → select your C:\GarminUploader\ folder
6. Run GarminUploader.exe from that folder — Defender will no longer interfere

---

Two download options are available:

Option	File	Best for
Folder build (recommended)	GarminUploader-v1.1.0-folder.zip	Most users — less likely to trigger Windows Defender
Single-file build	GarminUploader-v1.1.0.exe	Advanced users who prefer a single executable

Option A: Folder build (recommended)

1. Download GarminUploader-v1.1.0-folder.zip from Releases
2. Extract the ZIP to a dedicated folder (e.g., C:\GarminUploader\)
3. Add that folder as a Windows Defender exclusion (see above)
4. Run GarminUploader.exe

Option B: Single-file build

1. Download GarminUploader-v1.1.0.exe from Releases
2. Place it in a dedicated folder and add that folder as a Windows Defender exclusion (see above)
3. Double-click to run

Garmin Connect Uploader v1.0.6

[1.0.6] - 2026-03-20

Changed (1.0.6)

• TrainerDay activity titles: When uploading TrainerDay workouts, filenames like 2026-03-20 18-32-32 - Torque Blocks.tcx are now parsed so that the Garmin activity name is set to the part after the dash (for example, "Torque Blocks").
• More reliable TrainerDay title mapping: Added a short polling step after each TrainerDay upload to wait for Garmin to finish processing and then identify the newly created activity before renaming it, reducing the chance of renaming the wrong activity.

Two download options are available:

Option	File	Best for
Folder build (recommended)	GarminUploader-v1.0.5-folder.zip	Most users — less likely to trigger Windows Defender
Single-file build	GarminUploader-v1.0.5.exe	Advanced users who prefer a single executable

Option A: Folder build (recommended)

1. Download GarminUploader-v1.0.6-folder.zip from Releases
2. Extract the ZIP to a folder (e.g., C:\GarminUploader\ or your Desktop)
3. Run GarminUploader.exe from the extracted folder

Option B: Single-file build

1. Download GarminUploader-v1.0.6.exe from Releases
2. Place it anywhere you like (Desktop, Documents, etc.)
3. Double-click to run

Note: The single-file build is a packed Nuitka executable which may trigger Windows Defender ML heuristics. If Defender blocks or quarantines it, use the folder build instead. See Windows Defender / Antivirus Blocks the App for details.

Garmin Connect Uploader v1.0.5

[1.0.5] - 2026-02-25

Added (1.0.5)

• TrainerDay support as a third app source alongside Wahoo and MyWhoosh. TrainerDay uses the same Dropbox-based folder structure as Wahoo and the same upload-and-move-to-uploaded behaviour, and supports both .FIT and .TCX workout files.

Changed (1.0.5)

• Refined Folder Settings UI with collapsible sections and status-only app headers for Wahoo, MyWhoosh, and TrainerDay. Each header shows a status pill (for example: Not configured, Folder missing, Ready), and the sync logic automatically skips apps that are not in a ready state.
• Improved visuals and layout: Larger app logos for better readability and automatic window height adjustment based on the expanded/collapsed sections, reducing empty space when sections are collapsed.
• TrainerDay quality-of-life tweaks: Added an in-app TrainerDay help dialog explaining how to connect TrainerDay to Dropbox and where to find the exported folder on disk.
• Dual-build releases: Now shipping both a single-file .exe and a folder build (.zip). The folder build is less likely to trigger Windows Defender ML heuristics. See README for details.
• Added CHECKSUMS.txt with SHA-256 hashes for verifying release authenticity.

Two download options are available:

Option	File	Best for
Folder build (recommended)	GarminUploader-v1.0.5-folder.zip	Most users — less likely to trigger Windows Defender
Single-file build	GarminUploader-v1.0.5.exe	Advanced users who prefer a single executable

Option A: Folder build (recommended)

1. Download GarminUploader-v1.0.5-folder.zip from Releases
2. Extract the ZIP to a folder (e.g., C:\GarminUploader\ or your Desktop)
3. Run GarminUploader.exe from the extracted folder

Option B: Single-file build

1. Download GarminUploader-v1.0.5.exe from Releases
2. Place it anywhere you like (Desktop, Documents, etc.)
3. Double-click to run

Note: The single-file build is a packed Nuitka executable which may trigger Windows Defender ML heuristics. If Defender blocks or quarantines it, use the folder build instead. See Windows Defender / Antivirus Blocks the App for details.

Garmin Connect Uploader v1.0.4

⚡ IMPORTANT: How to Update

From v1.0.1 onwards, the app includes a "Smart Migration" feature to handle older versions automatically. To update correctly:

1. Keep it in the family: Place the new .exe in the same folder as your previous version. This ensures your settings (uploader_config.json) and logs are preserved.
2. Run the new version: Once launched, the app will detect if the auto-start shortcut points to a previous file.
3. One-Click Update: A prompt will appear asking if you'd like to update the shortcut. Simply click Yes to ensure the new version is the one that launches at boot.

Important

Your settings and logs are safe as long as the new EXE is in the same location as the old one. You can safely delete the old version's EXE file once the startup entry has been updated.

Upgrading from v1.0.2 or earlier: The old Startup-folder shortcut (GarminUploader.lnk) and XOR-encrypted password in uploader_config.json are automatically migrated on first launch of v1.0.3. No manual steps required.

[1.0.4] - 2026-02-09

Changed (1.0.4)

• Reverted auto-start from registry back to Startup-folder shortcuts, using a lightweight temporary VBScript executed by cscript.exe to create the .lnk file. The Python exe itself never calls COM or PowerShell directly. The registry HKCU\...\Run approach introduced in v1.0.3 triggered Wacapew.A!ml detections in Windows Defender.
• Any leftover registry Run entry from v1.0.3 is automatically cleaned up on first launch.

Fixed (1.0.4)

• Fixed Windows Defender Wacapew.A!ml false positive by removing all winreg registry writes. The exe no longer modifies HKCU\Software\Microsoft\Windows\CurrentVersion\Run.
• Fixed settings/config not loading at Windows startup. The config file path was relative, so when Windows launched the app at boot (working directory C:\Windows\System32) it couldn't find uploader_config.json. The path is now resolved to an absolute path based on the exe's directory.
• Fixed "OAuth1 token is required" upload error caused by stale Garmin sessions not being detected. The app now verifies the session before each sync and re-authenticates if expired. Failed session logins also properly reset the client so credential-based login can take over.
• Improved early-boot password retrieval. Added a retry with short delay for Windows Credential Manager reads, plus a safe base64 config-file fallback so credentials are always available even if keyring isn't ready yet.

Garmin Connect Uploader v1.0.3

[1.0.3] - 2026-02-05

Changed (1.0.3)

• Windows auto-start now uses the registry (HKCU\Software\Microsoft\Windows\CurrentVersion\Run) instead of dropping a .lnk shortcut in the Startup folder. This is the standard, Defender-friendly approach and eliminates the need for WScript.Shell COM objects and PowerShell.
• Password storage moved to Windows Credential Manager via the keyring library, replacing the old XOR + Base64 obfuscation. A simple base64 fallback is kept in uploader_config.json for early-boot resilience.
• Removed dependency on pywin32 / win32com.client; replaced with the built-in winreg module and the keyring package.

Fixed (1.0.3)

• Reduced Windows Defender false-positive triggers by removing all PowerShell invocations (including -ExecutionPolicy Bypass), COM-based shortcut manipulation, and XOR + Base64 encoding patterns that match common malware heuristics.
• Fixed "OAuth1 token is required" upload error caused by stale Garmin sessions not being detected. The app now verifies the session before each sync and re-authenticates if expired. Failed session logins also properly reset the client so credential-based login can take over.
• Fixed settings not loading at Windows startup when the app launches before Windows Credential Manager is fully available. A config-file fallback (simple base64) is now always kept alongside the keyring entry, with a retry mechanism for early-boot scenarios.

⚡ IMPORTANT: How to Update

From v1.0.1 onwards, the app includes a "Smart Migration" feature to handle older versions automatically. To update correctly:

1. Keep it in the family: Place the new .exe in the same folder as your previous version. This ensures your settings (uploader_config.json) and logs are preserved.
2. Run the new version: Once launched, the app will detect if the auto-start registry entry points to a previous file.
3. One-Click Update: A prompt will appear asking if you'd like to update the entry. Simply click Yes to ensure the new version is the one that launches at boot.

Important

Your settings and logs are safe as long as the new EXE is in the same location as the old one. You can safely delete the old version's EXE file once the startup entry has been updated.

Upgrading from v1.0.2 or earlier: The old Startup-folder shortcut (GarminUploader.lnk) and XOR-encrypted password in uploader_config.json are automatically migrated on first launch of v1.0.3. No manual steps required.

Garmin Connect Uploader v1.0.2

⚡ IMPORTANT: How to Update

From v1.0.1 onwards, the app includes a "Smart Migration" feature to handle older versions automatically. To update correctly:

1. Keep it in the family: Place the new .exe in the same folder as your previous version. This ensures your settings (uploader_config.json) and logs are preserved.
2. Run the new version: Once launched, the app will detect if you have an old "Start with Windows" shortcut pointing to the previous file.
3. One-Click Update: A prompt will appear asking if you'd like to update the shortcut. Simply click Yes to ensure the new version is the one that launches at boot.

Important

Your settings and logs are safe as long as the new EXE is in the same location as the old one. You can safely delete the old version's EXE file once the shortcut has been updated.

[1.0.2] - 2026-01-01

Added (1.0.2)

• Windows build now uses a standalone Nuitka onefile executable to reduce antivirus false positives (especially Windows Defender) while keeping everything self-contained.
• Dedicated uploads-only log file garmin_uploads.log that records just successful upload events, with clear daily separators.
• New "View Uploads Log" button in the About dialog to inspect upload history directly from the app.
• More robust resource bundling for compiled builds so the main icon, app logo, developer logo, and GitHub logo all display correctly in the About window.

Fixed (1.0.2)

• Improved handling of Garmin session tokens so that stale sessions are detected and recovered more reliably instead of silently failing uploads.
• Fixed edge cases in Windows auto-start shortcut migration when upgrading between versions compiled with different toolchains.
• Resolved layout issues in the About dialog where the Close button could be partially hidden on some DPI / scaling combinations.

Changed (1.0.2)

• Logging now consists of:
  • The main rotating log garmin_uploader.log (10MB, 3 backups), and
  • A separate non-rotating upload log garmin_uploads.log for a clean history of uploaded files.
• Logs are always written next to the running executable (for both script and compiled modes), making upgrades and troubleshooting simpler.
• Simplified text in the About dialog – log file paths are now accessed via the built-in log viewers instead of being shown directly.

✨ Features

• ✅ Auto-upload from Wahoo (via Dropbox sync)
• ✅ Auto-upload from MyWhoosh (local cache)
• ✅ Encrypted credential storage
• ✅ Configurable sync intervals (1-60 minutes)
• ✅ System tray support with minimize functionality
• ✅ Auto-start on Windows boot (optional)
• ✅ Comprehensive logging with visual indicators (✅ ❌ ⚠️)

📥 Download

Download GarminUploader-v1.0.1.exe below and run it!

🚀 Quick Start

1. Download and run the EXE
2. Enter your Garmin Connect credentials
3. Configure folder paths:
   • Wahoo: Use Dropbox-synced folder (click help button for setup)
   • MyWhoosh: Local cache folder
4. Click "Save Settings"
5. Click "Start Auto-Sync" or sync manually

📋 Requirements

• Windows 10/11
• Garmin Connect account
• Dropbox (for Wahoo sync)

📝 Full Documentation

See README.md for detailed instructions.

Garmin Connect Uploader v1.0.1

Changelog

All notable changes to Garmin Connect Uploader will be documented in this file.

⚡ IMPORTANT: How to Update

From v1.0.1 onwards, the app includes a "Smart Migration" feature to handle older versions automatically. To update correctly:

1. Keep it in the family: Place the new .exe in the same folder as your previous version. This ensures your settings (uploader_config.json) and logs are preserved.
2. Run the new version: Once launched, the app will detect if you have an old "Start with Windows" shortcut pointing to the previous file.
3. One-Click Update: A prompt will appear asking if you'd like to update the shortcut. Simply click Yes to ensure the new version is the one that launches at boot.

Important

Your settings and logs are safe as long as the new EXE is in the same location as the old one. You can safely delete the old version's EXE file once the shortcut has been updated.

[1.0.1] - 2025-12-29

Added

• MyWhoosh sync behavior warning in main window with link to detailed documentation
• Log file auto-rotation (10MB limit with 3 backup files for ~3 months of history)
• Built-in log viewer that opens at the latest entries instead of external text editor
• Visual icons in logs for easier scanning (✅ success, ❌ error, ⚠️ warning)
• Persistent last sync/upload status that survives app restarts
• Automatic detection and update of old version auto-start shortcuts on first launch
• Interactive close button behavior: prompts user to run in background or close app
• "Minimize to Tray" button in Actions section for explicit tray minimization

Fixed

• Bug where app would try to upload files from the "uploaded" subfolder
• GitHub repository link now points to correct URL
• Log viewer now allows text search (Ctrl+F) and selection while preventing edits
• GUI window scaling issues on high-DPI displays (user report) - added DPI awareness
• Unclear minimize to tray behavior - users weren't aware of tray functionality (user report)

Changed

• Log viewer now auto-scrolls to show latest entries first
• Updated README with new log retention policy and viewer behavior
• Optimized startup timing for Windows auto-start (reduced from 3.5s to 1s)
• Improved folder settings layout with wider entry fields and compact help buttons
• Enhanced MyWhoosh warning with larger icon, improved layout, and clearer messaging
• Adjusted window size to 600x825 with enforced minimum dimensions
• Cleaner UI spacing and alignment throughout

✨ Features

• ✅ Auto-upload from Wahoo (via Dropbox sync)
• ✅ Auto-upload from MyWhoosh (local cache)
• ✅ Encrypted credential storage
• ✅ Configurable sync intervals (1-60 minutes)
• ✅ System tray support with minimize functionality
• ✅ Auto-start on Windows boot (optional)
• ✅ Comprehensive logging with visual indicators (✅ ❌ ⚠️)

📥 Download

Download GarminUploader-v1.0.1.exe below and run it!

🚀 Quick Start

1. Download and run the EXE
2. Enter your Garmin Connect credentials
3. Configure folder paths:
   • Wahoo: Use Dropbox-synced folder (click help button for setup)
   • MyWhoosh: Local cache folder
4. Click "Save Settings"
5. Click "Start Auto-Sync" or sync manually

📋 Requirements

• Windows 10/11
• Garmin Connect account
• Dropbox (for Wahoo sync)

📝 Full Documentation

See README.md for detailed instructions.

Garmin Connect Uploader v1.0.0

Garmin Connect Uploader v1.0.0

Automatically upload workout activities from Wahoo and MyWhoosh to Garmin Connect.

✨ Features

• ✅ Auto-upload from Wahoo (via Dropbox sync)
• ✅ Auto-upload from MyWhoosh (local cache)
• ✅ Encrypted credential storage
• ✅ Configurable sync intervals (1-60 minutes)
• ✅ System tray support with minimize functionality
• ✅ Auto-start on Windows boot (optional)
• ✅ Comprehensive logging with visual indicators (✅ ❌ ⚠️)

📥 Download

Download GarminUploader-v1.0.0.exe below and run it!

🚀 Quick Start

1. Download and run the EXE
2. Enter your Garmin Connect credentials
3. Configure folder paths:
   • Wahoo: Use Dropbox-synced folder (click help button for setup)
   • MyWhoosh: Local cache folder
4. Click "Save Settings"
5. Click "Start Auto-Sync" or sync manually

📋 Requirements

• Windows 10/11
• Garmin Connect account
• Dropbox (for Wahoo sync)

📝 Full Documentation

See README.md for detailed instructions.