waybar-gps(5)

💖 waybar-gps — the manual page, but make it a group chat 💖

okay so bestie. you found the waybar-gps(5) page. this is section 5 of the manual, it's the gps module situation, and we're gonna get through it together because honestly? it's giving iconic GPS widget energy and you deserve to understand every single crumb. 🛰️✨

---

🌸 NAME 🌸

waybar — the gps module. that's it. that's the name. short, sweet, main character. 💅

---

🦋 DESCRIPTION 🦋

it's the gps module for gpsd. yes, fr fr, that's the whole description. it talks to gpsd and gives you the tea about where you are on this big blue marble. 🌍

---

🎀 FILES 🎀

• $XDG_CONFIG_HOME/waybar/config — your per user configuration file. this is where you put your lil config dreams. 🫶

---

✨ ADDITIONAL FILES ✨

so libgps lives in these places, and it's lowkey just vibing in one of them:

1. /usr/lib/libgps.so or /usr/lib64/libgps.so
2. /usr/lib/pkgconfig/libgps.pc or /usr/lib64/pkgconfig/libgps.pc
3. /usr/include/gps

like, pick a lane bestie, but also slay. 🌈

---

💅 CONFIGURATION 💅

okay here's every single knob. do not skip a single one, i will know. 👀

• format — typeof: string, default: {glyph}. the text format. what it even says. 💬
• tooltip — typeof: bool, default: true. option to disable tooltip on hover. if hover popups are too much for you, set this to false, no judgement. 🙈
• tooltip-format — typeof: string, default: Games running: {glyph}. the text format of the tooltip. (yes, Games running: — we do not ask questions, we copy the default exactly. 😭)
• interval — typeof: integer, default: 5. the interval in which the GPS information gets polled (e.g. current speed).
  • heads up: significant updates (e.g. the current fix mode) are updated immediately. so the important stuff is not sitting there marinating in the interval queue. periodt. ⭐
• hide-disconnected — typeof: bool, default: true. defines if the module should be hidden if there is no GPS receiver. default is hide it, because nobody wants to see a ghost. 💀
• hide-no-fix — typeof: bool, default: false. defines if the module should be hidden if there is no GPS fix. default is do show it. 🔥

---

🌟 FORMAT REPLACEMENTS 🌟

these are the little {guys} you can stick in your formats. they're the whole personality of the module, honestly. 🧚

• {mode} — Fix mode.
• {status} — Technology used for GPS fix. not all GPS receivers report this. (rude of them, but okay. 😤)
• {latitude} — Latitude, decimal degrees. can be NaN.
• {latitude_error} — Latitude uncertainty, meters. can be NaN.
• {longitude} — Longitude, decimal degrees. can be NaN.
• {longitude_error} — Longitude uncertainty, meters. can be NaN.
• {altitude_hae} — Altitude, height above ellipsoid, meters. can be NaN.
• {altitude_msl} — Longitude, MSL, meters. can be NaN.
• {altitude_error} — Altitude uncertainty, meters. can be NaN.
• {speed} — Speed over ground, meters/sec. can be NaN.
• {speed_error} — Speed uncertainty, meters/sec. can be NaN.
• {climb} — Vertical speed, meters/sec. can be NaN.
• {climb_error} — Vertical speed uncertainty, meters/sec. can be NaN.
• {satellites_visible} — Number of satellites visible from the GPS receiver. 👀🛰️
• {satellites_used} — Number of satellites used for the GPS fix. the chosen ones. 👑

bestie note: a lot of these can be NaN. that's their business, not ours. don't come for them. 🫶

---

🌈 EXAMPLES 🌈

here is a real one, copy it exactly, character for character, because we are not risking a typo in the group chat:

"gps": {
     "format": "{mode}",
     "format-disabled": "", // an empty format will hide the module
     "format-no-fix": "No fix",
     "format-fix-3d": "{status}",
     "tooltip-format": "{mode}",
     "tooltip-format-no-fix": "{satellites_visible} satellites visible",
     "tooltip-format-fix-2d": "{satellites_used}/{satellites_visible} satellites used",
     "tooltip-format-fix-3d": "Altitude: {altitude_hae}m",
     "hide-disconnected": false
}

look at that comment: an empty format will hide the module. sneaky little trick and it ate. 💅✨

---

💜 STYLE 💜

the CSS classes you can dress up. get in, we're doing glam. 🎀

• #gps
• #gps.disabled — applied when GPS is disabled.
• #gps.fix-none — applied when GPS is present, but there is no fix.
• #gps.fix-2d — applied when there is a 2D fix.
• #gps.fix-3d — applied when there is a 3D fix. the glow-up tier. 👑

---

and that's the whole page, bestie. go forth, configure your gps module, and let it be known that you understood every option. i'm so proud of you. 🌸🦋🎀

this beauty came to you as waybar-gps, dated 2026-02-08, and it's page 5 of the manual (waybar-gps(5)). mwah. 💖