Garmin / macOS

Workout

Write workouts as plain text. Push them to your Garmin watch.

What it does

Workout is an open-source command-line tool for macOS. You write training sessions in plain Markdown files, validate them locally, and push them to a connected Garmin device as structured workouts.

It supports running, cycling, and strength workouts with pace, heart rate, power, cadence, and load targets, interval repeat blocks, and superset grouping for strength sessions. Generated files use the official Garmin FIT SDK and have been tested on a Forerunner 255 Music.

A training plan format lets you assign workouts to named days and push an entire week to the watch in one command.

macOS Open source Garmin FIT Garmin Training API — pending

Review information

Developer: Dubar.com / Roger Dubar
Contact: roger@dubar.com
Purpose: plain-text workout authoring and structured workout delivery to Garmin devices
Platform: macOS command-line tool (Python)
Distribution: open source
Support: support page
Privacy: app-specific policy

Example workout

# Interval Run

sport: run
target: 40m

## Warmup
- 10m easy @ hr 120-140

## Main
- 6 x:
  - 400m hard @ pace 4:20-4:35/km
  - 90s easy

## Cooldown
- 8m easy

Status

The tool is in active personal use. FIT file export and direct MTP transfer to a Forerunner 255 Music are working. Garmin Training API integration is planned, pending developer program access.