Note

1. clone or Fork before vercel 404 need to pull the latest code
2. python in README means python3 python
3. use v2.0 need change vercel setting from gatsby to vite
4. 2023.09.26 garmin need secret_string(and in Actions) get

bash python run_page/get_garmin_secret.py ${email} ${password} # if cn python run_page/get_garmin_secret.py ${email} ${password} --is-cn

1. 2024.09.29: Added Elevation Gain field, If you forked the project before this update, please run the following command:
2. To resolve errors: sqlalchemy.exc.OperationalError: (sqlite3.OperationalError) no such column: activities.elevation_gain
3. If you don't have a local environment, set RUN_TYPE to db_updater in the .github/workflows/run_data_sync.yml file once then change back.

bash python run_page/db_updater.py

• For old data: To include Elevation Gain for past activities, perform a full reimport.
• To show the 'Elevation Gain' column, modify SHOW_ELEVATION_GAIN in src/utils/const.ts
• note: Elevation Gain may be inaccurate. You can use Strava's "Correct Elevation" or Garmin's "Elev Corrections" feature for more precise data.
• 本项目现在默认使用 MapCN（免费）。如果你选择使用 Mapbox，请获取你自己的 token。请勿使用项目维护者的 token - 查看此 issue 和 issue #1055

这里是白银越野赛全部 21 位逝者的故事

R.I.P. 希望大家都能健康顺利的跑过终点，逝者安息。

打造个人跑步主页

English | 简体中文 | Wiki

GIF 展示

大家的跑步主页展示

Running page runners

Runner	page	App
zhubao315	https://zhubao315.github.io/running	Strava
shaonianche	https://run.duanfei.org	Strava
yihong0618	https://yihong.run	Nike
superleeyom	https://running.leeyom.top	Strava
geekplux	https://activities.geekplux.com	Nike
guanlan	https://grun.vercel.app	Strava
tuzimoe	https://run.tuzi.moe	Nike
ben_29	https://running.ben29.xyz	Strava
kcllf	https://running-tau.vercel.app	Garmin-cn
mq	https://running-iota.vercel.app	Keep
zhaohongxuan	https://zhaohongxuan.github.io/workouts	Strava
yvetterowe	https://run.haoluo.io	Strava
love-exercise	https://run.kai666666.top	Keep
zstone12	https://running-page.zstone12.vercel.app	Keep
Lax	https://lax.github.io/running	Keep
lusuzi	https://running.lusuzi.vercel.app	Nike
wh1994	https://run4life.fun	Garmin
liuyihui	https://run.foolishfox.cn	Keep
sunyunxian	https://sunyunxian.github.io/running_page	Strava
AhianZhang	https://running.ahianzhang.com	Nike
L1cardo	https://run.licardo.cn	Nike
luckylele666	https://0000928.xyz	Strava
MFYDev	https://mfydev.run	Garmin-cn
Oysmart	https://run.ouyang.wang	Garmin-cn
Eished	https://run.iknow.fun	Keep
Liuxin	https://liuxin.run	Nike
loucx	https://loucx.github.io/running	Nike
winf42	https://winf42.github.io	Garmin-cn
sun0225SUN	https://run.sunguoqi.com	Nike
Zhan	https://run.zlog.in	Nike
Dennis	https://run.domon.cn	Garmin-cn
hanpei	https://running.nexts.top	Garmin-cn
liugezhou	https://run.liugezhou.online	Strava
zhubao315	https://zhubao315.github.io/running	Strava
Jason Tan	https://jason-cqtan.github.io/running_page	Nike
Conge	https://conge.github.io/running_page	Strava
cvvz	https://cvvz.github.io/running	Strava
zHElEARN	https://workouts.zhelearn.com	Strava
Rhfeng	https://sport.frh.life	Garmin-cn
Ym9i	https://bobrun.vercel.app/	Strava
jianchengwang	https://jianchengwang.github.io/running_page	Suunto
fxbin	https://fxbin.github.io/sport-records/	Keep
shensl4499	https://waner.run	codoon
haowei93	https://running-fun.eu.org	gpx
stevenash0822	https://run.imangry.xyz/	Strava
Vint	https://vinton.store/Running/	Keep
Muyids	https://muyids.github.io/running	Garmin-cn
Gao Hao	https://efish2002.github.io/running_page/	Garmin-cn
Jinlei	https://jinlei.run/	咕咚
Ray Wang	https://run.raywang.pro/	Garmin
RealTiny656	https://tiny656.github.io/running_page/	JoyRun
EINDEX	https://workouts.eindex.me/	Strava/Nike
Melt	https://running.autove.dev/	Strava
deepinwine	https://deepin.autove.dev/	Garmin-cn
Jeffggmm	https://jeffggmm.github.io/workouts_page/	Garmin
s1smart	https://s1smart.github.io/running_page/	Strava
Ryan	https://85ryan.github.io/gooorun/	Strava
PPZ	https://run.dudubbbbbbbbb.top/	Strava
Yer1k	https://running.yer1k.com/	Strava
AlienVision	https://run.drink.cafe/	Strava
Vensent	https://vensent.github.io/workouts_page/	Garmin
Zeonsing	https://run.jogzeal.com/	Coros
yaoper	https://running.yaoper.cn	codoon
NoZTurn	https://run.jiangkai.org	Strava
laqieer	https://laqieer.github.io/running_page/	Strava
Guoxin	https://running.guoxin.space/	Strava
Darren	https://run.wdoc.top/	tcx
Evan	https://github.com/LinghaoChan/running	Keep
Shuqi	https://runner-shuqi.devlink.cn/	Garmin
shugoal	https://shugoal.github.io/wk-shu/	Garmin
Bolyn	https://run.wbolyn.com	Coros
LeiChen	https://xthirty77.github.io/running_page/	Coros
itrunner	https://itrunner.cn	Garmin
maslke	https://maslke.space/running_page/	Garmin-cn
Niewei Yang	https://neewii-worksout.vercel.app/	Strava
RUN.LOG	https://run.731558.xyz:6881/	Strava
StoneRicky	https://stonericky.github.io/running_page/	COROS
coutureone	https://run.xcouture.cc/	Garmin

