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)
       •   #gps
       •   #gps.disabled زمانی اعمال می‌شود که GPS غیرفعال باشد.
       •   #gps.fix-none زمانی اعمال می‌شود که GPS در دسترس است، اما موقعیت
           تثبیت نشده باشد.
       •   #gps.fix-2d زمانی اعمال می‌شود که تثبیت دوبعدی (2D fix) وجود داشته
           باشد.
       •   #gps.fix-3d زمانی اعمال می‌شود که تثبیت سه‌بعدی (3D fix) وجود داشته
           باشد.

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