نام (NAME)

waybar-mpd - ماژول mpd در waybar

توضیحات (DESCRIPTION)

ماژول mpd اطلاعات مربوط به یک نمونه در حال اجرای «Music Player Daemon» را نمایش می‌دهد.

پیکربندی (CONFIGURATION)

با نام mpd آدرس‌دهی می‌شود.

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

port:
نوع: عدد صحیح (integer)
درگاهی که MPD به آن گوش می‌دهد. در صورت خالی بودن، از درگاه پیش‌فرض استفاده می‌شود.

password:
نوع: رشته (string)
گذرواژه مورد نیاز برای اتصال به سرور MPD. در صورت خالی بودن، هیچ گذرواژه‌ای به MPD ارسال نمی‌شود.

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

timeout:
نوع: عدد صحیح (integer)
پیش‌فرض: 30
مهلت زمانی اتصال (بر حسب ثانیه). اگر سرور MPD شما دارای تنظیم connection_timeout پایینی است، این مقدار را تغییر دهید.

unknown-tag:
نوع: رشته (string)
پیش‌فرض: "N/A"
متنی که هنگام نبود یک برچسب در آهنگ فعلی، اما استفاده از آن در format نمایش داده می‌شود.

format:
نوع: رشته (string)
پیش‌فرض: "{album} - {artist} - {title}"
اطلاعات نمایش‌داده‌شده هنگام پخش آهنگ.

format-stopped:
نوع: رشته (string)
پیش‌فرض: "stopped"
اطلاعات نمایش‌داده‌شده هنگامی که پخش‌کننده متوقف است.

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

format-disconnected:
نوع: رشته (string)
پیش‌فرض: "disconnected"
اطلاعات نمایش‌داده‌شده زمانی که سرور MPD در دسترس نیست.

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

tooltip-format:
نوع: رشته (string)
پیش‌فرض: "MPD (connected)"
اطلاعات راهنمای شناور نمایش‌داده‌شده هنگام اتصال به MPD.

tooltip-format-disconnected:
نوع: رشته (string)
پیش‌فرض: "MPD (disconnected)"
اطلاعات راهنمای شناور نمایش‌داده‌شده زمانی که سرور MPD در دسترس نیست.

artist-len:
نوع: عدد صحیح (integer)
حداکثر طول برچسب هنرمند (Artist).

album-len:
نوع: عدد صحیح (integer)
حداکثر طول برچسب آلبوم (Album).

album-artist-len:
نوع: عدد صحیح (integer)
حداکثر طول برچسب هنرمند آلبوم (Album Artist).

title-len:
نوع: عدد صحیح (integer)
حداکثر طول برچسب عنوان (Title).

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

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

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

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

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

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)
آستانه مورد استفاده هنگام پیمایش روان.

state-icons:
نوع: شیء (object)
پیش‌فرض: {}
آیکون نمایشی بسته به وضعیت پخش/مکث پخش‌کننده ({ "playing": "...", "paused": "..." }).

consume-icons:
نوع: شیء (object)
پیش‌فرض: {}
آیکون نمایشی بسته به گزینه «مصرف» (consume) ({ "on": "...", "off": "..." }).

random-icons:
نوع: شیء (object)
پیش‌فرض: {}
آیکون نمایشی بسته به گزینه «تصادفی» (random) ({ "on": "...", "off": "..." }).

repeat-icons:
نوع: شیء (object)
پیش‌فرض: {}
آیکون نمایشی بسته به گزینه «تکرار» (repeat) ({ "on": "...", "off": "..." }).

single-icons:
نوع: شیء (object)
پیش‌فرض: {}
آیکون نمایشی بسته به گزینه «تک‌آهنگ» (single) ({ "on": "...", "off": "..." }).

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

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

GtkMenu با شناسه menu وجود داشته باشد.

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

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

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

هنگام پخش/مکث (WHEN PLAYING/PAUSED)

{artist}: هنرمند آهنگ فعلی.

{albumArtist}: هنرمند آلبوم فعلی.

{album}: آلبوم آهنگ فعلی.

{title}: عنوان آهنگ فعلی.

{date}: تاریخ آهنگ فعلی.

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

{elapsedTime}: موقعیت زمانی فعلی آهنگ. برای قالب‌بندی به عنوان تاریخ/زمان (به نمونه پیکربندی مراجعه کنید).

{totalTime}: مدت‌زمان کل آهنگ فعلی. برای قالب‌بندی به عنوان تاریخ/زمان (به نمونه پیکربندی مراجعه کنید).

{songPosition}: موقعیت آهنگ فعلی در صف پخش.

{queueLength}: طول صف پخش فعلی.

{uri}: شناسه منبع یکپارچه (URI) آهنگ نسبت به دایرکتوری موسیقی MPD.

{filename}: بخش پایانی URI (نام فایل).

{stateIcon}: آیکون متناظر با وضعیت پخش یا مکث پخش‌کننده (گزینه state-icons را ببینید).

{consumeIcon}: آیکون متناظر با گزینه «مصرف» (گزینه consume-icons را ببینید).

{randomIcon}: آیکون متناظر با گزینه «تصادفی» (گزینه random-icons را ببینید).

{repeatIcon}: آیکون متناظر با گزینه «تکرار» (گزینه repeat-icons را ببینید).

{singleIcon}: آیکون متناظر با گزینه «تک‌آهنگ» (گزینه single-icons را ببینید).

هنگام توقف (WHEN STOPPED)

{consumeIcon}: آیکون متناظر با گزینه «مصرف» (گزینه consume-icons را ببینید).

{randomIcon}: آیکون متناظر با گزینه «تصادفی» (گزینه random-icons را ببینید).

{repeatIcon}: آیکون متناظر با گزینه «تکرار» (گزینه repeat-icons را ببینید).

{singleIcon}: آیکون متناظر با گزینه «تک‌آهنگ» (گزینه single-icons را ببینید).

هنگام قطع ارتباط (WHEN DISCONNECTED)

در حال حاضر، هیچ جایگزین قالبی هنگام قطع ارتباط وجود ندارد.

مثال‌ها (EXAMPLES)

"mpd": {
	"format": "{stateIcon} {consumeIcon}{randomIcon}{repeatIcon}{singleIcon}{artist} - {album} - {title} ({elapsedTime:%M:%S}/{totalTime:%M:%S}) ",
	"format-disconnected": "Disconnected ",
	"format-stopped": "{consumeIcon}{randomIcon}{repeatIcon}{singleIcon}Stopped ",
	"interval": 2,
	"consume-icons": {
		"on": " " // Icon shows only when "consume" is on
	},
	"random-icons": {
		"off": "<span color="#f53c3c"></span> ", // Icon grayed out when "random" is off
		"on": " "
	},
	"repeat-icons": {
		"on": " "
	},
	"single-icons": {
		"on": "1 "
	},
	"state-icons": {
		"paused": "",
		"playing": ""
	},
	"tooltip-format": "MPD (connected)",
	"tooltip-format-disconnected": "MPD (disconnected)"
}

استایل (STYLE)

#mpd
#mpd.disconnected
#mpd.stopped
#mpd.playing
#mpd.paused