---
name: "gegps"
section: "1"
platform: "linux"
package: "gpsd"
version: "3.27.5-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gegps"
---

# gegps(1)

Google Earth client for gpsd

## NAME

gegps - Google Earth client for gpsd

## SYNOPSIS

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

**gegps** -h

**gegps** -V

## DESCRIPTION

**gegps** program collects fixes from gpsd and feeds them to a running instance of Google Earth for live location tracking.

## OPTIONS

- **-?**, **-h**, **--help**

  Print a summary of options and then exit.

- **-d DIR**, **--kmldir DIR**

  Specify the location of the Google Earth installation directory. If not specified, it defaults to the current directory.

- **-D LVL**, **--debug LVL**

  Sets the debug level; it is primarily for use by GPSD developers. It enables various progress messages to standard error.

- **--device DEVICE**

  Connect to device DEVICE on gpsd host.

- **--host HOST**

  Connect 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...). Run **gegps** in the normal way after that.

- **--port PORT**

  Connect to gpsd on port PORT.

- **-V**, **--version**

  Print the package version and exit.

**gegps** does not require root privileges, it should be run as the same user that your Google Earth client is running as.

## 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)](/gps/1.md) man page

## RETURN VALUES

**0**

on success.

**1**

on failure

## SEE ALSO

[**gpsctl**(1)](/gpsctl/1.md), [**gps**(1)](/gps/1.md), [**gpsprof**(1)](/gpsprof/1.md), fake\*(1), [**gpscat**(1)](/gpscat/1.md), **gps\*gpspipe**(1), [**xgps**(1)](/xgps/1.md). [**xgpsspeed**(1)](/xgpsspeed/1.md)

[**libgps**(3)](/libgps/3.md), [**libgpsmm**(3)](/libgpsmm/3.md)

[**gpsd**(8)](/gpsd/8.md)

## RESOURCES

**Project web site:**  \<https://gpsd.io/\>

## COPYING

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