MPD.CONF(5) Music Player Daemon MPD.CONF(5)

mpd.conf - پرونده پیکربندی دیمن پخش‌کننده موسیقی (Music Player Daemon)

mpd.conf پرونده پیکربندی برای mpd(1) است.

معمولاً این پرونده در مسیر /etc/mpd.conf قرار دارد، مگر اینکه مسیر دیگری در خط فرمان مشخص شده باشد.

اگر MPD را به عنوان یک دیمن کاربری اجرا کنید (نه به عنوان دیمن سیستمی)، پیکربندی از مسیر $XDG_CONFIG_HOME/mpd/mpd.conf (معمولاً ~/.config/mpd/mpd.conf) خوانده می‌شود. در اندروید، mpd.conf از دایرکتوری سطح بالای پارتیشن داده بارگذاری خواهد شد.

هر خط در پرونده پیکربندی شامل نام یک تنظیم و مقدار آن است، به عنوان مثال:

connection_timeout "5"

خطوطی که با # شروع می‌شوند به عنوان کامنت در نظر گرفته شده و نادیده گرفته می‌شوند.

برای تنظیماتی که یک مسیر در فایل‌سیستم را مشخص می‌کنند، علامت مدک (~) به $HOME بسط داده می‌شود. علاوه بر این، بسط‌های مسیر زیر نیز پشتیبانی می‌شوند:

  • $HOME
  • $XDG_CONFIG_HOME
  • $XDG_MUSIC_DIR
  • $XDG_CACHE_HOME
  • $XDG_RUNTIME_DIR

مثال:

music_directory "~/Music"
db_file "$XDG_CONFIG_HOME/mpd/database"

برخی از تنظیمات در بلوک‌هایی با براکت‌های مجعد گروه‌بندی می‌شوند، مانند تنظیمات به ازای هر افزونه (per-plugin):

audio_output {
    type "alsa"
    name "My ALSA output"
    device "iec958:CARD=Intel,DEV=0"
    mixer_control "PCM"
}

دستورالعمل include می‌تواند برای گنجاندن تنظیمات از یک پرونده دیگر استفاده شود؛ نام پرونده داده‌شده نسبت به پرونده جاری سنجیده می‌شود:

include "other.conf"

در صورتی که بخواهید پرونده گنجانده‌شده اختیاری باشد، می‌توانید از include_optional استفاده کنید؛ در این صورت اگر پرونده وجود نداشته باشد، این دستورالعمل نادیده گرفته می‌شود:

include_optional "may_not_exist.conf"

برای مشاهده نمونه پرونده پیکربندی، docs/mpdconf.example را در تاربال سورس کد ببینید.

این راهنما کامل نیست و تنها مهم‌ترین گزینه‌ها را فهرست می‌کند. لطفاً برای راهنمای جامع پیکربندی، راهنمای کاربری MPD را مطالعه کنید: http://www.musicpd.org/doc/user

نوع
NAME

در صورت تنظیم، کاربری را که MPD در قالب آن اجرا خواهد شد مشخص می‌کند. MPD هرگز نباید در قالب ریشه (root) اجرا شود، و می‌توانید از این گزینه استفاده کنید تا MPD شناسه کاربری (UID) خود را پس از مقداردهی اولیه تغییر دهد. اگر MPD را به عنوان یک کاربر بدون دسترسی ممتاز اجرا می‌کنید، از این گزینه استفاده نکنید.

نوع
NAME

تغییر به این گروه. این کار تمام گروه‌های پیش‌فرض را کنار گذاشته و تنها از این گروه استفاده می‌کند. از این تنظیم استفاده نکنید.

نوع
PATH

پرونده‌ای را برای ذخیره شناسه فرایند (PID) دیمن mpd مشخص می‌کند.

نوع
PATH

محل قرارگیری پرونده لاگ را مشخص می‌کند. مقدار ویژه "syslog" باعث می‌شود MPD از دیمن محلی syslog استفاده کند.

نوع
LEVEL
پیش‌فرض
notice

تمام پیام‌های پایین‌تر از آستانه مشخص‌شده را نادیده می‌گیرد. سطوح لاگ زیر در دسترس هستند:

  • error: خطاها
  • warning: هشدارها
  • notice: پیام‌های اطلاعاتی مهم
  • info: پیام‌های اطلاعاتی کم‌اهمیت
  • verbose: پیام‌های اشکال‌زدایی (برای توسعه‌دهندگان و عیب‌یابی)

نوع
number
پیش‌فرض
6600

درگاهی (port) را مشخص می‌کند که mpd روی آن به درخواست‌ها گوش می‌دهد.

نوع
PATH

محل ذخیره‌سازی پرونده پایگاه‌داده را مشخص می‌کند.

نوع
PATH

محل پایگاه‌داده برچسب‌ها (sticker database). این پایگاه‌داده‌ای است که اطلاعات پویا و متصل به آهنگ‌ها را مدیریت می‌کند.

نوع
PATH

دایرکتوری حاوی موسیقی‌ها را مشخص می‌کند. اگر این گزینه را پیکربندی نکنید، تنها قادر به پخش استریم‌ها خواهید بود.

نوع
PATH

دایرکتوری ذخیره لیست‌های پخش ذخیره‌شده را مشخص می‌کند (ساختار تخت، بدون زیردایرکتوری). اگر این گزینه را پیکربندی نکنید، امکان ذخیره لیست‌های پخش را نخواهید داشت.

نوع
PATH

