.\" 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\-mpris" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar\-mpris \- ماژول MPRIS در waybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBmpris\fR رسانه در حال پخش را از طریق libplayerctl نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
\fBplayer\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: playerctld
.br
نام پخش‌کننده MPRIS برای اتصال به آن.\& استفاده از مقدار پیش‌فرض همیشه از پخش‌کننده فعال کنونی پیروی می‌کند.\&
.PP
\fBignored\-players\fR:
.br
نوع: آرایه‌ای از رشته‌ها ([]string)
.br
نادیده گرفتن به‌روزرسانی‌های پخش‌کننده‌های فهرست‌شده، هنگام استفاده از playerctld.\&
.PP
\fBinterval\fR:
.br
نوع: عدد صحیح (integer)
.br
پیش‌فرض: 0
.br
تازه‌سازی اطلاعات MPRIS بر اساس یک زمان‌سنج.\&
.PP
\fBformat\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {player} ({status}) {dynamic}
.br
قالب متن.\&
.PP
\fBformat\-[status]\fR:
.br
نوع: رشته (string)
.br
قالب متن ویژه هر وضعیت.\&
.PP
\fBtooltip\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: true
.br
گزینه‌ای برای غیرفعال کردن راهنمای شناور (tooltip) هنگام رفتن نشانگر ماوس روی آن.\&
.PP
\fBtooltip\-format\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {player} ({status}) {dynamic}
.br
قالب متن راهنمای شناور.\&
.PP
\fBtooltip\-format\-[status]\fR:
.br
نوع: رشته (string)
.br
قالب راهنمای شناور ویژه هر وضعیت.\&
.PP
\fBartist\-len\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول برچسب هنرمند (نویسه‌های یونیکد با پهنای کامل/عریض دو نویسه به حساب می‌آیند).\& برای پنهان کردن هنرمند در برچسب `{dynamic}` مقدار را روی صفر تنظیم کنید.\&
.PP
\fBalbum\-len\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول برچسب آلبوم (نویسه‌های یونیکد با پهنای کامل/عریض دو نویسه به حساب می‌آیند).\& برای پنهان کردن آلبوم در برچسب `{dynamic}` مقدار را روی صفر تنظیم کنید.\&
.PP
\fBtitle\-len\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول برچسب عنوان (نویسه‌های یونیکد با پهنای کامل/عریض دو نویسه به حساب می‌آیند).\& برای پنهان کردن عنوان در برچسب `{dynamic}` مقدار را روی صفر تنظیم کنید.\&
.PP
\fBdynamic\-len\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول برچسب پویا (Dynamic) (نویسه‌های یونیکد با پهنای کامل/عریض
.br
دو نویسه به حساب می‌آیند).\& برچسب پویا هیچ برچسبی را فراتر از
.br
محدودیت‌های طول تعیین‌شده‌شان کوتاه نمی‌کند، در عوض تلاش می‌کند تا حد ممکن
.br
بیشترین مقدار برچسب‌های دردسترس را جای دهد.\& توصیه می‌شود مقدار title\-len را
.br
کمتر یا برابر با این مقدار قرار دهید تا عنوان همیشه نمایش
.br
داده شود.\&
.PP
\fBdynamic\-order\fR:
.br
نوع: آرایه‌ای از رشته‌ها ([]string)
.br
پیش‌فرض: ["title", "artist", "album", "position", "length"]
.br
ترتیب برچسب‌های نشان‌داده‌شده توسط برچسب پویا.\& برچسب‌های position و length
.br
همواره در قالب [{position}/{length}] ترکیب خواهند شد.\& ترتیب
.br
این برچسب‌ها نسبت به سایر برچسب‌ها بر اساس اعلان نخستین مورد از میان این دو برچسب
.br
تعیین می‌شود.\& عدم وجود در این فهرست به معنای حذف اجباری است.\&
.PP
\fBdynamic\-importance\-order\fR:
.br
نوع: آرایه‌ای از رشته‌ها ([]string)
.br
پیش‌فرض: ["title", "artist", "album", "position", "length"]
.br
اولویت برچسب‌ها هنگام کوتاه‌سازی برچسب پویا.\& آخرین موارد
.br
نخستین مواردی خواهند بود که کوتاه می‌شوند.\& عدم وجود در این فهرست به معنای
.br
گنجاندن اجباری است.\&
.PP
\fBdynamic\-separator\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: " \- "
.br
این نویسه‌ها برای جداسازی دو برچسب مختلف استفاده خواهند شد، مگر
.br
در حالتی که یکی از این برچسب‌ها position و length باشد.\&
.PP
\fBtruncate\-hours\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: true
.br
پنهان‌سازی ساعت در صورتی که مدت‌زمان رسانه کمتر از یک ساعت باشد.\&
.PP
\fBenable\-tooltip\-len\-limits\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
گزینه‌ای برای فعال‌سازی محدودیت‌های طول برای راهنمای شناور نیز هست.\& به‌طور پیش‌فرض، راهنمای شناور تمام محدودیت‌های طول را نادیده می‌گیرد.\&
.PP
\fBellipsis\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: "…"
.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
\fBon\-click\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: play\-pause
.br
بازنویسی جابه‌جایی عملیات پیش‌فرض.\&
.PP
\fBon\-click\-middle\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: previous track
.br
بازنویسی جابه‌جایی عملیات پیش‌فرض.\&
.PP
\fBon\-click\-right\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: next track
.br
بازنویسی جابه‌جایی عملیات پیش‌فرض.\&
.PP
\fBplayer\-icons\fR:
.br
نوع: نگاشت (map[string]string)
.br
امکان تنظیم \fI{player_icon}\fR بر اساس ویژگی player\-name را فراهم می‌کند.\&
.PP
\fBstatus\-icons\fR:
.br
نوع: نگاشت (map[string]string)
.br
امکان تنظیم \fI{status_icon}\fR بر اساس وضعیت پخش‌کننده (playing، paused، stopped) را فراهم می‌کند.\&
.PP
\fBexpand\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
به این ماژول امکان می‌دهد تمام فضای باقی‌مانده را به‌صورت پویا اشغال کند.\&
.PP
.PP
.SH "جایگزین‌های قالب‌بندی (FORMAT REPLACEMENTS)"
.PP
\fB{player}\fR: نام پخش‌کننده رسانه کنونی
.PP
\fB{status}\fR: وضعیت کنونی (playing، paused، stopped)
.PP
\fB{artist}\fR: هنرمند قطعه موسیقی کنونی
.PP
\fB{album}\fR: عنوان آلبوم قطعه موسیقی کنونی
.PP
\fB{title}\fR: عنوان قطعه موسیقی کنونی
.PP
\fB{length}\fR: مدت‌زمان قطعه، قالب‌بندی‌شده به‌صورت HH:MM:SS
.PP
\fB{dynamic}\fR: استفاده از \fI{artist}\fR، \fI{album}\fR، \fI{title}\fR و \fI{length}\fR، با حذف خودکار
.br
مقادیر خالی
.PP
\fB{player_icon}\fR: انتخاب یک آیکون از \fIplayer\-icons\fR بر اساس \fI{player}\fR
.PP
\fB{status_icon}\fR: انتخاب یک آیکون از \fIstatus\-icons\fR بر اساس \fI{status}\fR
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"mpris": {
	"format": "{player_icon} {dynamic}",
	"format\-paused": "{status_icon} <i>{dynamic}</i>",
	"player\-icons": {
		"default": "▶",
		"mpv": "🎵"
	},
	"status\-icons": {
		"paused": "⏸"
	},
	// "ignored\-players": ["firefox"]
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#mpris\fR
.IP \(bu 4
\fB#mpris.\&${status}\fR
.IP \(bu 4
\fB#mpris.\&${player}\fR