Optional importer

Import Garmin runs.
Credentials stay local.

beatledger FIT Importer is a small interactive terminal tool. Choose a date range, pick individual runs, or import new Garmin activities only.

Use the importer as an easier alternative to manual FIT uploads in the app when bringing across history or keeping Garmin runs up to date. It is currently available only for Garmin users.

Read the setup guide Source

1. Install uv. It sets up the importer for you, so you do not need to install Python yourself.
```
brew install uv
```
2. Install the importer.
```
uv tool install beatledger-fit-import
```
3. Start the importer. Follow its prompts to sign in and choose runs.
```
beatledger-fit import
```

1. Install uv. It sets up the importer for you, so you do not need to install Python yourself.
```
winget install --id=astral-sh.uv -e
```
2. Install the importer.
```
uv tool install beatledger-fit-import
```
3. Start the importer. Follow its prompts to sign in and choose runs.
```
beatledger-fit import
```

1. Install uv. It sets up the importer for you, so you do not need to install Python yourself.
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
2. Install the importer.
```
uv tool install beatledger-fit-import
```
3. Start the importer. Follow its prompts to sign in and choose runs.
```
beatledger-fit import
```

What stays local

Your Garmin credentials are entered and stored only on your computer; they are not sent to beatledger. The importer stores its separate beatledger authorization locally so you do not need to sign in every time, and you can revoke it from Account.

Only FIT files you select are uploaded to beatledger. Downloaded files are temporary and removed after upload unless you explicitly choose to keep them.

Need help? Follow the full importer guide or return to the getting-started path.