GEGPS(1)

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

💖 GEGPS(1) — the gpsd manual, but make it cute 💖

okay bestie, welcome to gegps, the Google Earth client for gpsd. it's from the GPSD docs, and yes we're doing this whole thing together, no skimming, no "tl;dr" (iykyk).

✨ NAME ✨

gegps — Google Earth client for gpsd 🦋

🌸 SYNOPSIS 🌸

gegps [OPTIONS] [server[:port[:device]]]

gegps -h

gegps -V

👑 DESCRIPTION 👑

so the gegps program literally collects fixes from gpsd and feeds them straight into a running instance of Google Earth, for live location tracking. that's it, that's the whole vibe. you, on a map, in real time. main character energy fr fr. 🌈

💅 OPTIONS 💅

  • -?, -h, --help — prints a lil summary of the options and then dips. that's it. ✨
  • -d DIR, --kmldir DIR — tells it where your Google Earth installation directory lives. if you don't say anything, it just defaults to the current directory. no biggie. 🎀
  • -D LVL, --debug LVL — sets the debug level. this one is primarily for the GPSD developers, and it turns on various progress messages that go to standard error. it's giving "for the engineers only" 💀
  • --device DEVICE — connects to device DEVICE on the gpsd host. 🫶
  • --host HOST — connects to gpsd on host HOST. 🌸
  • -i, --initialize — if you have the free (non-subscription) version, start by running with the -i option to drop a clue in the Google Earth installation directory, as 'Open_in_Google_Earth_RT_GPS.kml', then open that file in Places (File > Open...). after that, run gegps in the normal way. yes this is a whole ritual, do it in order bestie 🙈
  • --port PORT — connects to gpsd on port PORT. ⭐
  • -V, --version — prints the package version and exits. iconic.

also super important: gegps does not require root privileges. it should be run as the same user that your Google Earth client is running as. same user, same energy, no sudo nonsense. 💜

🧚 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. 👑

🌟 RETURN VALUES 🌟

  • 0 — on success. slay. 🎉
  • 1 — on failure. 😭

🦋 SEE ALSO 🦋

gpsctl(1), gps(1), gpsprof(1), fake*(1), gpscat(1), gps*gpspipe(1), xgps(1). xgpsspeed(1)

libgps(3), libgpsmm(3)

gpsd(8)

🌈 RESOURCES 🌈

Project web site: https://gpsd.io/ — go look, it's giving documentation 💖

💖 COPYING 💖

This file is Copyright 2013 by the GPSD project SPDX-License-Identifier: BSD-2-clause

okay that's the whole page, no cap, every single flag and file and number accounted for. now go track yourself on a globe like the icon you are 💅

GPSD Version 3.27.5 · 2025-11-04 — mwah, that's the version and the date, love u, bye bestie 🎀✨

📦 where this page comes from