.\" 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\-pulseaudio" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar \- ماژول pulseaudio
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBpulseaudio\fR میزان صدای فعلی گزارش‌شده توسط PulseAudio را نمایش می‌دهد.\&
.PP
علاوه بر این، می‌توانید با اسکرول کردن به \fBبالا\fR یا \fBپایین\fR در زمانی که نشانگر ماوس روی ماژول قرار دارد، میزان صدا را کنترل کنید.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
\fBformat\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {volume}%
.br
قالب نحوه نمایش اطلاعات.\& این قالب زمانی استفاده می‌شود که قالب‌های دیگر مشخص نشده باشند.\&
.PP
\fBformat\-bluetooth\fR:
.br
نوع: رشته (string)
.br
این قالب هنگام استفاده از بلندگوهای بلوتوث استفاده می‌شود.\&
.PP
\fBformat\-muted\fR:
.br
نوع: رشته (string)
.br
این قالب زمانی استفاده می‌شود که صدا بی‌صدا (muted) شده باشد.\&
.PP
\fBformat\-source\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {volume}%
.br
این قالب برای منبع صوتی (source) استفاده می‌شود.\&
.PP
\fBformat\-source\-muted\fR:
.br
نوع: رشته (string)
.br
این قالب زمانی استفاده می‌شود که منبع صوتی (source) بی‌صدا (muted) شده باشد.\&
.PP
\fBformat\-icons\fR:
.br
نوع: آرایه (array)
.br
بر اساس نام درگاه (port) فعلی و میزان صدا، آیکون متناظر انتخاب می‌شود.\& ترتیب از \fBlow\fR (کم) به \fBhigh\fR (زیاد) است.\& بخش \fBآیکون‌ها (ICONS)\fR را ببینید.\&
.PP
\fBrotate\fR:
.br
نوع: عدد صحیح (integer)
.br
مقدار مثبت جهت چرخش برچسب متنی (با گام‌های ۹۰ درجه).\&
.PP
\fBstates\fR:
.br
نوع: شیء (object)
.br
تعدادی از وضعیت‌های سطح صدا که در سطوح خاصی از میزان صدا فعال می‌شوند.\& به \fBwaybar\-states(5)\fR مراجعه کنید.\&
.PP
\fBmax\-length\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول بر حسب کاراکتر که ماژول باید نمایش دهد.\&
.PP
\fBmin\-length\fR:
.br
نوع: عدد صحیح (integer)
.br
حداقل طول بر حسب کاراکتر که ماژول باید بپذیرد.\&
.PP
\fBalign\fR:
.br
نوع: ممیز شناور (float)
.br
تراز برچسب درون ماژول، که 0 چپ‌چین و 1 راست‌چین است.\& اگر ماژول چرخانده شود، از جریان متن پیروی خواهد کرد.\&
.PP
\fBjustify\fR:
.br
نوع: رشته (string)
.br
تراز متن درون برچسب ماژول، با پذیرش گزینه‌های '\&left'\& (چپ)، '\&right'\& (راست) یا '\&center'\& (وسط) جهت تعیین موقعیت.\&
.PP
\fBscroll\-step\fR:
.br
نوع: ممیز شناور (float)
.br
پیش‌فرض: 1.\&0
.br
سرعتی که با آن میزان صدا هنگام اسکرول تغییر می‌کند.\&
.PP
\fBon\-click\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام کلیک روی ماژول اجرا می‌شود.\&
.PP
\fBon\-click\-middle\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام کلیک وسط (با چرخ ماوس) روی ماژول اجرا می‌شود.\&
.PP
\fBon\-click\-right\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام کلیک راست روی ماژول اجرا می‌شود.\&
.PP
\fBon\-update\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.\&
.PP
\fBon\-scroll\-up\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام اسکرول به بالا روی ماژول اجرا می‌شود.\& این دستور جایگزین رفتار پیش‌فرض کنترل صدا می‌شود.\&
.PP
\fBon\-scroll\-down\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام اسکرول به پایین روی ماژول اجرا می‌شود.\& این دستور جایگزین رفتار پیش‌فرض کنترل صدا می‌شود.\&
.PP
\fBsmooth\-scrolling\-threshold\fR:
.br
نوع: ممیز شناور با دقت مضاعف (double)
.br
آستانه‌ای که هنگام اسکرول استفاده می‌شود.\&
.PP
\fBreverse\-scrolling\fR:
.br
نوع: بولی (bool)
.br
گزینه‌ای برای معکوس کردن جهت اسکرول برای تاچ‌پدها.\&
.PP
\fBreverse\-mouse\-scrolling\fR:
.br
نوع: بولی (bool)
.br
گزینه‌ای برای معکوس کردن جهت اسکرول برای ماوس‌ها.\&
.PP
\fBtooltip\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: true
.br
گزینه‌ای برای غیرفعال کردن راهنمای شناور (tooltip) هنگام نگه داشتن ماوس روی ماژول.\&
.PP
\fBmax\-volume\fR:
.br
نوع: عدد صحیح (integer)
.br
پیش‌فرض: 100
.br
حداکثر میزان صدایی که می‌توان تنظیم کرد، بر حسب درصد.\&
.PP
\fBignored\-sinks\fR:
.br
نوع: آرایه (array)
.br
خروجی‌های صوتی (sinks) موجود در این فهرست به عنوان خروجی فعال توسط Waybar نمایش داده نخواهند شد.\& ورودی‌ها باید فیلد توضیحات (description) خروجی باشند.\&
.PP
\fBmenu\fR:
.br
نوع: رشته (string)
.br
عملیاتی که منو را باز می‌کند.\&
.PP
\fBmenu\-file\fR:
.br
نوع: رشته (string)
.br
مکان فایل توصیف‌کننده منو.\& باید عنصری از نوع
.RS 4
GtkMenu با شناسه \fBmenu\fR وجود داشته باشد
.PP
.RE
\fBmenu\-actions\fR:
.br
نوع: آرایه (array)
.br
عملیات‌های متناظر با دکمه‌های منو.\&
.PP
\fBexpand\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
به این ماژول اجازه می‌دهد تمام فضای باقی‌مانده را به صورت پویا مصرف کند.\&
.PP
.SH "جایگزین‌های قالب‌بندی (FORMAT REPLACEMENTS)"
.PP
\fB{desc}\fR: توضیحات درگاه (port) در PulseAudio؛ برای بلوتوث، نام دستگاه خواهد بود.\&
.PP
\fB{volume}\fR: میزان صدا بر حسب درصد.\&
.PP
\fB{icon}\fR: آیکون، طبق تعریف در \fBformat\-icons\fR.\&
.PP
\fB{format_source}\fR: قالب منبع ورودی، \fBformat\-source\fR، \fBformat\-source\-muted\fR.\&
.PP
.SH "آیکون‌ها (ICONS)"
.PP
رشته‌های زیر برای \fBformat\-icons\fR پشتیبانی می‌شوند.\&
.PP
.PD 0
.IP \(bu 4
نام دستگاه (device name)
.PD
.PP
اگر این رشته‌ها در نام درگاه فعلی PulseAudio یافت شوند، آیکون‌های متناظر انتخاب خواهند شد.\&
.PP
.PD 0
.IP \(bu 4
\fBdefault\fR (زمانی که درگاه دیگری یافت نشود نمایش داده می‌شود)
.IP \(bu 4
\fBheadphone\fR
.IP \(bu 4
\fBspeaker\fR
.IP \(bu 4
\fBhdmi\fR
.IP \(bu 4
\fBheadset\fR
.IP \(bu 4
\fBhands\-free\fR
.IP \(bu 4
\fBportable\fR
.IP \(bu 4
\fBcar\fR
.IP \(bu 4
\fBhifi\fR
.IP \(bu 4
\fBphone\fR
.PD
.PP
علاوه بر این، افزودن پسوند \fB\-muted\fR به نام یک دستگاه یا درگاه باعث می‌شود در صورت بی‌صدا بودن دستگاه صوتی مربوطه، آن آیکون انتخاب شود.\& این مورد برای \fBdefault\fR نیز صدق می‌کند.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"pulseaudio": {
	"format": "{volume}% {icon}",
	"format\-bluetooth": "{volume}% {icon}",
	"format\-muted": "",
	"format\-icons": {
		"alsa_output\&.pci\-0000_00_1f\&.3\&.analog\-stereo": "",
		"alsa_output\&.pci\-0000_00_1f\&.3\&.analog\-stereo\-muted": "",
		"headphone": "",
		"hands\-free": "",
		"headset": "",
		"phone": "",
		"phone\-muted": "",
		"portable": "",
		"car": "",
		"default": ["", ""]
	},
	"scroll\-step": 1,
	"on\-click": "pavucontrol"
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#pulseaudio\fR
.IP \(bu 4
\fB#pulseaudio.\&bluetooth\fR
.IP \(bu 4
\fB#pulseaudio.\&muted\fR