ALFRED-GPSD(8)

📦 version 2026.2, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 ALFRED-GPSD 💖

okay bestie, so this is alfred-gpsd, aka the Alfred GPS distribution server from the alfred-gpsd corner of the Linux manual-verse 🛰️✨

🌸 NAME 🌸

alfred-gpsd — the Alfred GPS distribution server, no cap 🫶

✨ SYNOPSIS ✨

alfred-gpsd [options]

that's it. that's the whole vibe. run it, give it options, watch it slay 💅

🦋 DESCRIPTION 🦋

so like, alfred-gpsd is the girl who spreads the news — but the news is GPS location information, and the group chat is your batman-adv mesh network 🌈

she reads the current location from gpsd, or she'll take a fixed location straight off the command line (yes, you can just hand her coordinates, iconic), and then she distributes that info via alfred. and the way that every alfred-gpsd node gathers its own local info means any node can get location info about all the other nodes 🥰 it's giving community. it's giving mutual aid. it's giving mesh network besties.

🎀 OPTIONS 🎀

  • -v, --version — prints the version, simple as that 💖
  • -h, --help — shows you a lil brief help message 🫶
  • -u, --unix-path path — the path to the unix socket used for talking to the alfred server 🔌
  • -s, --server — starts up in server mode ✨ this server reads the current location from gpsd and sets it in alfred via the unix socket. and heads up bestie, the alfred server has to be running too for this information to actually get set, so don't come for me if you skip that step 💀
  • -l, --location <lat>,<lon>,<alt> — instead of reading the current location from gpsd, just use a fixed location. you're the GPS now, periodt 📍
  • -g, --gpsd server[:port[:device]] — tells her the server hostname and the optional port of where gpsd is listening 👀 and bonus: you can also name a specific device connected to gpsd if you wanna be extra specific 🧚

🌟 EXAMPLES 🌟

start an alfred-gpsd server that's fetching GPS data from the local gpsd:

alfred-gpsd -s

start an alfred-gpsd server with a fixed location:

alfred-gpsd -s -l 48.858222,2.2945,358

and to get a list of GPS locations, in JSON format:

alfred-gpsd
[
  { "source" : "f6:00:48:13:d3:1e", "tpv" : {"class":"TPV","tag":"RMC",
    "device":"/dev/ttyACM0","mode":3,"time":"2013-10-01T10:43:20.000Z",
    "ept":0.005,"lat":52.575485000,"lon":-1.339716667,"alt":122.500,
    "epx":10.199,"epy":15.720,"epv":31.050,"track":0.0000,"speed":0.010,
    "climb":0.000,"eps":31.44} },
  { "source" : "8e:4c:77:b3:65:b4", "tpv" : {"class":"TPV",
    "device":"command line","time":"2013-10-01T10:43:05.129Z",
    "lat":48.858222,"lon":2.2945,"alt":358.000000,"mode":3}
  }
]

look at that JSON. she ate. 🔥

👑 SEE ALSO 👑

alfred(8), gpsd(8) gpsd_json(5) 💜

🍓 AUTHOR 🍓

alfred-gpsd and this Manual page was written by Andrew Lunn <andrew@lunn.ch> — thank you for your service, king 🫡💖

okay that's the whole page bestie, go forth and distribute some locations 🌈🛰️

much love from the Linux girlies 💅 — this page is serving Oct 04, 2013 energy and honestly? timeless. ✨🎀🦋

📦 where this page comes from