XGPSSPEED(1)

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

✨ XGPSSPEED(1) ✨

okay so this is a page from the GPSD Documentation set, and bestie, it's literally the manual for xgpsspeed. Buckle up 🎀

🌸 NAME 🌸

xgpsspeed — an X speedometer for gpsd 💅

🦋 SYNOPSIS 🦋

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

xgpsspeed -h

xgpsspeed -V

✨ DESCRIPTION ✨

xgpsspeed is a speedometer that pulls position info straight from gpsd. It's giving dashboard energy fr fr 🏎️

The default display mode is a speed and track presentation modeled after a marine navigation display — and for backward compatibility, the --nautical option forces this mode. The --landspeed option produces a simple speedometer instead. So you can go nautical main character OR plain and simple, your call 💖

The --speedunits option is how you 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. Note the "only" — it's not doing anything in land mode, bestie.

xgpsspeed will run fine as a normal user, and fine as root. But running xgpsspeed under sudo will cause some loss of functionality. 🙈 So like, don't do that.

💅 OPTIONS 💅

  • -?, -h, --help — Causes the client to emit a summary of its options and then exit. Iconic, quick, done.
  • -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. Slay, short and sweet.

🧚 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, it's worth it 🫶

🌸 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. So like, it's a whole vibe check cascade 💫

🔥 RETURN VALUES 🔥

  1. 0 — on success. 🎉
  2. 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

and that's the whole page bestie, no cap 🫶

GPSD, Version 3.27.5 — dated 2025-11-04 ⭐ Periodt. 💅

📦 where this page comes from