.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "waybar\-gps" "5" "2026\-08\-31" "waybar\-gps" "User Manual"
.PP
.SH "نام (NAME)"
.PP
waybar\-gps \- ماژول GPS برای waybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBgps\fR برای gpsd.\&
.PP
.PP
.SH "فایل‌ها (FILES)"
.PP
$XDG_CONFIG_HOME/waybar/config
.br
فایل پیکربندی اختصاصی کاربر
.PP
.SH "فایل‌های اضافی (ADDITIONAL FILES)"
.PP
کتابخانه libgps در مسیرهای زیر قرار دارد:
.PP
.PD 0
.IP 1. 4
/usr/lib/libgps.\&so یا /usr/lib64/libgps.\&so
.IP 2. 4
/usr/lib/pkgconfig/libgps.\&pc یا /usr/lib64/pkgconfig/libgps.\&pc
.IP 3. 4
/usr/include/gps
.PD
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
\fBformat\fR:
.br
نوع: string
.br
پیش‌فرض: {glyph}
.br
قالب متن.\&
.PP
\fBtooltip\fR:
.br
نوع: bool
.br
پیش‌فرض: true
.br
گزینه‌ای برای غیرفعال کردن راهنمای شناور (tooltip) هنگام رفتن ماوس روی آن.\&
.PP
\fBtooltip\-format\fR:
.br
نوع: string
.br
پیش‌فرض: Games running: {glyph}
.br
قالب متنی راهنمای شناور.\&
.PP
\fBinterval\fR:
.br
نوع: integer
.br
پیش‌فرض: 5
.br
بازه زمانی برای دریافت اطلاعات GPS (مانند سرعت فعلی).\&
.RS 4
به‌روزرسانی‌های مهم (مانند حالت تثبیت فعلی) بلافاصله اعمال می‌شوند.\&
.PP
.RE
\fBhide\-disconnected\fR:
.br
نوع: bool
.br
پیش‌فرض: true
.br
تعیین می‌کند که در صورت عدم وجود گیرنده GPS، آیا ماژول پنهان شود یا خیر.\&
.PP
\fBhide\-no\-fix\fR:
.br
نوع: bool
.br
پیش‌فرض: false
.br
تعیین می‌کند که در صورت عدم تثبیت موقعیت GPS (عدم وجود fix)، آیا ماژول پنهان شود یا خیر.\&
.PP
.SH "جایگزین‌های قالب (FORMAT REPLACEMENTS)"
.PP
\fB{mode}\fR: حالت تثبیت موقعیت (Fix mode).\&
.PP
\fB{status}\fR: فناوری استفاده‌شده برای تثبیت موقعیت GPS.\& همه گیرنده‌های GPS این مقدار را گزارش نمی‌کنند.\&
.PP
\fB{latitude}\fR: عرض جغرافیایی، به درجه اعشاری.\& می‌تواند NaN باشد.\&
.PP
\fB{latitude_error}\fR: میزان خطای عرض جغرافیایی، به متر.\& می‌تواند NaN باشد.\&
.PP
\fB{longitude}\fR: طول جغرافیایی، به درجه اعشاری.\& می‌تواند NaN باشد.\&
.PP
\fB{longitude_error}\fR: میزان خطای طول جغرافیایی، به متر.\& می‌تواند NaN باشد.\&
.PP
\fB{altitude_hae}\fR: ارتفاع، بر فراز بیضوی مبنا (HAE)، به متر.\& می‌تواند NaN باشد.\&
.PP
\fB{altitude_msl}\fR: ارتفاع از سطح متوسط دریا (MSL)، به متر.\& می‌تواند NaN باشد.\&
.PP
\fB{altitude_error}\fR: میزان خطای ارتفاع، به متر.\& می‌تواند NaN باشد.\&
.PP
\fB{speed}\fR: سرعت زمینی، به متر بر ثانیه.\& می‌تواند NaN باشد.\&
.PP
\fB{speed_error}\fR: میزان خطای سرعت، به متر بر ثانیه.\& می‌تواند NaN باشد.\&
.PP
\fB{climb}\fR: سرعت عمودی، به متر بر ثانیه.\& می‌تواند NaN باشد.\&
.PP
\fB{climb_error}\fR: میزان خطای سرعت عمودی، به متر بر ثانیه.\& می‌تواند NaN باشد.\&
.PP
\fB{satellites_visible}\fR: تعداد ماهواره‌های قابل مشاهده برای گیرنده GPS.\&
.PP
\fB{satellites_used}\fR: تعداد ماهواره‌های استفاده‌شده برای تثبیت موقعیت GPS.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"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
}
.fi
.RE
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#gps\fR
.IP \(bu 4
\fB#gps.\&disabled\fR زمانی اعمال می‌شود که GPS غیرفعال باشد.\&
.IP \(bu 4
\fB#gps.\&fix\-none\fR زمانی اعمال می‌شود که GPS در دسترس است، اما موقعیت تثبیت نشده باشد.\&
.IP \(bu 4
\fB#gps.\&fix\-2d\fR زمانی اعمال می‌شود که تثبیت دوبعدی (2D fix) وجود داشته باشد.\&
.IP \(bu 4
\fB#gps.\&fix\-3d\fR زمانی اعمال می‌شود که تثبیت سه‌بعدی (3D fix) وجود داشته باشد.\&