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

نام (NAME)
       waybar-wireplumber - ماژول WirePlumber برای waybar

توضیحات (DESCRIPTION)
       ماژول wireplumber میزان بلندی صدای جاری گزارش‌شده توسط WirePlumber را
       نمایش می‌دهد.

پیکربندی (CONFIGURATION)
       format:
       typeof: string
       default: {volume}%
       قالب نحوه نمایش اطلاعات. این قالب زمانی استفاده می‌شود که قالب‌های دیگر
       مشخص نشده باشند.

       format-muted:
       typeof: string
       این قالب زمانی استفاده می‌شود که صدا بی‌صدا (Mute) شده باشد.

       node-type:
       typeof: string
       default: Audio/Sink
       نوع گره WirePlumber برای اتصال. از Audio/Source برای مدیریت میکروفون‌ها
       و غیره استفاده کنید.

       tooltip:
       typeof: bool
       default: true
       گزینه‌ای برای غیرفعال کردن راهنمای شناور (Tooltip) هنگام قرار گرفتن
       نشانگر ماوس روی آن.

       tooltip-format:
       typeof: string
       default: {node_name}
       قالب اطلاعات نمایش‌داده‌شده در راهنمای شناور.

       rotate:
       typeof: integer
       مقدار مثبت برای چرخاندن برچسب متنی (با گام‌های ۹۰ درجه).

       states:
       typeof: object
       تعدادی از وضعیت‌های بلندی صدا که در سطوح مشخصی فعال می‌شوند.
       waybar-states(5) را ببینید.

       max-length:
       typeof: integer
       حداکثر طول برحسب کاراکتر که ماژول باید نمایش دهد.

       min-length:
       typeof: integer
       حداقل طول برحسب کاراکتر که ماژول باید بپذیرد.

       align:
       typeof: float
       تراز برچسب در ماژول، که در آن ۰ چپ‌چین و ۱ راست‌چین است. اگر ماژول
       چرخانده شود، از جهت جریان متن پیروی خواهد کرد.

       justify:
       typeof: string
       تراز متن درون برچسب ماژول، که گزینه‌های 'left'، 'right'، یا 'center' را
       برای تعیین موقعیت امکان‌پذیر می‌سازد.

       scroll-step:
       typeof: float
       default: 1.0
       سرعت تغییر بلندی صدا هنگام پیمایش (اسکرول).

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

       on-click-middle:
       typeof: string
       دستوری که هنگام کلیک وسط روی ماژول با استفاده از چرخ ماوس اجرا می‌شود.

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

       on-update:
       typeof: string
       دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.

       on-scroll-up:
       typeof: string
       دستوری که هنگام پیمایش رو به بالا روی ماژول اجرا می‌شود. این دستور
       جایگزین رفتار پیش‌فرض کنترل صدا می‌شود.

       on-scroll-down:
       typeof: string
       دستوری که هنگام پیمایش رو به پایین روی ماژول اجرا می‌شود. این دستور
       جایگزین رفتار پیش‌فرض کنترل صدا می‌شود.

       max-volume:
       typeof: float
       default: 100
       حداکثر بلندی صدایی که می‌توان تنظیم کرد، برحسب درصد.

       menu:
       typeof: string
       کنشی که منو را باز می‌کند.

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

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

جایگزین‌های قالب (FORMAT REPLACEMENTS)
       {volume}: بلندی صدا برحسب درصد.

       {node_name}: نام مستعار گره طبق گزارش WirePlumber (ویژگی node.nick)

مثال‌ها (EXAMPLES)
   پایه (Basic):
           "wireplumber": {
                "format": "{volume}%",
                "format-muted": "",
                "on-click": "helvum"
           }

   ابزارک‌های مجزای خروجی و ورودی صدا (Separate Sink and Source Widgets):
           "wireplumber#sink": {
               "format": "{volume}% {icon}",
               "format-muted": "",
               "format-icons": ["", "", ""],
               "on-click": "helvum",
               "on-click-right": "wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle",
               "scroll-step": 5
           },
           "wireplumber#source": {
               "node-type": "Audio/Source",
               "format": "{volume}% ",
               "format-muted": "",
               "on-click-right": "wpctl set-mute @DEFAULT_AUDIO_SOURCE@ toggle",
               "scroll-step": 5
           }

استایل (STYLE)
       •   #wireplumber
       •   #wireplumber.muted

                                  2026-08-31             waybar-wireplumber(5)