XGPSSPEED(1)                  GPSD Documentation                  XGPSSPEED(1)

NAME
       xgpsspeed - X speedometer for gpsd

SYNOPSIS
       xgpsspeed [OPTIONS] [service[:port[:device]]]

       xgpsspeed -h

       xgpsspeed -V

DESCRIPTION
       xgpsspeed is a speedometer that uses position information from gpsd.

       The default display mode is a speed and track presentation modeled
       after a marine navigation display; for backward compatibility the
       --nautical option forces this mode. The --landspeed option produces a
       simple speedometer.

       The --speedunits option can be used to set the speed units for display;
       follow the keyword with "knots" for nautical miles per hour, "kmh" for
       kilometers per hour, or "mph" for miles per hour. The default is miles
       per hour.

       In the nautical mode only, --maxspeed sets the maximum on the
       speedometer.

       xgpsspeed will run fine as a normal user, and fine as root.  Running
       xgpsspeed under sudo will cause some loss of functionality.

OPTIONS
       -?, -h, --help
           Causes the client to emit a summary of its options and then exit.

       -device DEVICE
           The device on the host to connect to. The default is empty (any).

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

       --host HOST
           The host (server) to connect to. The default is localhost.

       -p PORT, --port PORT
           The port to connect to. The default is 2947.

       -V, --version
           This option causes each client to dump the package version and
           exit.

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

ENVIRONMENT
       The environment variable GPSD_UNITS is checked if no unit system is
       specified on the command line.  It may be set to 'i'. 'imperial', 'm',
       'metric', or 'n', 'nautical'.

       LC_MEASUREMENT and then LANG are checked if no unit system has been
       specified on the command line, or in GPSD_UNITS. If the value is 'C',
       'POSIX', or begins with 'en_US' the unit system is set to imperial. The
       default if no system has been selected defaults to metric.

RETURN VALUES
       0
           on success.

       1
           on failure

SEE ALSO
       gpsd(8), gps(1), xgps(1)

RESOURCES
       Project web site:  <https://gpsd.io/>

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

AUTHORS
       Chen Wei

       Robin Wittler

GPSD, Version 3.25                2023-01-10                      XGPSSPEED(1)