# KeepTrack

**Repository Path**: iiamaii/KeepTrack

## Basic Information

- **Project Name**: KeepTrack
- **Description**: Windows GUI tool for generating realistic running track data (FIT format) with playground drift algorithms. KeepTrack是一个用于生成自定义操场跑步运动轨迹数据（FIT格式）的Windows图形界面工具。生成的“.fit”文件可以导入到各种运动平台（如Keep）。
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KeepTrack

KeepTrack是一个用于生成自定义跑步运动轨迹数据（FIT格式）的 Windows 图形界面工具。生成的 `.fit` 文件可以导入到各种运动平台。

**声明：本项目仅供学习交流使用喵~ 请勿用于任何商业用途或破坏平台公平性的行为。使用本工具产生的任何后果由使用者自行承担喵~**

## ✨ 特性

- 🖥️ **图形化界面**：使用 Tkinter 构建的简单易用 UI。
- 🏃 **自定义跑步数据**：支持自定义距离、时长、开始时间等参数。
- 📍 **真实轨迹模拟**：内置“直道稳、弯道飘、整体低频漂移”的操场绕圈轨迹算法，更加符合真实跑步情况。
- 📊 **丰富的数据维度**：自动计算配速，并包含了心率、步频、步幅、功率、触地时间等高阶跑步数据。
- ⏱️ **批量生成**：支持一次性生成多份数据，并自动设置时间间隔。

## 🛠️ 安装与运行

1. **克隆项目到本地**
   ```bash
    git clone https://github.com/IAMAI-Dev/KeepTrack.git
    cd KeepTrack/code
   ```

2. **安装依赖**
   建议使用 Python 3.8 或以上版本，然后安装所需的第三方库：
   ```bash
   pip install -r requirements.txt
   ```

3. **运行程序**
   ```bash
   python main.py
   ```

## 📝 使用方法

1. 在“基础数据”区域输入你想要模拟的跑步**距离（km）**和**时长（min）**，程序会自动为你计算配速。

2. （可选）设置你想生成的份数和每次的间隔时间。

3. （可选）在“时间与位置”区域修改起跑时间和操场中心点的经纬度（默认坐标为湖北大学武昌校区一号操场）。

4. 选择生成的 FIT 文件保存路径（默认保存到桌面的 `Keep运动数据` 文件夹，若无此文件夹会自动生成）。

5. 点击“生成 FIT 运动数据”按钮，等待生成完成。

6. 导入效果：![result](./assets/Track_Result.jpg)

   

## ⚠️ 注意事项

- 项目代码中默认使用的操场坐标可能与您的实际位置不符，如有需要可以在界面中自行修改经纬度。

- 本项目的附赠文档里已经提供了一些学校操场的经纬度以及方位角（方位角是指跑道长轴与经线指北方向按顺时针旋转的夹角），若有其他学校操场需要请在谷歌地球上查阅
  查阅后确认无误也可上传至作者的Github和Gitee仓库，成为这个项目的贡献者 : )
  
  Github：https://github.com/IAMAI-Dev/KeepTrack.git
  
  Gitee：https://gitee.com/iiamaii/KeepTrack.git
  
- FIT 文件的生成依赖于 `fit-tool` 库构建 Garmin 协议标准的数据包。

## 📄 许可证

本项目采用 [GPL-3.0 License](LICENSE) 许可证。