go-garminconnect

Go port of the Garmin Connect API client

Overview

This project is a Go port of the Python Garmin Connect API wrapper. It provides programmatic access to Garmin Connect data through a structured Go API.

Getting Started

Prerequisites

Go 1.21+
Docker

Installation

git clone https://github.com/sstent/go-garminconnect
cd go-garminconnect

Building and Running

# Build and run with Docker
cd docker
docker compose up -d --build

# Run tests
go test ./...

Development

See PORTING_PLAN.md for implementation progress and JUNIOR_ENGINEER_GUIDE.md for contribution guidelines.

Project Structure

├── cmd/         - Main application
├── internal/    - Internal packages
│   ├── api/     - API endpoint implementations
│   └── auth/    - Authentication handling
├── docker/      - Docker configuration
└── tests/       - Test files

License

This project is licensed under the MIT License - see the LICENSE file for details.

1.1 KiB Raw Permalink Blame History