garmin-tracker-rs

KO | EN

gitlite — search

#javascript #react #typescript #llm #golang #deep-learning #linux #docker #nodejs #windows #cli #security #ios #mcp

garmin-tracker-rs

(★ 15)

No description available.

garmin-tracker-rs Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Garmin Tracker

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Emiliopg91/garmin-tracker-rs)

**Sync your Garmin devices and track your strength training — all in one desktop app.**

Garmin Tracker is a cross-platform desktop application built with [Tauri](https://tauri.app/), combining a Rust backend with a React + TypeScript frontend. It connects to Garmin watches over USB (MTP), imports your activity `.FIT` files, and stores your sessions, exercises, and body measurements in a local SQLite database — no cloud account required.

## Screenshots

| ![Screenshot 1](https://raw.githubusercontent.com/Emiliopg91/garmin-tracker-rs/main/resources/screenshots/screenshot1.png) | ![Screenshot 2](https://raw.githubusercontent.com/Emiliopg91/garmin-tracker-rs/main/resources/screenshots/screenshot2.png) |
| :----------------------------------------------------: | :----------------------------------------------------: |
| ![Screenshot 3](https://raw.githubusercontent.com/Emiliopg91/garmin-tracker-rs/main/resources/screenshots/screenshot3.png) | ![Screenshot 4](https://raw.githubusercontent.com/Emiliopg91/garmin-tracker-rs/main/resources/screenshots/screenshot4.png) |
| ![Screenshot 5](https://raw.githubusercontent.com/Emiliopg91/garmin-tracker-rs/main/resources/screenshots/screenshot5.png) |

## Features

- **Device sync over USB (MTP)** — Detects connected Garmin devices and downloads new activities directly from the watch's storage.
- **Manual import** — Import activity files from disk if you prefer not to connect a device.
- **`.FIT` file parsing** — Parses Garmin `.FIT` activity files into structured session and series data.
- **Strength training tracking** — Review/edit recorded sessions and their series (sets, reps, weight, etc.).
- **Body measurements** — Log and track user body measures over time.
- **Local database** — All data is persisted in a local SQLite database (schema managed via versioned DDL migrations, applied automatically at startup).
- **Desktop notifications** — Native, localized (English/Spanish) notifications for background events (e.g. device connected/disconnected, sync completed, update available).
- **Single instance** — Prevents multiple copies of the app from running at once, avoiding database corruption.
- **Rotating file logs** — Structured, leveled logging to disk with automatic rotation.

## Tech stack

| Layer                | Technology                                                                                                 |
| -------------------- | ---------------------------------------------------------------------------------------------------------- |
| Shell                | [Tauri 2](https://tauri.app/)                                                                              |
| Backend              | Rust (2024 edition)                                                                                        |
| Frontend             | React 19 + TypeScript, Vite, React Bootstrap, Recharts                                                     |
| Database             | SQLite, via [`rusqlite_orm`](https://crates.io/crates/rusqlite_orm) (custom ORM crate)                     |
| Backend <-> frontend | Typed IPC — TypeScript client/models auto-generated from the Rust `dto`/`logic` code via `tauri-rs-ts-ipc` |
| Codegen              | In-repo proc-macro crate `garmin-tracker-rs-macros` — command call tracing/logging, compile-time i18n      |
| Packaging            | Arch Linux `PKGBUILD`                                                                                      |

## Installation

### Arch Linux (via `AUR helper`/`PKGBUILD`)

Install the AUR `garmin-tracker-rs` package to get latest stable version of the application and every external dependency.

### From source

Requirements: [Rust](https://www.rust-lang.org/tools/install), [pnpm](https://pnpm.io/), and the [Tauri prerequisites](https://tauri.app/start/prerequisites/) for your platform.

```bash
git clone https://github.com/Emiliopg91/garmin-tracker-rs.git
cd garmin-tracker-rs
pnpm install
make build       # or: pnpm tauri build
```

## Development

```bash
pnpm install
make run          # runs the app in dev mode
```

Development builds use [`mold`](https://github.com/rui314/mold) as the linker and [`sccache`](https://github.com/mozilla/sccache) for compilation caching to speed up iteration; install both for the best experience (or adjust the `Makefile` if you don't have them).

Other useful commands (see the `Makefile`):

| Command                | Description                                                                                             |
| ---------------------- | ------------------------------------------------------------------------------------------------------- |
| `make run`             | Start the app in development mode                                                                       |
| `make build`           | Build a release bundle                                                                                  |
| `make lint`            | Lint frontend (ESLint + `tsc`) and backend (`cargo clippy` for both `src-tauri` and `src-tauri-macros`) |
| `make clean`           | Remove `node_modules`, `dist`, and Rust build artifacts                                                 |
| `make setup-toolchain` | Install build dependencies declared in `PKGBUILD` via `paru`                                            |
| `make update`          | Update project dependencies                                                                             |
| `make release`         | Cut a new release                                                                                       |
| `make publish`         | Publish a release                                                                                       |

## Project structure

```
resources/
  ddl/                    Versioned SQL schema migrations, embedded at build time
  translations.yaml       Source strings for localized notifications (en/es)
  scripts/                Python helper scripts (release/versioning/dependency management)
  PKGBUILD, *.rules       Linux packaging assets
src/                      React + TypeScript frontend
  components/             UI screens (App, Exercises, Sessions, User, Workouts, NavBar, Loading)
  context/                React context/providers
  utils/backend/          Auto-generated Tauri IPC client and models (do not edit manually)
src-tauri/                Rust backend (Tauri application)
  src/dao/                SQLite access layer (devices, exercises, heart rate, series, sessions, users)
  src/dto/                Data transfer objects shared with the frontend (via generated TS types)
  src/logic/               Business logic backing the Tauri commands (app, devices, exercises,
                           notifications, sessions, user, workouts)
  src/mtp/                Garmin device discovery & activity download over MTP/USB
  src/parser/              .FIT file parsing
  src/utils/               Shared constants and date/time helpers
src-tauri-macros/         Proc-macro crate: command tracing/logging and compile-time translations
```

## License

Distributed under the GPL-2.0 license, as declared in the project's `PKGBUILD`.

garmin-tracker-rs

garmin-tracker-rs Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

garmin-tracker-rs

garmin-tracker-rs Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README