note1: use v2.0 need change vercel setting from Gatsby to Vite

note2: 2023.09.26 garmin need secret_string(and in Actions) get python run_page/garmin_sync.py ${secret_string} if cn python run_page/garmin_sync.py ${secret_string} --is-cn

note3: 2024.08.19: Added Elevation Gain field

• For old data: To include Elevation Gain for past activities, perform a full reimport.

Create a personal workouts home page

简体中文 | English

This project is based on running_page and adds support for multi sports types. Follow the steps in the origin repo to deploy.

New Features

1. support multi sports types, like Ride/Hike/Swim/Rowing
2. support new apps
   • Codoon（咕咚） (Couldn't automate for its limitation from the server side)
   • Xingzhe（行者）
   • Google Health
3. support RoadTrip(GoogleMaps), show Road Trip on maps

Custom your page

Change Sports Color

• Modify Ride Color: RIDE_COLOR in src/utils/const.js

Add Sports Type

• Modify TYPE_DICT & MAPPING_TYPE in scripts/config.py
• Add Type Name and add it into RUN_TITLES in src/utils/const.js
• Modify colorFromType & titleForRun in src/utils/util.js
• see commit
• or comment here

---

Codoon（咕咚）

Get your Codoon data

python3(python) scripts/codoon_sync.py ${your mobile or email} ${your password}

example：

python3(python) scripts/codoon_sync.py 13333xxxx xxxx

use --with-gpx flag to save your gpx data

use --from-auth-token flag to login by refresh_token&user_id

example：

python3(python) scripts/codoon_sync.py 54bxxxxxxx fefxxxxx-xxxx-xxxx --from-auth-token

Xingzhe（行者）

Get your Xingzhe data

python3(python) scripts/xingzhe_sync.py ${your mobile or email} ${your password}

example：

python3(python) scripts/xingzhe_sync.py 13333xxxx xxxx

use --with-gpx flag to save your gpx data

use --from-auth-token flag to login by refresh_token&user_id

example：

python3(python) scripts/xingzhe_sync.py w0xxx 185000 --from-auth-token

Google Health

Get your Google Health data

Google Health API is the v4 Google API that replaces the legacy Fitbit Web API. This sync downloads exercise records from https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints, exports each exercise as TCX with :exportExerciseTcx?alt=media, saves the files to TCX_OUT by default, then imports them into data.db and activities.json. If you choose GPX output, the script converts the v4 TCX export locally and saves files to GPX_OUT.

1. Create a Google Cloud project, enable Google Health API, and create an OAuth 2.0 Web client. Add your account as a test user while the app is in Testing mode.

   1. Go to the Google Cloud Console and create a new project (or select an existing one).
   2. Enable the Google Health API:
      • Navigate to APIs & Services → Library
      • Search for Google Health API and click Enable
   3. Create OAuth 2.0 credentials:
      • Go to APIs & Services → Credentials → Create Credentials → OAuth client ID
      • Choose Desktop app as the application type
      • Download the JSON credentials file or note your Client ID and Client Secret
   4. Configure the OAuth consent screen (APIs & Services → OAuth consent screen):
      • Set the user type to External
      • Add yourself as a Test user
      • Add both scopes (required for all formats):
      • https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
      • https://www.googleapis.com/auth/googlehealth.location.readonly

2. Open the authorization URL below after replacing ${client_id}. The redirect URI must match the one configured in Google Cloud.

   https://accounts.google.com/o/oauth2/v2/auth?client_id=${client_id}&redirect_uri=http://localhost&response_type=code&access_type=offline&scope=https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly%20https://www.googleapis.com/auth/googlehealth.location.readonly&prompt=consent
   

3. Copy the returned code and exchange it for a refresh_token:

   curl -L -X POST 'https://oauth2.googleapis.com/token' \
   -H 'Content-Type: application/x-www-form-urlencoded' \
   -d 'client_id=${client_id}&client_secret=${client_secret}&code=${code}&redirect_uri=http://localhost&grant_type=authorization_code'

4. Sync Google Health data:

   python run_page/google_health_sync.py ${client_id} ${client_secret} ${refresh_token}

   If you only want running exercises:

   python run_page/google_health_sync.py ${client_id} ${client_secret} ${refresh_token} --only-run

   Optional filters:

   • --start-date YYYY-MM-DD syncs exercises starting from that civil date. If omitted, the script uses the latest start_date_local in data.db as the Google Health exercise.interval.civil_start_time lower bound.
   • --end-date YYYY-MM-DD syncs exercises before that civil date.
   • --all ignores the local database date and asks Google Health for all exercises.
   • --format gpx exports GPX files to GPX_OUT; the default is --format tcx.

   Example for GPX:

   python run_page/google_health_sync.py ${client_id} ${client_secret} ${refresh_token} --format gpx

5. For GitHub Actions, add GOOGLE_HEALTH_CLIENT_ID, GOOGLE_HEALTH_CLIENT_SECRET, and GOOGLE_HEALTH_REFRESH_TOKEN to GitHub Secrets, then set RUN_TYPE to google_health.

6. Configure the OAuth consent screen (APIs & Services → OAuth consent screen):

   • Set the user type to Internal; otherwise, you need to publish the app.

RoadTrip(GoogleMaps)

Import KML from Google Maps

1. Create a map in Google Maps (keep the route in one Layer)
2. Export Layer to KML file
3. Rename the file to import.kml and place it into scripts
4. Modify scripts/kml2polyline.py, fill in the trip info

# TODO modify here
# trip name
track.name = "2020-10 Tibet Road Trip"
# start/end time Year-Month-Day-Hour-Minute
track.start_time = datetime(2020, 9, 29, 10, 0)
track.end_time = datetime(2020, 10, 10, 18, 0)
# total distance
distance = 4000  # KM
# total days
days = 12
# average daily distance
hours_per_day = 6

5. Execute in Console

python3(python) scripts\kml2polyline.py

Special thanks

• @yihong0618 for Awesome running_page, Great Thanks