waybar-upower(5)              File Formats Manual             waybar-upower(5)

نام (NAME)
       waybar-upower - ماژول upower در waybar

توضیحات (DESCRIPTION)
       ماژول upower ظرفیت باتری اصلی را به همراه تمام دستگاه‌های سازگار با
       upower در راهنمای شناور (tooltip) نمایش می‌دهد.

پیکربندی (CONFIGURATION)
       native-path:
       نوع: string
       پیش‌فرض:
       باتری مورد نظر برای پایش. به
       https://upower.freedesktop.org/docs/UpDevice.html#UpDevice--native-path
       مراجعه کنید.
       می‌توان آن را با استفاده از `upower --dump` به دست آورد.

       model:
       نوع: string
       پیش‌فرض:
       باتری مورد نظر برای پایش، بر اساس مدل. (در صورت ارائه native-path، این
       گزینه نادیده گرفته می‌شود).
       می‌توان آن را با استفاده از `upower --dump` به دست آورد.

       icon-size:
       نوع: integer
       پیش‌فرض: 20
       اندازه آیکون‌ها را تعیین می‌کند.

       format:
       نوع: string
       پیش‌فرض: {percentage}
       قالب متن.

       format-alt:
       نوع: string
       پیش‌فرض: {percentage} {time}
       قالب متن در هنگام تغییر وضعیت (toggle).

       hide-if-empty:
       نوع: bool
       پیش‌فرض: true
       نمایش یا عدم نمایش ماژول را در صورتی که هیچ دستگاهی یافت نشود، تعیین
       می‌کند.

       tooltip:
       نوع: bool
       پیش‌فرض: true
       گزینه‌ای برای غیرفعال کردن راهنمای شناور (tooltip) هنگام رفتن نشانگر روی
       آن.

       tooltip-spacing:
       نوع: integer
       پیش‌فرض: 4
       فاصله بین نام دستگاه در راهنمای شناور و وضعیت باتری دستگاه را تعیین
       می‌کند.

       tooltip-padding:
       نوع: integer
       پیش‌فرض: 4
       فاصله بین لبه پنجره راهنمای شناور و محتوای راهنمای شناور را تعیین
       می‌کند.

       on-click:
       نوع: string
       دستوری که هنگام کلیک روی ماژول اجرا می‌شود.

       show-icon:
       نوع: bool
       پیش‌فرض: true
       گزینه‌ای برای غیرفعال کردن آیکون باتری.

       menu:
       نوع: string
       عملیاتی که منو را نمایان می‌سازد (popup).

       menu-file:
       نوع: string
       محل فایل توصیف‌کننده منو. باید عنصری از نوع
           GtkMenu با شناسه menu در آن وجود داشته باشد.

       menu-actions:
       نوع: array
       عملیات متناظر با دکمه‌های منو.

جایگزین‌های قالب (FORMAT REPLACEMENTS)
       {percentage}: ظرفیت باتری به درصد

       {time}: زمان تخمینی تا خالی شدن یا شارژ کامل، بسته به وضعیت شارژ.

مثال‌ها (EXAMPLES)
           "upower": {
                "icon-size": 20,
                "hide-if-empty": true,
                "tooltip": true,
                "tooltip-spacing": 20
           }

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

           "upower": {
                "native-path": "battery_sony_controller_battery_d0o27o88o32ofcoee",
                "icon-size": 20,
                "hide-if-empty": true,
                "tooltip": true,
                "tooltip-spacing": 20
           }
           "upower": {
                "show-icon": false,
                "hide-if-empty": true,
                "tooltip": true,
                "tooltip-spacing": 20
           }


استایل (STYLE)
       •   #upower
       •   #upower.charging
       •   #upower.discharging
       •   #upower.full
       •   #upower.empty
       •   #upower.unknown-status

                                  2026-08-31                  waybar-upower(5)