.\" 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\-wireplumber" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar\-wireplumber \- ماژول WirePlumber برای waybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBwireplumber\fR میزان بلندی صدای جاری گزارش‌شده توسط WirePlumber را نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
\fBformat\fR:
.br
typeof: string
.br
default: \fB{volume}%\fR
.br
قالب نحوه نمایش اطلاعات.\& این قالب زمانی استفاده می‌شود که قالب‌های دیگر مشخص نشده باشند.\&
.PP
\fBformat\-muted\fR:
.br
typeof: string
.br
این قالب زمانی استفاده می‌شود که صدا بی‌صدا (Mute) شده باشد.\&
.PP
\fBnode\-type\fR:
.br
typeof: string
.br
default: \fBAudio/Sink\fR
.br
نوع گره WirePlumber برای اتصال.\& از \fBAudio/Source\fR برای مدیریت میکروفون‌ها و غیره استفاده کنید.\&
.PP
\fBtooltip\fR:
.br
typeof: bool
.br
default: \fBtrue\fR
.br
گزینه‌ای برای غیرفعال کردن راهنمای شناور (Tooltip) هنگام قرار گرفتن نشانگر ماوس روی آن.\&
.PP
\fBtooltip\-format\fR:
.br
typeof: string
.br
default: \fB{node_name}\fR
.br
قالب اطلاعات نمایش‌داده‌شده در راهنمای شناور.\&
.PP
\fBrotate\fR:
.br
typeof: integer
.br
مقدار مثبت برای چرخاندن برچسب متنی (با گام‌های ۹۰ درجه).\&
.PP
\fBstates\fR:
.br
typeof: object
.br
تعدادی از وضعیت‌های بلندی صدا که در سطوح مشخصی فعال می‌شوند.\& \fBwaybar\-states(5)\fR را ببینید.\&
.PP
\fBmax\-length\fR:
.br
typeof: integer
.br
حداکثر طول برحسب کاراکتر که ماژول باید نمایش دهد.\&
.PP
\fBmin\-length\fR:
.br
typeof: integer
.br
حداقل طول برحسب کاراکتر که ماژول باید بپذیرد.\&
.PP
\fBalign\fR:
.br
typeof: float
.br
تراز برچسب در ماژول، که در آن ۰ چپ‌چین و ۱ راست‌چین است.\& اگر ماژول چرخانده شود، از جهت جریان متن پیروی خواهد کرد.\&
.PP
\fBjustify\fR:
.br
typeof: string
.br
تراز متن درون برچسب ماژول، که گزینه‌های '\&left'\&، '\&right'\&، یا '\&center'\& را برای تعیین موقعیت امکان‌پذیر می‌سازد.\&
.PP
\fBscroll\-step\fR:
.br
typeof: float
.br
default: 1.\&0
.br
سرعت تغییر بلندی صدا هنگام پیمایش (اسکرول).\&
.PP
\fBon\-click\fR:
.br
typeof: string
.br
دستوری که هنگام کلیک روی ماژول اجرا می‌شود.\&
.PP
\fBon\-click\-middle\fR:
.br
typeof: string
.br
دستوری که هنگام کلیک وسط روی ماژول با استفاده از چرخ ماوس اجرا می‌شود.\&
.PP
\fBon\-click\-right\fR:
.br
typeof: string
.br
دستوری که هنگام کلیک راست روی ماژول اجرا می‌شود.\&
.PP
\fBon\-update\fR:
.br
typeof: string
.br
دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.\&
.PP
\fBon\-scroll\-up\fR:
.br
typeof: string
.br
دستوری که هنگام پیمایش رو به بالا روی ماژول اجرا می‌شود.\& این دستور جایگزین رفتار پیش‌فرض کنترل صدا می‌شود.\&
.PP
\fBon\-scroll\-down\fR:
.br
typeof: string
.br
دستوری که هنگام پیمایش رو به پایین روی ماژول اجرا می‌شود.\& این دستور جایگزین رفتار پیش‌فرض کنترل صدا می‌شود.\&
.PP
\fBmax\-volume\fR:
.br
typeof: float
.br
default: 100
.br
حداکثر بلندی صدایی که می‌توان تنظیم کرد، برحسب درصد.\&
.PP
\fBmenu\fR:
.br
typeof: string
.br
کنشی که منو را باز می‌کند.\&
.PP
\fBmenu\-file\fR:
.br
typeof: string
.br
محل پرونده توصیف‌گر منو.\& باید عنصری از نوع GtkMenu با شناسه \fBmenu\fR وجود داشته باشد.\&
.PP
\fBmenu\-actions\fR:
.br
typeof: array
.br
کنش‌های متناظر با دکمه‌های منو.\&
.PP
.SH "جایگزین‌های قالب (FORMAT REPLACEMENTS)"
.PP
\fB{volume}\fR: بلندی صدا برحسب درصد.\&
.PP
\fB{node_name}\fR: نام مستعار گره طبق گزارش WirePlumber (ویژگی \fBnode.\&nick\fR)
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.SS "پایه (Basic):"
.PP
.nf
.RS 4
"wireplumber": {
	"format": "{volume}%",
	"format\-muted": "",
	"on\-click": "helvum"
}
.fi
.RE
.PP
.SS "ابزارک‌های مجزای خروجی و ورودی صدا (Separate Sink and Source Widgets):"
.PP
.nf
.RS 4
"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
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#wireplumber\fR
.IP \(bu 4
\fB#wireplumber.\&muted\fR