مشخص می‌کند که آیا از یک پرونده وضعیت استفاده شود و در کجا قرار گیرد. هنگامی که mpd با سیگنال TERM یا دستور kill خاتمه یابد، وضعیت mpd در این پرونده ذخیره خواهد شد. با راه‌اندازی مجدد mpd، این پرونده وضعیت خوانده شده و وضعیت mpd (از جمله لیست پخش) بازیابی می‌شود.

نوع
yes یا no
پیش‌فرض
yes

کنترل می‌کند که آیا MPD پیوندهای نمادینی (symlinks) را که به بیرون از دایرکتوری موسیقی اشاره دارند دنبال کند یا خیر. پس از تغییر این گزینه باید پایگاه‌داده را دوباره ایجاد کنید.

نوع
yes یا no
پیش‌فرض
yes

کنترل می‌کند که آیا MPD پیوندهای نمادینی را که به درون دایرکتوری موسیقی اشاره دارند دنبال کند یا خیر، که ممکن است مواردی تکراری به پایگاه‌داده اضافه کند. پس از تغییر این گزینه باید پایگاه‌داده را دوباره ایجاد کنید.

نوع
yes یا no
پیش‌فرض
no

پشتیبانی از به‌روزرسانی خودکار پایگاه‌داده موسیقی را هنگام تغییر پرونده‌ها در music_directory مشخص می‌کند. (تنها در لینوکس پیاده‌سازی شده است.)

نوع
number
پیش‌فرض
unlimited

عمق دایرکتوری‌های تحت نظر را محدود می‌کند؛ مقدار 0 به معنای نظارت بر خود دایرکتوری موسیقی به تنهایی است.

نوع
yes یا no
پیش‌فرض
no

مشخص می‌کند که هنگام ذخیره لیست‌های پخش، آیا مسیرهای نسبی برای نام پرونده‌های آهنگ‌ها استفاده شوند یا مسیرهای مطلق.

نوع
CHARSET

مجموعه نویسه‌های (character set) استفاده‌شده برای فایل‌سیستم را مشخص می‌کند. فهرستی از مجموعه‌های نویسه پشتیبانی‌شده را می‌توان با اجرای "iconv -l" به دست آورد. مقدار پیش‌فرض از محلی‌سازی (locale) هنگام ایجاد اولیه پایگاه‌داده تعیین می‌شود.

نوع
yes یا no
پیش‌فرض
no

قرار دادن MPD در حالت مکث به جای شروع خودکار پخش پس از راه‌اندازی.

نوع
yes یا no
پیش‌فرض
yes

اگر مقدار yes باشد و MPD با پشتیبانی از Avahi یا Bonjour کامپایل شده باشد، اطلاعات سرویس از طریق Zeroconf منتشر خواهد شد.

نوع
NAME
پیش‌فرض
Music Player @ %h

اگر Zeroconf فعال باشد، این نام سرویس برای انتشار است. این نام باید در شبکه محلی شما یکتا باشد، اما تداخل نام‌ها نیز به درستی مدیریت خواهد شد. %h با نام میزبان دستگاه اجراکننده MPD جایگزین می‌شود.

بخش DESCRIPTION و بخش‌های گوناگون AUDIO OUTPUT OPTIONS را برای ساختار این بلوک ببینید. چندین بخش audio_output می‌تواند مشخص شود. اگر هیچ بخش audio_output مشخص نشود، MPD برای یافتن یک خروجی صوتی قابل استفاده جستجو می‌کند.

نوع
NAME

نوع خروجی صوتی را مشخص می‌کند. برای مقادیر ممکن، فهرست خروجی‌های پشتیبانی‌شده را در mpd --version ببینید.

نوع
NAME

نامی یکتا برای خروجی صوتی مشخص می‌کند.

:نوع: ``sample_rate:bits:channels``
نرخ نمونه‌برداری، بیت بر نمونه و تعداد کانال‌های صوتی ارسالی به دستگاه خروجی صوتی را مشخص می‌کند. برای جزئیات بیشتر مستندات گزینه audio_output_format را ببینید. پیش‌فرض این است که از هر قالب صوتی ارائه‌شده به خروجی صدا استفاده شود. هر یک از این سه مشخصه می‌تواند یک ستاره (*) باشد تا نشان دهد نباید محدودیتی بر آن مشخصه اعمال شود.
نوع
software، mixer یا none
پیش‌فرض
software

نحوه اعمال replay gain را مشخص می‌کند. مقدار software از کنترل نرم‌افزاری داخلی بلندی صدا استفاده می‌کند. مقدار mixer از کنترل میکسر (سخت‌افزاری) پیکربندی‌شده بهره می‌برد. مقدار none قابلیت replay gain را روی این خروجی صوتی غیرفعال می‌سازد.

نوع
hardware، software یا none
پیش‌فرض
hardware (در صورت پشتیبانی) یا none

مشخص می‌کند کدام میکسر باید برای این خروجی صوتی استفاده شود: میکسر سخت‌افزاری (در دسترس برای ALSA، OSS و PulseAudio)، میکسر نرم‌افزاری یا بدون میکسر (none).

$XDG_CONFIG_HOME/mpd/mpd.conf
پرونده پیکربندی کاربر (معمولاً ~/.config/mpd/mpd.conf).
/etc/mpd.conf
پرونده پیکربندی سراسری سیستم.

mpd(1), mpc(1)

Max Kellermann

2003-2025 The Music Player Daemon Project

August 28, 2026 0.24.15