---
name: "garmin_save_runs"
section: "1"
platform: "linux"
package: "garmin-forerunner-tools"
version: "0.10repacked-16"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/garmin_save_runs"
---

# garmin\_save\_runs(1)

retrieve track logs from a Forerunner device.

## NAME

garmin\_save\_runs - retrieve track logs from a Forerunner device.

## SYNOPSIS

**garmin\_save\_runs**

**garmin\_save\_runs** retrieves track logs from a Garmin Forerunner device connected to an USB port, and saves the information into files. Files are saved with the extension ".gmn" and are named by the run start time (e.g. '20070121T151814.gmn').  The .gmn file format is a binary file format that can be unpacked with he **garmin\_dump** or **garmin\_gmap** utilities.  It is substantially more efficient than the bloated XML format that Garmin uses.

The output of garmin\_save\_runs will tell you where on your filesystem the actual .gmn files were saved.  The default is to save them in a directory tree (by year and month) under the current directory.  You can override this by setting the environment variable GARMIN\_SAVE\_RUNS to whatever directory you like. Existing files are not overwritten.

## SEE ALSO

[**garmin\_get\_info**(1)](/garmin_get_info/1.md), [**garmin\_dump**(1)](/garmin_dump/1.md), [**garmin\_gmap**(1)](/garmin_gmap/1.md).\

## AUTHOR

garmin\_save\_runs was written by Dave Bailey.