GPXLOGGER(1)

📦
version 3.27.5 · 9 versions
, in arch rolling, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

👑 GPXLOGGER(1) — the gpxlogger glow-up ✨

okay bestie, welcome to the gpxlogger page from the GPSD Documentation set. she's a little program with big main-character energy and she's about to make your GPS tracks look ✨immaculate✨.

🌸 NAME 🌸

gpxlogger — the tool that links up with gpsd and makes you a GPX file. that's it. that's the job. 💅

🦋 SYNOPSIS 🦋

gpxlogger [OPTIONS] [server[:port[:device]]]

gpxlogger -h

gpxlogger -V

💖 DESCRIPTION 💖

so like, the gpslogger program collects fixes from gpsd and logs them to standard output in GPX format, which is an XML profile for track logging. it does not need to run as root, but she can run as root if that's the vibe. no gatekeeping here. 🫶

the output may be composed of multiple tracks, bestie. a brand new track gets created if there's no fix written for an interval specified by the -i or --interval option — and that interval defaults to 5 seconds. periodt.

gpxlogger can use any of the export methods that gpsd supports. wanna see the whole menu? use the -l or --exports option. and to force a specific method, hand her the -e, --export option followed by one of those colon-terminated method names from the -l, --exports table. iykyk. 🌈

✨ OPTIONS ✨

  • -?, -h, --help — prints a lil summary of all the options and then dips. classic. 👋
  • -d, --daemonize — runs as a daemon in the background, lowkey living her own life. it requires the -f, --output option, which points the output at a specified logfile. no logfile, no daemon era. 🚫
  • -D LVL, --debug LVL — sets the debug level. it's mainly for troubleshooting, and it turns on various progress messages that go to standard error. she's telling you everything, fr fr. 🔍
  • -e METHOD, --export METHOD — if D-Bus support is available on the host, GPSD is configured to use it, and you specify -e dbus or --export dbus, then this program listens to DBUS broadcasts from gpsd via org.gpsd.fix. very demure, very mindful. 🎀

with -e sockets, or if sockets is the method defaulted to, you may give a [server[:port[:device]]] specification as arguments. see the ARGUMENTS section below for the deets. 💅

with -e shm, --export shm, this program will listen to the local gpsd using shared memory. sneaky, fast, iconic. 💨

  • -f OUTFILE, --output OUTFILE — outputs the GPX logg to file OUTFILE instead of to stdout. you may use strftime(3) options in OUTFILE. yes, that means date-stamped filenames, go off. 🗂️
  • -F INFILE, --filein INFILE — reads gpsd JSON from file INFILE instead of from a gpsd daemon. offline mode, she's independent. 🌙
  • -g, --garmin — enables Garmin extensions to the GPX format. this lets depth also be logged in the gpx output. 🚫 NOT compatible with Google maps. pick a lane, bestie.
  • -i SECONDS, --interval SECONDS — a new track is created if there's no fix written for an interval of SECONDS. defaults to 5 seconds. ⏱️
  • -l, --exports — lists all the possible options for -e, --export. window shopping, but make it technical. 🛍️
  • -m MINMOVE, --minmove MINMOVE — sets a minimum move distance in meters (and yes it may include a fractional decimal part, she's precise like that). motions shorter than this will not be logged. if you're not moving, you're not in the file. 🚶♀️
  • -r, --reconnect — retries when GPSd loses the fix. without -r, gpxlogger would just quit in this case. she's sensitive like that. 😭
  • -V, --version — dumps the package version and exits. showing off, deservedly. 👑

🌈 ARGUMENTS 🌈

by default, clients collect data from the local gpsd daemon running on localhost, using the default GPSD port 2947. the optional argument to any client may override this behavior:

[server[:port[:device]]]

for further explanation, and examples, see the ARGUMENTS section in the gps(1) man page. go read it, bestie, it's giving homework but it's worth it. 📚

💀 RETURN VALUES 💀

  • 0 — on success. slay. 💖
  • 1 — on failure. it's giving flop, but we recover. 😭
Note spxlogger sends error messages to the system log, not to stderr. so if you're staring at your terminal wondering why she's silent... she's not silent, she's just journaling elsewhere. 🙈

🎀 EXAMPLES 🎀

to daemonize, and output the gpx log to a date stamped filename:

$ gpxlogger -d -f "out-%c.gpx"

go forth and log. 🌟

🔥 SEE ALSO 🔥

⭐ RESOURCES ⭐

project web site: https://gpsd.io/ — the mothership, the main hub, the source. 🛸

💜 COPYING 💜

this file is Copyright 2013 by the GPSD project.

SPDX-License-Identifier: BSD-2-clause

🧚 AUTHORS 🧚

  • Amaury Jacquot
  • Petter Reinholdtsen
  • Chris Kuethe

and that's the whole page, bestie!! 💖 this was GPSD, Version 3.27.5, dated 2025-11-04 — the GPXLOGGER(1) manual page, brought to you with love and zero skipped options. now go log some tracks. 🌸🦋✨

📦 where this page comes from