نام (NAME)

waybar-mpris - ماژول MPRIS در waybar

توضیحات (DESCRIPTION)

ماژول mpris رسانه در حال پخش را از طریق libplayerctl نمایش می‌دهد.

پیکربندی (CONFIGURATION)

player:
نوع: رشته (string)
پیش‌فرض: playerctld
نام پخش‌کننده MPRIS برای اتصال به آن. استفاده از مقدار پیش‌فرض همیشه از پخش‌کننده فعال کنونی پیروی می‌کند.

ignored-players:
نوع: آرایه‌ای از رشته‌ها ([]string)
نادیده گرفتن به‌روزرسانی‌های پخش‌کننده‌های فهرست‌شده، هنگام استفاده از playerctld.

interval:
نوع: عدد صحیح (integer)
پیش‌فرض: 0
تازه‌سازی اطلاعات MPRIS بر اساس یک زمان‌سنج.

format:
نوع: رشته (string)
پیش‌فرض: {player} ({status}) {dynamic}
قالب متن.

format-[status]:
نوع: رشته (string)
قالب متن ویژه هر وضعیت.

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

tooltip-format:
نوع: رشته (string)
پیش‌فرض: {player} ({status}) {dynamic}
قالب متن راهنمای شناور.

tooltip-format-[status]:
نوع: رشته (string)
قالب راهنمای شناور ویژه هر وضعیت.

artist-len:
نوع: عدد صحیح (integer)
حداکثر طول برچسب هنرمند (نویسه‌های یونیکد با پهنای کامل/عریض دو نویسه به حساب می‌آیند). برای پنهان کردن هنرمند در برچسب `{dynamic}` مقدار را روی صفر تنظیم کنید.

album-len:
نوع: عدد صحیح (integer)
حداکثر طول برچسب آلبوم (نویسه‌های یونیکد با پهنای کامل/عریض دو نویسه به حساب می‌آیند). برای پنهان کردن آلبوم در برچسب `{dynamic}` مقدار را روی صفر تنظیم کنید.

title-len:
نوع: عدد صحیح (integer)
حداکثر طول برچسب عنوان (نویسه‌های یونیکد با پهنای کامل/عریض دو نویسه به حساب می‌آیند). برای پنهان کردن عنوان در برچسب `{dynamic}` مقدار را روی صفر تنظیم کنید.

dynamic-len:
نوع: عدد صحیح (integer)
حداکثر طول برچسب پویا (Dynamic) (نویسه‌های یونیکد با پهنای کامل/عریض
دو نویسه به حساب می‌آیند). برچسب پویا هیچ برچسبی را فراتر از
محدودیت‌های طول تعیین‌شده‌شان کوتاه نمی‌کند، در عوض تلاش می‌کند تا حد ممکن
بیشترین مقدار برچسب‌های دردسترس را جای دهد. توصیه می‌شود مقدار title-len را
کمتر یا برابر با این مقدار قرار دهید تا عنوان همیشه نمایش
داده شود.

dynamic-order:
نوع: آرایه‌ای از رشته‌ها ([]string)
پیش‌فرض: ["title", "artist", "album", "position", "length"]
ترتیب برچسب‌های نشان‌داده‌شده توسط برچسب پویا. برچسب‌های position و length
همواره در قالب [{position}/{length}] ترکیب خواهند شد. ترتیب
این برچسب‌ها نسبت به سایر برچسب‌ها بر اساس اعلان نخستین مورد از میان این دو برچسب
تعیین می‌شود. عدم وجود در این فهرست به معنای حذف اجباری است.

dynamic-importance-order:
نوع: آرایه‌ای از رشته‌ها ([]string)
پیش‌فرض: ["title", "artist", "album", "position", "length"]
اولویت برچسب‌ها هنگام کوتاه‌سازی برچسب پویا. آخرین موارد
نخستین مواردی خواهند بود که کوتاه می‌شوند. عدم وجود در این فهرست به معنای
گنجاندن اجباری است.

dynamic-separator:
نوع: رشته (string)
پیش‌فرض: " - "
این نویسه‌ها برای جداسازی دو برچسب مختلف استفاده خواهند شد، مگر
در حالتی که یکی از این برچسب‌ها position و length باشد.

truncate-hours:
نوع: بولی (bool)
پیش‌فرض: true
پنهان‌سازی ساعت در صورتی که مدت‌زمان رسانه کمتر از یک ساعت باشد.

enable-tooltip-len-limits:
نوع: بولی (bool)
پیش‌فرض: false
گزینه‌ای برای فعال‌سازی محدودیت‌های طول برای راهنمای شناور نیز هست. به‌طور پیش‌فرض، راهنمای شناور تمام محدودیت‌های طول را نادیده می‌گیرد.

ellipsis:
نوع: رشته (string)
پیش‌فرض: "…"
این نویسه زمانی که هر یک از برچسب‌ها از حداکثر طول خود فراتر بروند استفاده خواهد شد. اگر نمی‌خواهید از نشان تعلیق استفاده کنید، این مقدار را روی یک رشته خالی تنظیم نمایید.

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

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

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

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

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

on-click:
نوع: رشته (string)
پیش‌فرض: play-pause
بازنویسی جابه‌جایی عملیات پیش‌فرض.

on-click-middle:
نوع: رشته (string)
پیش‌فرض: previous track
بازنویسی جابه‌جایی عملیات پیش‌فرض.

on-click-right:
نوع: رشته (string)
پیش‌فرض: next track
بازنویسی جابه‌جایی عملیات پیش‌فرض.

player-icons:
نوع: نگاشت (map[string]string)
امکان تنظیم {player_icon} بر اساس ویژگی player-name را فراهم می‌کند.

status-icons:
نوع: نگاشت (map[string]string)
امکان تنظیم {status_icon} بر اساس وضعیت پخش‌کننده (playing، paused، stopped) را فراهم می‌کند.

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

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

{player}: نام پخش‌کننده رسانه کنونی

{status}: وضعیت کنونی (playing، paused، stopped)

{artist}: هنرمند قطعه موسیقی کنونی

{album}: عنوان آلبوم قطعه موسیقی کنونی

{title}: عنوان قطعه موسیقی کنونی

{length}: مدت‌زمان قطعه، قالب‌بندی‌شده به‌صورت HH:MM:SS

{dynamic}: استفاده از {artist}، {album}، {title} و {length}، با حذف خودکار
مقادیر خالی

{player_icon}: انتخاب یک آیکون از player-icons بر اساس {player}

{status_icon}: انتخاب یک آیکون از status-icons بر اساس {status}

مثال‌ها (EXAMPLES)

"mpris": {
	"format": "{player_icon} {dynamic}",
	"format-paused": "{status_icon} <i>{dynamic}</i>",
	"player-icons": {
		"default": "▶",
		"mpv": "🎵"
	},
	"status-icons": {
		"paused": "⏸"
	},
	// "ignored-players": ["firefox"]
}

استایل (STYLE)

• #mpris
• #mpris.${status}
• #mpris.${player}