.\" 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\-upower" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar\-upower \- ماژول upower در waybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBupower\fR ظرفیت باتری اصلی را به همراه تمام دستگاه‌های سازگار با upower در راهنمای شناور (tooltip) نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
\fBnative\-path\fR:
.br
نوع: string
.br
پیش‌فرض:
.br
باتری مورد نظر برای پایش.\& به https://upower.\&freedesktop.\&org/docs/UpDevice.\&html#UpDevice\-\-native\-path مراجعه کنید.\&
.br
می‌توان آن را با استفاده از `upower \-\-dump` به دست آورد.\&
.PP
\fBmodel\fR:
.br
نوع: string
.br
پیش‌فرض:
.br
باتری مورد نظر برای پایش، بر اساس مدل.\& (در صورت ارائه \fBnative\-path\fR، این گزینه نادیده گرفته می‌شود).\&
.br
می‌توان آن را با استفاده از `upower \-\-dump` به دست آورد.\&
.PP
\fBicon\-size\fR:
.br
نوع: integer
.br
پیش‌فرض: 20
.br
اندازه آیکون‌ها را تعیین می‌کند.\&
.PP
\fBformat\fR:
.br
نوع: string
.br
پیش‌فرض: {percentage}
.br
قالب متن.\&
.PP
\fBformat\-alt\fR:
.br
نوع: string
.br
پیش‌فرض: {percentage} {time}
.br
قالب متن در هنگام تغییر وضعیت (toggle).\&
.PP
\fBhide\-if\-empty\fR:
.br
نوع: bool
.br
پیش‌فرض: true
.br
نمایش یا عدم نمایش ماژول را در صورتی که هیچ دستگاهی یافت نشود، تعیین می‌کند.\&
.PP
\fBtooltip\fR:
.br
نوع: bool
.br
پیش‌فرض: true
.br
گزینه‌ای برای غیرفعال کردن راهنمای شناور (tooltip) هنگام رفتن نشانگر روی آن.\&
.PP
\fBtooltip\-spacing\fR:
.br
نوع: integer
.br
پیش‌فرض: 4
.br
فاصله بین نام دستگاه در راهنمای شناور و وضعیت باتری دستگاه را تعیین می‌کند.\&
.PP
\fBtooltip\-padding\fR:
.br
نوع: integer
.br
پیش‌فرض: 4
.br
فاصله بین لبه پنجره راهنمای شناور و محتوای راهنمای شناور را تعیین می‌کند.\&
.PP
\fBon\-click\fR:
.br
نوع: string
.br
دستوری که هنگام کلیک روی ماژول اجرا می‌شود.\&
.PP
\fBshow\-icon\fR:
.br
نوع: bool
.br
پیش‌فرض: true
.br
گزینه‌ای برای غیرفعال کردن آیکون باتری.\&
.PP
\fBmenu\fR:
.br
نوع: string
.br
عملیاتی که منو را نمایان می‌سازد (popup).\&
.PP
\fBmenu\-file\fR:
.br
نوع: string
.br
محل فایل توصیف‌کننده منو.\& باید عنصری از نوع
.RS 4
GtkMenu با شناسه \fBmenu\fR در آن وجود داشته باشد.\&
.PP
.RE
\fBmenu\-actions\fR:
.br
نوع: array
.br
عملیات متناظر با دکمه‌های منو.\&
.PP
.SH "جایگزین‌های قالب (FORMAT REPLACEMENTS)"
.PP
\fB{percentage}\fR: ظرفیت باتری به درصد
.PP
\fB{time}\fR: زمان تخمینی تا خالی شدن یا شارژ کامل، بسته به وضعیت شارژ.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"upower": {
	"icon\-size": 20,
	"hide\-if\-empty": true,
	"tooltip": true,
	"tooltip\-spacing": 20
}

.fi
.RE
.nf
.RS 4
"upower": {
	"native\-path": "/org/bluez/hci0/dev_D4_AE_41_38_D0_EF",
	"icon\-size": 20,
	"hide\-if\-empty": true,
	"tooltip": true,
	"tooltip\-spacing": 20
}

.fi
.RE
.nf
.RS 4
"upower": {
	"native\-path": "battery_sony_controller_battery_d0o27o88o32ofcoee",
	"icon\-size": 20,
	"hide\-if\-empty": true,
	"tooltip": true,
	"tooltip\-spacing": 20
}
.fi
.RE
.nf
.RS 4
"upower": {
	"show\-icon": false,
	"hide\-if\-empty": true,
	"tooltip": true,
	"tooltip\-spacing": 20
}

.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#upower\fR
.IP \(bu 4
\fB#upower.\&charging\fR
.IP \(bu 4
\fB#upower.\&discharging\fR
.IP \(bu 4
\fB#upower.\&full\fR
.IP \(bu 4
\fB#upower.\&empty\fR
.IP \(bu 4
\fB#upower.\&unknown\-status\fR