.\" 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\-sndio" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
waybar\-sndio \- ماژول صوتی sndio در waybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBsndio\fR میزان بلندی صدای فعلی گزارش‌شده توسط \fBsndio\fR(7) را نمایش می‌دهد.
.PP
علاوه بر این، می‌توانید با چرخاندن چرخ ماوس به سمت \fBبالا\fR یا \fBپایین\fR هنگامی که نشانگر روی ماژول قرار دارد، بلندی صدا را کنترل کنید و کلیک روی ماژول وضعیت بی‌صدا (mute) را تغییر می‌دهد.
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
\fBformat\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {volume}%
.br
قالب نحوه نمایش اطلاعات.
.PP
\fBrotate\fR:
.br
نوع: عدد صحیح (integer)
.br
مقدار مثبت برای چرخاندن برچسب متنی (در گام‌های ۹۰ درجه).
.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
نوع: عدد صحیح (int)
.br
پیش‌فرض: 5
.br
میزان تغییر بلندی صدا در هر بار پیمایش چرخ ماوس (اسکرول).
.PP
\fBon\-click\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام کلیک روی ماژول اجرا می‌شود.
.RS 4
این گزینه جایگزین رفتار پیش‌فرض تغییر حالت بی‌صدا (تغییر وضعیت قطع/وصل صدا) می‌شود.
.PP
.RE
\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
دستوری که هنگام چرخاندن چرخ ماوس به سمت بالا روی ماژول اجرا می‌شود.
.br
این گزینه جایگزین رفتار پیش‌فرض کنترل بلندی صدا می‌شود.
.PP
\fBon\-scroll\-down\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام چرخاندن چرخ ماوس به سمت پایین روی ماژول اجرا می‌شود.
.br
این گزینه جایگزین رفتار پیش‌فرض کنترل بلندی صدا می‌شود.
.PP
\fBsmooth\-scrolling\-threshold\fR:
.br
نوع: عدد اعشاری با دقت مضاعف (double)
.br
آستانه مورد استفاده هنگام پیمایش نرم چرخ ماوس.
.PP
\fBmenu\fR:
.br
نوع: رشته (string)
.br
عملی که منوی جهنده را باز می‌کند.
.PP
\fBmenu\-file\fR:
.br
نوع: رشته (string)
.br
مسیر فایل توصیف‌کننده منو. باید عنصری از نوع GtkMenu با شناسه \fBmenu\fR وجود داشته باشد.
.PP
\fBmenu\-actions\fR:
.br
نوع: آرایه (array)
.br
اقدامات متناظر با دکمه‌های منو.
.PP
\fBexpand\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
فعال‌سازی این ماژول برای مصرف پویای تمامی فضای باقی‌مانده.
.PP
.SH "جایگزین‌های قالب‌بندی (FORMAT REPLACEMENTS)"
.PP
\fB{volume}\fR: میزان بلندی صدا به درصد.
.PP
\fB{raw_value}\fR: میزان بلندی صدا به صورت مقدار خام گزارش‌شده توسط sndio.
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"sndio": {
	"format": "{raw_value} 🎜",
	"scroll\-step": 3
}
.fi
.RE
.PP
.SH "سبک و ظاهر (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#sndio\fR
.IP \(bu 4
\fB#sndio.\&muted\fR