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

waybar-wireplumber - ماژول WirePlumber برای waybar

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

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
کنش‌های متناظر با دکمه‌های منو.

{volume}: بلندی صدا برحسب درصد.

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

"wireplumber": {
	"format": "{volume}%",
	"format-muted": "",
	"on-click": "helvum"
}

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

  • #wireplumber
  • #wireplumber.muted
2026-08-31