Garmin Connect Activities

Overview

This repository contains scripts to retrieve and process activity data from Garmin Connect so that it can be explored and analyzed in Excel and visualized in Tableau:

• Tableau Dashboard (Activity Data)

Features

• Fetch activity data from Garmin Connect
• Process and analyze fitness data
• Export data in user-friendly formats
• Generate summary statistics and visualizations

Prerequisites

Ensure you have the following installed before using the scripts:

• Python 3.x
• Required Python packages (listed in requirements.txt)

Installation

1. Clone the repository:

   git clone https://github.com/bhyman67/Garmin-Connect-Activities.git
   cd Garmin-Connect-Activities
   

2. Install dependencies:

   pip install -r requirements.txt
   

Scripts / Usage

Script Descriptions

1. Get Activities
   • Authenticate with Garmin Connect
   • Fetch recent activities
   • Save activities data to a pickle file
   • Handle connection and authentication errors
2. Get GPX Files
3. Extract GPX Activity Metrics from GPX Files
4. Activity Prep, Transformation, and Enrichment

Usage

There are two ways to run these scripts. Either all of them sequentially. Or only the first and then the last if you want to skip the GPX piece.

graph TD
    B[Run Script 01 - Get Activities]
    B --> C[Run Script 04 - Activity Prep, Transformation, and Enrichment]
    C

    B --> D[Run Script 02 - Get GPX Files]
    D --> F[Run Script 03 - Extract GPX Activity Metrics]
    F --> C

Click here to view the code in this project's repository