waybar-mpd(5)                 File Formats Manual                waybar-mpd(5)

نام (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

                                  2026-08-31                     waybar-mpd(5)