This program is a straightforward gps monitor program using the GTK+ 4 windowing system.

It is copyright 2009 to the date of the most recent modification Charles Curley, http://www.charlescurley.com/

This program is released under the same terms as gpsd itself, i.e. under the BSD License. See the file Copying in the gpsd distribution.

There isn't much to it, so these notes should suffice:

• The background changes color according to the quality of the fix.

  • Grey: No GPSD connection.

  • Red: No fix.

  • Yellow: Two dimensional fix, i.e. altitude is invalid.

  • Green: Three dimensional fix.

• The number of satellites seen and used in fixes is shown in a progress bar, where the progress bar shows the ratio of the two.

• You can change how some of the data are displayed, e.g. speed in miles per hour, knots or kilometers per hour; magnetic vs. true; local vs. GMT, etc. You can then save these settings.

• Menu functions have accelerator (shortcut) keys.

• For automotive use, try a fairly large font, e.g. 17 to 25 points.

Command line options. You may also set and save these in the GUI. These override the defaults and saved values.

-d Set the format of the latitude and longitude display:

• d: Degrees and decimal, ddd.dddddd

• m: Degrees and minutes, ddd mm.mmmm

• s: Degrees, minutes, seconds, ddd mm ss.ss

-e Track/heading will be reported as magnetic

-g GMT time.

-h Print a terse help message.

-H Altitude is relative to Height Above Ellipsoid (HAE)

-k Speed in knots

-l Local time

-m Metric measures

-M Altitude is relative to Mean Sea Level (MSL)

-p Port (default is 2947)

-t Track/heading will be reported as true

-u US measures

-v Verbose (print to stdout)

-V Print much more verbose help

To compile, you should get everything you need with:

apt install gcc libgps-dev libgtk-4-dev make

There is a make target "validate". This is set up to run astyle so you can have a suitable style in your contributions (hint, hint...). You will need astyle if you don't already have it. It will also validate the desktop file, which requires the package desktop-file-utils.

apt install astyle desktop-file-utils