نام (NAME)

waybar - ماژول pulseaudio

توضیحات (DESCRIPTION)

ماژول pulseaudio میزان صدای فعلی گزارش‌شده توسط PulseAudio را نمایش می‌دهد.

علاوه بر این، می‌توانید با اسکرول کردن به بالا یا پایین در زمانی که نشانگر ماوس روی ماژول قرار دارد، میزان صدا را کنترل کنید.

پیکربندی (CONFIGURATION)

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

format-bluetooth:
نوع: رشته (string)
این قالب هنگام استفاده از بلندگوهای بلوتوث استفاده می‌شود.

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

format-source:
نوع: رشته (string)
پیش‌فرض: {volume}%
این قالب برای منبع صوتی (source) استفاده می‌شود.

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

format-icons:
نوع: آرایه (array)
بر اساس نام درگاه (port) فعلی و میزان صدا، آیکون متناظر انتخاب می‌شود. ترتیب از low (کم) به high (زیاد) است. بخش آیکون‌ها (ICONS) را ببینید.

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

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

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

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

align:
نوع: ممیز شناور (float)
تراز برچسب درون ماژول، که 0 چپ‌چین و 1 راست‌چین است. اگر ماژول چرخانده شود، از جریان متن پیروی خواهد کرد.

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

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

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

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

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

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

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

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

smooth-scrolling-threshold:
نوع: ممیز شناور با دقت مضاعف (double)
آستانه‌ای که هنگام اسکرول استفاده می‌شود.

reverse-scrolling:
نوع: بولی (bool)
گزینه‌ای برای معکوس کردن جهت اسکرول برای تاچ‌پدها.

reverse-mouse-scrolling:
نوع: بولی (bool)
گزینه‌ای برای معکوس کردن جهت اسکرول برای ماوس‌ها.

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

max-volume:
نوع: عدد صحیح (integer)
پیش‌فرض: 100
حداکثر میزان صدایی که می‌توان تنظیم کرد، بر حسب درصد.

ignored-sinks:
نوع: آرایه (array)
خروجی‌های صوتی (sinks) موجود در این فهرست به عنوان خروجی فعال توسط Waybar نمایش داده نخواهند شد. ورودی‌ها باید فیلد توضیحات (description) خروجی باشند.

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

menu-file:
نوع: رشته (string)
مکان فایل توصیف‌کننده منو. باید عنصری از نوع

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

expand:
نوع: بولی (bool)
پیش‌فرض: false
به این ماژول اجازه می‌دهد تمام فضای باقی‌مانده را به صورت پویا مصرف کند.

جایگزین‌های قالب‌بندی (FORMAT REPLACEMENTS)

{desc}: توضیحات درگاه (port) در PulseAudio؛ برای بلوتوث، نام دستگاه خواهد بود.

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

{icon}: آیکون، طبق تعریف در format-icons.

{format_source}: قالب منبع ورودی، format-source، format-source-muted.

آیکون‌ها (ICONS)

رشته‌های زیر برای format-icons پشتیبانی می‌شوند.

•

نام دستگاه (device name)

اگر این رشته‌ها در نام درگاه فعلی PulseAudio یافت شوند، آیکون‌های متناظر انتخاب خواهند شد.

• default (زمانی که درگاه دیگری یافت نشود نمایش داده می‌شود)
• headphone
• speaker
• hdmi
• headset
• hands-free
• portable
• car
• hifi
• phone

علاوه بر این، افزودن پسوند -muted به نام یک دستگاه یا درگاه باعث می‌شود در صورت بی‌صدا بودن دستگاه صوتی مربوطه، آن آیکون انتخاب شود. این مورد برای default نیز صدق می‌کند.

مثال‌ها (EXAMPLES)

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

استایل (STYLE)

• #pulseaudio
• #pulseaudio.bluetooth
• #pulseaudio.muted