waybar-gps - Man Page

gps module

Description

gps module for gpsd.

Files

$XDG_CONFIG_HOME/waybar/config
Per user configuration file

Additional Files

libgps lives in:

  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

Configuration

format:
typeof: string
default: {glyph}
The text format.

tooltip:
typeof: bool
default: true
Option to disable tooltip on hover.

tooltip-format:
typeof: string
default: Games running: {glyph}
The text format of the tooltip.

interval:
typeof: integer
default: 5
The interval in which the GPS information gets polled (e.g. current speed).

Significant updates (e.g. the current fix mode) are updated immediately.

hide-disconnected:
typeof: bool
default: true
Defines if the module should be hidden if there is no GPS receiver.

hide-no-fix:
typeof: bool
default: false
Defines if the module should be hidden if there is no GPS fix.

Format Replacements

{mode}: Fix mode

{status}: Technology used for GPS fix. Not all GPS receivers report this.

{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.

Examples

  "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
  }

Style

Info

2025-06-23 User Manual