它是怎么工作的

特性

1. GitHub Actions 自动同步跑步数据，生成展示页面
2. 支持 Vercel（推荐）和 GitHub Pages 自动部署
3. React Hooks
4. Mapbox 进行地图展示
5. Nike、Strava、佳明（佳明中国）及 Keep 等，自动备份 GPX 数据，方便备份及上传到其它软件
6. 支持终端界面（TUI）本地浏览运动数据

因为数据存在 gpx 和 data.db 中，理论上支持几个软件一起，你可以把之前各类 App 的数据都同步到这里（建议本地同步，之后 Actions 选择正在用的 App）

如果你不想公开数据，可以选择 Strava 的模糊处理，或 private 仓库。

缩放地图彩蛋

支持

• Strava
• New Way To Sync Nike Run Club ：NFC 同步的新方式
• Nike Run Club
• Garmin
• Garmin-cn
• Keep
• 悦跑圈 ：限制单个设备，无法自动化
• 郁金香运动
• GPX
• TCX
• FIT
• 佳明国内同步国际
• Tcx+Strava(upload all tcx data to strava)
• Tcx+Garmin(upload all tcx data to Garmin)
• Gpx+Strava(upload all gpx data to strava)
• Nike+Strava(Using NRC Run, Strava backup data)
• Garmin_to_Strava(Using Garmin Run, Strava backup data)
• Strava_to_Garmin(Using Strava Run, Garmin backup data)
• Coros 高驰
• iGPSPORT迹驰
• Komoot
• Onelap
• Intervals.icu

视频教程

• https://www.youtube.com/watch?v=reLiY9p8EJk
• https://www.youtube.com/watch?v=VdNkFxTX5QQ

下载

git clone https://github.com/yihong0618/running_page.git --depth=1

安装及测试 (node >= 20 python >= 3.11)

pip3 install -r requirements.txt
npm install -g corepack && corepack enable && pnpm install
pnpm develop

访问 http://localhost:5173/ 查看

TUI（终端界面）

你可以在终端中使用内置的 Textual TUI 浏览运动数据。

# 使用 make
make tui

# 或直接用 uv 运行
uv run run_page

# 或指定自定义的 activities.json 路径
uv run run_page /path/to/your/activities.json

TUI 中的键盘快捷键：

• 1 / 2 – 切换列表和统计视图
• ← / → – 切换年份
• ↑ / ↓ – 选择活动
• y – 循环切换年份
• t – 循环切换运动类型
• q – 退出

Docker

```bash

NRC

docker build -t running_page:latest . --build-arg app=NRC --build-arg nike_refresh_token=""

Garmin

docker build -t running_page: