gnss-share.conf(5)

💖 gnss-share.conf — the manual page, but make it cute 💖

okay bestie, welcome to gnss-share.conf(5) — yeah it's a file format manual, but it's OUR file format manual now 🫶

---

✨ DESCRIPTION ✨

gnss-share.conf is where all the config for gnss-share lives. It's giving settings app but make it text file. The format is TOML — so yeah, key = value vibes, keys and strings, that whole situation. 🌸

---

🎀 OPTIONS 🎀

one bullet per option, no skipping, no summarising, we respect every single one in this house 👑

• socket="<path>" — the socket where NMEA location data gets sent, e.g. "/var/run/gnss-share.sock". it's literally the little mailbox your coordinates get dropped into 💌
• group="<string>" — the group you want set as owner of that socket. so the right people can come in, and the wrong people can't, periodt 🔐
• device_driver="<string>" — which GPS device driver to use. supported values are: stm, stm_serial, mm (that's for the ModemManager D-Bus interface, iykyk). pick your fighter ⭐
• device_path="<string>" — the path to the GPS device you're using, e.g. "/dev/gnss0". point her at the goods 📍
• device_baud_rate=<int> — baud rate for your GPS serial device, e.g. "9600". heads up though: this one only gets used if the device driver uses a serial interface. so if you're not on serial, this setting is just sitting there, main character with no scenes 😭
• agps_directory="<path>" — the directory to load and store almanac and ephemeris data. the vibes archive, the memory of the sky 🦋

---

🌈 SEE ALSO 🌈

• gnss-share(1) — go read her too, she's iconic fr fr

---

👑 AUTHORS 👑

Clayton Craft <clayton@craftyguy.net> — the legend who made this, we stan 💜

---

ok so that's the whole page, no notes 💅 this was the gnss-share.conf file formats manual, dated 2026-01-20 — ty for coming to my TED talk, go configure your GPS bestie, slay 🎀✨🦋