waybar-gps(5)                     User Manual                    waybar-gps(5)

<?><?><?> (NAME)
       waybar-gps - <?><?><?><?><?> GPS <?><?><?><?> waybar

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> gps <?><?><?><?> gpsd.

<?><?><?><?><?><?><?> (FILES)
       $XDG_CONFIG_HOME/waybar/config
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?>

<?><?><?><?><?><?><?><?> <?><?><?><?><?> (ADDITIONAL FILES)
       <?><?><?><?><?><?><?><?> libgps <?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?>:

       1.  /usr/lib/libgps.so <?><?> /usr/lib64/libgps.so
       2.  /usr/lib/pkgconfig/libgps.pc <?><?> /usr/lib64/pkgconfig/libgps.pc
       3.  /usr/include/gps

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       format:
       <?><?><?>: string
       <?><?><?><?><?><?><?>: {glyph}
       <?><?><?><?> <?><?><?>.

       tooltip:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: true
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> (tooltip)
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?>.

       tooltip-format:
       <?><?><?>: string
       <?><?><?><?><?><?><?>: Games running: {glyph}
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>.

       interval:
       <?><?><?>: integer
       <?><?><?><?><?><?><?>: 5
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> GPS (<?><?><?><?><?> <?><?><?><?> <?><?><?><?>).
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
           (<?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>)
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       hide-disconnected:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: true
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> GPS<?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?>.

       hide-no-fix:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> GPS (<?><?><?> <?><?><?><?> fix)<?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (FORMAT REPLACEMENTS)
       {mode}: <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> (Fix mode).

       {status}: <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> GPS. <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> GPS <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       {latitude}: <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?> NaN
       <?><?><?><?>.

       {latitude_error}: <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>.
       <?><?><?><?><?><?><?><?> NaN <?><?><?><?>.

       {longitude}: <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?> NaN
       <?><?><?><?>.

       {longitude_error}: <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>.
       <?><?><?><?><?><?><?><?> NaN <?><?><?><?>.

       {altitude_hae}: <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> (HAE)<?> <?><?> <?><?><?>.
       <?><?><?><?><?><?><?><?> NaN <?><?><?><?>.

       {altitude_msl}: <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> (MSL)<?> <?><?> <?><?><?>. <?><?><?><?><?><?><?><?> NaN
       <?><?><?><?>.

       {altitude_error}: <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?>. <?><?><?><?><?><?><?><?> NaN <?><?><?><?>.

       {speed}: <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?>. <?><?><?><?><?><?><?><?> NaN <?><?><?><?>.

       {speed_error}: <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?><?><?><?>. <?><?><?><?><?><?><?><?> NaN
       <?><?><?><?>.

       {climb}: <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?>. <?><?><?><?><?><?><?><?> NaN <?><?><?><?>.

       {climb_error}: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?>.
       <?><?><?><?><?><?><?><?> NaN <?><?><?><?>.

       {satellites_visible}: <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> GPS.

       {satellites_used}: <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> GPS.

<?><?><?><?><?><?><?> (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)
       o   #gps
       o   #gps.disabled <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> GPS <?><?><?><?><?><?><?> <?><?><?><?>.
       o   #gps.fix-none <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> GPS <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
       o   #gps.fix-2d <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?> (2D fix) <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.
       o   #gps.fix-3d <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> (3D fix) <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.

waybar-gps                        2026-08-31                     waybar-gps(5)