.\" 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\-mpd" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar\-mpd \- ماژول mpd در waybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBmpd\fR اطلاعات مربوط به یک نمونه در حال اجرای «Music Player Daemon» را نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
با نام \fBmpd\fR آدرس‌دهی می‌شود.
.PP
\fBserver\fR:
.br
نوع: رشته (string)
.br
آدرس شبکه یا مسیر سوکت یونیکس سرور MPD.\& در صورت خالی بودن، به میزبان پیش‌فرض متصل می‌شود.\&
.PP
\fBport\fR:
.br
نوع: عدد صحیح (integer)
.br
درگاهی که MPD به آن گوش می‌دهد.\& در صورت خالی بودن، از درگاه پیش‌فرض استفاده می‌شود.\&
.PP
\fBpassword\fR:
.br
نوع: رشته (string)
.br
گذرواژه مورد نیاز برای اتصال به سرور MPD.\& در صورت خالی بودن، هیچ گذرواژه‌ای به MPD ارسال نمی‌شود.\&
.PP
\fBinterval\fR:
.br
نوع: عدد صحیح (integer)
.br
پیش‌فرض: 5
.br
بازه زمانی (بر حسب ثانیه) که در آن تلاش مجدد برای اتصال به سرور MPD انجام می‌شود.\&
.PP
\fBtimeout\fR:
.br
نوع: عدد صحیح (integer)
.br
پیش‌فرض: 30
.br
مهلت زمانی اتصال (بر حسب ثانیه).\& اگر سرور MPD شما دارای تنظیم \fBconnection_timeout\fR پایینی است، این مقدار را تغییر دهید.\&
.PP
\fBunknown\-tag\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: "N/A"
.br
متنی که هنگام نبود یک برچسب در آهنگ فعلی، اما استفاده از آن در \fBformat\fR نمایش داده می‌شود.\&
.PP
\fBformat\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: "{album} \- {artist} \- {title}"
.br
اطلاعات نمایش‌داده‌شده هنگام پخش آهنگ.\&
.PP
\fBformat\-stopped\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: "stopped"
.br
اطلاعات نمایش‌داده‌شده هنگامی که پخش‌کننده متوقف است.\&
.PP
\fBformat\-paused\fR:
.br
نوع: رشته (string)
.br
این قالب زمانی استفاده می‌شود که آهنگ موقتاً متوقف (مکث) شده باشد.\&
.PP
\fBformat\-disconnected\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: "disconnected"
.br
اطلاعات نمایش‌داده‌شده زمانی که سرور MPD در دسترس نیست.\&
.PP
\fBtooltip\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: true
.br
گزینه‌ای برای غیرفعال کردن راهنمای شناور هنگام قرار گرفتن نشانگر ماوس روی ماژول.\&
.PP
\fBtooltip\-format\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: "MPD (connected)"
.br
اطلاعات راهنمای شناور نمایش‌داده‌شده هنگام اتصال به MPD.\&
.PP
\fBtooltip\-format\-disconnected\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: "MPD (disconnected)"
.br
اطلاعات راهنمای شناور نمایش‌داده‌شده زمانی که سرور MPD در دسترس نیست.\&
.PP
\fBartist\-len\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول برچسب هنرمند (Artist).\&
.PP
\fBalbum\-len\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول برچسب آلبوم (Album).\&
.PP
\fBalbum\-artist\-len\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول برچسب هنرمند آلبوم (Album Artist).\&
.PP
\fBtitle\-len\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول برچسب عنوان (Title).\&
.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
دستوری که هنگام کلیک روی ماژول اجرا می‌شود.\&
.PP
\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
دستوری که هنگام پیمایش به بالا (اسکرول) روی ماژول اجرا می‌شود.\&
.PP
\fBon\-scroll\-down\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام پیمایش به پایین روی ماژول اجرا می‌شود.\&
.PP
\fBsmooth\-scrolling\-threshold\fR:
.br
نوع: ممیز شناور با دقت مضاعف (double)
.br
آستانه مورد استفاده هنگام پیمایش روان.\&
.PP
\fBstate\-icons\fR:
.br
نوع: شیء (object)
.br
پیش‌فرض: {}
.br
آیکون نمایشی بسته به وضعیت پخش/مکث پخش‌کننده (\fB{ "playing": ".\&.\&.\&", "paused": ".\&.\&.\&" }\fR).\&
.PP
\fBconsume\-icons\fR:
.br
نوع: شیء (object)
.br
پیش‌فرض: {}
.br
آیکون نمایشی بسته به گزینه «مصرف» (consume) (\fB{ "on": ".\&.\&.\&", "off": ".\&.\&.\&" }\fR).\&
.PP
\fBrandom\-icons\fR:
.br
نوع: شیء (object)
.br
پیش‌فرض: {}
.br
آیکون نمایشی بسته به گزینه «تصادفی» (random) (\fB{ "on": ".\&.\&.\&", "off": ".\&.\&.\&" }\fR).\&
.PP
\fBrepeat\-icons\fR:
.br
نوع: شیء (object)
.br
پیش‌فرض: {}
.br
آیکون نمایشی بسته به گزینه «تکرار» (repeat) (\fB{ "on": ".\&.\&.\&", "off": ".\&.\&.\&" }\fR).\&
.PP
\fBsingle\-icons\fR:
.br
نوع: شیء (object)
.br
پیش‌فرض: {}
.br
آیکون نمایشی بسته به گزینه «تک‌آهنگ» (single) (\fB{ "on": ".\&.\&.\&", "off": ".\&.\&.\&" }\fR).\&
.PP
\fBmenu\fR:
.br
نوع: رشته (string)
.br
عملیاتی که منو را باز می‌کند.\&
.PP
\fBmenu\-file\fR:
.br
نوع: رشته (string)
.br
محل فایل توصیف‌کننده منو.\& باید عنصری از نوع
.RS 4
GtkMenu با شناسه \fBmenu\fR وجود داشته باشد.
.PP
.RE
\fBmenu\-actions\fR:
.br
نوع: آرایه (array)
.br
عملیات متناظر با دکمه‌های منو.\&
.PP
\fBexpand\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
به این ماژول اجازه می‌دهد تمام فضای باقی‌مانده را به صورت پویا اشغال کند.\&
.PP
.SH "جایگزین‌های قالب‌بندی (FORMAT REPLACEMENTS)"
.PP
.SS "هنگام پخش/مکث (WHEN PLAYING/PAUSED)"
.PP
\fB{artist}\fR: هنرمند آهنگ فعلی.\&
.PP
\fB{albumArtist}\fR: هنرمند آلبوم فعلی.\&
.PP
\fB{album}\fR: آلبوم آهنگ فعلی.\&
.PP
\fB{title}\fR: عنوان آهنگ فعلی.\&
.PP
\fB{date}\fR: تاریخ آهنگ فعلی.\&
.PP
\fB{volume}\fR: میزان صدای فعلی بر حسب درصد.\&
.PP
\fB{elapsedTime}\fR: موقعیت زمانی فعلی آهنگ.\& برای قالب‌بندی به عنوان تاریخ/زمان (به نمونه پیکربندی مراجعه کنید).\&
.PP
\fB{totalTime}\fR: مدت‌زمان کل آهنگ فعلی.\& برای قالب‌بندی به عنوان تاریخ/زمان (به نمونه پیکربندی مراجعه کنید).\&
.PP
\fB{songPosition}\fR: موقعیت آهنگ فعلی در صف پخش.\&
.PP
\fB{queueLength}\fR: طول صف پخش فعلی.\&
.PP
\fB{uri}\fR: شناسه منبع یکپارچه (URI) آهنگ نسبت به دایرکتوری موسیقی MPD.\&
.PP
\fB{filename}\fR: بخش پایانی URI (نام فایل).\&
.PP
\fB{stateIcon}\fR: آیکون متناظر با وضعیت پخش یا مکث پخش‌کننده (گزینه \fBstate\-icons\fR را ببینید).\&
.PP
\fB{consumeIcon}\fR: آیکون متناظر با گزینه «مصرف» (گزینه \fBconsume\-icons\fR را ببینید).\&
.PP
\fB{randomIcon}\fR: آیکون متناظر با گزینه «تصادفی» (گزینه \fBrandom\-icons\fR را ببینید).\&
.PP
\fB{repeatIcon}\fR: آیکون متناظر با گزینه «تکرار» (گزینه \fBrepeat\-icons\fR را ببینید).\&
.PP
\fB{singleIcon}\fR: آیکون متناظر با گزینه «تک‌آهنگ» (گزینه \fBsingle\-icons\fR را ببینید).\&
.PP
.PP
.SS "هنگام توقف (WHEN STOPPED)"
.PP
\fB{consumeIcon}\fR: آیکون متناظر با گزینه «مصرف» (گزینه \fBconsume\-icons\fR را ببینید).\&
.PP
\fB{randomIcon}\fR: آیکون متناظر با گزینه «تصادفی» (گزینه \fBrandom\-icons\fR را ببینید).\&
.PP
\fB{repeatIcon}\fR: آیکون متناظر با گزینه «تکرار» (گزینه \fBrepeat\-icons\fR را ببینید).\&
.PP
\fB{singleIcon}\fR: آیکون متناظر با گزینه «تک‌آهنگ» (گزینه \fBsingle\-icons\fR را ببینید).\&
.PP
.SS "هنگام قطع ارتباط (WHEN DISCONNECTED)"
.PP
در حال حاضر، هیچ جایگزین قالبی هنگام قطع ارتباط وجود ندارد.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"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)"
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#mpd\fR
.IP \(bu 4
\fB#mpd.\&disconnected\fR
.IP \(bu 4
\fB#mpd.\&stopped\fR
.IP \(bu 4
\fB#mpd.\&playing\fR
.IP \(bu 4
\fB#mpd.\&paused\fR