ANT-FS Command Line Interface 使用教程

ANT-FS Command Line Interface 使用教程

antfs-cliExtracts FIT files from ANT-FS based sport watches such as Garmin Forerunner 60, 405CX, 310XT, 610 and 910XT.项目地址:https://gitcode.com/gh_mirrors/an/antfs-cli

1. 项目的目录结构及介绍

ANT-FS Command Line Interface（以下简称 antfs-cli）是一个用于从ANT-FS设备（如Garmin Forerunner 60、405CX、310XT、610和910XT）中提取FIT文件的工具。以下是项目的目录结构及其介绍：

antfs-cli/
├── github/workflows/
│   └── antfs_cli.yml
├── scripts/
│   └── ...
├── tests/
│   └── ...
├── .gitignore
├── LICENSE
├── README.md
├── SCRIPTING.md
├── pyproject.toml
├── requirements.txt
└── setup.py

• github/workflows/: 包含GitHub Actions的工作流配置文件。
• scripts/: 包含一些辅助脚本。
• tests/: 包含测试脚本。
• .gitignore: Git忽略文件配置。
• LICENSE: 项目许可证。
• README.md: 项目说明文档。
• SCRIPTING.md: 脚本编写指南。
• pyproject.toml: 项目配置文件。
• requirements.txt: 项目依赖文件。
• setup.py: 项目安装脚本。

2. 项目的启动文件介绍

项目的启动文件是 setup.py。该文件用于安装ANT-FS Command Line Interface。安装命令如下：

sudo python setup.py install

安装完成后，会在 /usr/bin 或类似目录下生成 antfs-cli 可执行文件。

3. 项目的配置文件介绍

项目的配置文件主要涉及两个部分：

3.1. 环境变量配置

根据XDG Base Directory规范，FIT文件和auth文件存储在 $XDG_CONFIG_HOME 指定的目录中，如果没有设置该环境变量，则使用 $HOME/config 作为备份目录。在该目录下会创建一个 antfs-cli 文件夹，每个设备对应一个文件夹，FIT文件和auth文件存储在设备特定的文件夹中。

3.2. 上传配置

如果需要将活动文件上传到Garmin Connect，需要配置上传依赖项并设置Garmin Connect的凭证。具体步骤如下：

1. 安装上传依赖项：

   sudo pip install antfs-cli[upload]
   

2. 在 ~/guploadrc 文件中设置Garmin Connect的凭证：

   [Credentials]
   username=yourgarminuser
   password=yourgarminpass
   

通过以上配置，可以实现自动上传活动文件到Garmin Connect。

---

以上是ANT-FS Command Line Interface的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助。

antfs-cliExtracts FIT files from ANT-FS based sport watches such as Garmin Forerunner 60, 405CX, 310XT, 610 and 910XT.项目地址:https://gitcode.com/gh_mirrors/an/antfs-cli