LCDGPS(1)

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

💅 LCDGPS(1) — the lcdgps manual, bestie edition 🎀

okay so you opened the manual for lcdgps from the GPSD Documentation set, and honestly? it's giving "tiny screen, big dreams". let's get into it ✨

✨ NAME ✨

lcdgps — LCD client for gpsd 🖥️💖

🌸 SYNOPSIS 🌸

like. three whole ways to summon it. pick your fighter 💅

🦋 DESCRIPTION 🦋

so lcdgps is a client, right? it takes gpsd data and passes it straight to lcdproc, which turns your car computer into a very expensive and nearly feature-free GPS receiver 😭 iconic honestly. no cap.

right now it assumes a 4x40 LCD and writes the data formatted to fit exactly that size of screen. so if your screen is not that, that's a you problem bestie. it also displays 4- or 6-character Maidenhead grid square output 🌈 — yes, the grid squares, we love a coordinate system moment.

lcdgps does not require root privileges. it will also run fine as root, no drama. BUT — and this is the important part — running under sudo will cause loss of functionality 💀 so like. don't. fr fr.

⚠️ note to self: sudo is NOT the vibe here. it literally breaks stuff. just say no 🙈

💖 OPTIONS 💖

  • -?, -h, --help — prints a summary of all the options and then dips out. exit stage left, periodt.
  • -s, --sleep — takes a little nap for 10 seconds before starting. beauty sleep. main character needs her rest 😴✨
  • -V, --version — prints the package version and exits. show me the numbers bestie 👑

🌈 ARGUMENTS 🌈

by default, clients (yes, all of them) collect data from the local gpsd daemon chillin' on localhost, using the default GPSD port 2947. that's just the standard setup, no thoughts needed.

but if you wanna override that behavior, any client takes an optional argument shaped like this:

and for further explanation plus examples, go read the ARGUMENTS section over in the gps(1) man page. it's all there, iykyk 📖

🧚 ENVIRONMENT 🧚

the environment variable GPSD_UNITS gets checked if no unit system was specified on the command line. it may be set to 'i', 'imperial', 'm', 'metric', or 'n', 'nautical'. pick your flavor of measurement, bestie 📏

then LC_MEASUREMENT and then LANG get 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 gets set to imperial. and the default — if no system has been selected at all — defaults to metric. slay.

⭐ RETURN VALUES ⭐

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

short. simple. no notes.

👑 SEE ALSO 👑

the whole friend group:

cgps(1), gegps(1), gpsctl(1), gps(1), gpsprof*(1), gpsfake(1), gpscat(1), gpspipe(1), xgps*(1). xgpsspeed(1)

libgps(3), libgpsmm(3)

gpsd(8)

🔥 RESOURCES 🔥

project web site: https://gpsd.io/ — go, click, absorb 🌐✨

🎀 COPYING 🎀

this file is Copyright 2013 by the GPSD project

SPDX-License-Identifier: BSD-2-clause

respect the license bestie, it's the rules 🫶

and that's the whole page!! mwah 💋 this was GPSD Version 3.27.5, dated 2025-11-04, and it's the LCDGPS(1) manual — thanks for reading, love u, bye 💖🦋🌸

📦 where this page comes from