.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "MPD.CONF" "5" "Aug 28, 2026" "0.24.15" "Music Player Daemon"
.SH "نام (NAME)"
mpd.conf \- پرونده پیکربندی دیمن پخش‌کننده موسیقی (Music Player Daemon)
.SH "توضیحات (DESCRIPTION)"
.sp
\fBmpd.conf\fP پرونده پیکربندی برای \fBmpd(1)\fP است.
.sp
معمولاً این پرونده در مسیر \fB/etc/mpd.conf\fP قرار دارد، مگر اینکه مسیر دیگری در خط فرمان مشخص شده باشد.
.sp
اگر \fBMPD\fP را به عنوان یک دیمن کاربری اجرا کنید (نه به عنوان دیمن سیستمی)، پیکربندی از مسیر
\fB$XDG_CONFIG_HOME/mpd/mpd.conf\fP (معمولاً
\fB~/.config/mpd/mpd.conf\fP) خوانده می‌شود. در اندروید، \fBmpd.conf\fP از دایرکتوری سطح بالای پارتیشن داده بارگذاری خواهد شد.
.sp
هر خط در پرونده پیکربندی شامل نام یک تنظیم و مقدار آن است، به عنوان مثال:
.sp
\fBconnection_timeout \(dq5\(dq\fP
.sp
خطوطی که با \fB#\fP شروع می‌شوند به عنوان کامنت در نظر گرفته شده و نادیده گرفته می‌شوند.
.sp
برای تنظیماتی که یک مسیر در فایل‌سیستم را مشخص می‌کنند، علامت مدک (\fB~\fP) به \fB$HOME\fP بسط داده می‌شود. علاوه بر این، بسط‌های مسیر زیر نیز پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fB$HOME\fP
.IP \(bu 2
\fB$XDG_CONFIG_HOME\fP
.IP \(bu 2
\fB$XDG_MUSIC_DIR\fP
.IP \(bu 2
\fB$XDG_CACHE_HOME\fP
.IP \(bu 2
\fB$XDG_RUNTIME_DIR\fP
.UNINDENT
.sp
مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
music_directory \(dq~/Music\(dq
db_file \(dq$XDG_CONFIG_HOME/mpd/database\(dq
.EE
.UNINDENT
.UNINDENT
.sp
برخی از تنظیمات در بلوک‌هایی با براکت‌های مجعد گروه‌بندی می‌شوند، مانند تنظیمات به ازای هر افزونه (per-plugin):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
audio_output {
    type \(dqalsa\(dq
    name \(dqMy ALSA output\(dq
    device \(dqiec958:CARD=Intel,DEV=0\(dq
    mixer_control \(dqPCM\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستورالعمل \fBinclude\fP می‌تواند برای گنجاندن تنظیمات از یک پرونده دیگر استفاده شود؛ نام پرونده داده‌شده نسبت به پرونده جاری سنجیده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
include \(dqother.conf\(dq
.EE
.UNINDENT
.UNINDENT
.sp
در صورتی که بخواهید پرونده گنجانده‌شده اختیاری باشد، می‌توانید از \fBinclude_optional\fP استفاده کنید؛ در این صورت اگر پرونده وجود نداشته باشد، این دستورالعمل نادیده گرفته می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
include_optional \(dqmay_not_exist.conf\(dq
.EE
.UNINDENT
.UNINDENT
.sp
برای مشاهده نمونه پرونده پیکربندی، \fBdocs/mpdconf.example\fP را در تاربال سورس کد ببینید.
.sp
این راهنما کامل نیست و تنها مهم‌ترین گزینه‌ها را فهرست می‌کند.
لطفاً برای راهنمای جامع پیکربندی، راهنمای کاربری MPD را مطالعه کنید:
\%<http://\:www\:.musicpd\:.org/\:doc/\:user>
.SH "تنظیمات عمومی (GLOBAL SETTINGS)"
.SS "تنظیمات سیستم (System Settings)"
.INDENT 0.0
.TP
.B user
.INDENT 7.0
.TP
.B نوع
NAME
.UNINDENT
.sp
در صورت تنظیم، کاربری را که MPD در قالب آن اجرا خواهد شد مشخص می‌کند. MPD هرگز نباید در قالب ریشه (root) اجرا شود، و می‌توانید از این گزینه استفاده کنید تا MPD شناسه کاربری (UID) خود را پس از مقداردهی اولیه تغییر دهد. اگر MPD را به عنوان یک کاربر بدون دسترسی ممتاز اجرا می‌کنید، از این گزینه استفاده نکنید.
.UNINDENT
.INDENT 0.0
.TP
.B group
.INDENT 7.0
.TP
.B نوع
NAME
.UNINDENT
.sp
تغییر به این گروه. این کار تمام گروه‌های پیش‌فرض را کنار گذاشته و تنها از این گروه استفاده می‌کند. از این تنظیم استفاده نکنید.
.UNINDENT
.INDENT 0.0
.TP
.B pid_file
.INDENT 7.0
.TP
.B نوع
PATH
.UNINDENT
.sp
پرونده‌ای را برای ذخیره شناسه فرایند (PID) دیمن mpd مشخص می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B log_file
.INDENT 7.0
.TP
.B نوع
PATH
.UNINDENT
.sp
محل قرارگیری پرونده لاگ را مشخص می‌کند. مقدار ویژه \(dqsyslog\(dq باعث می‌شود MPD از دیمن محلی syslog استفاده کند.
.UNINDENT
.INDENT 0.0
.TP
.B log_level
.INDENT 7.0
.TP
.B نوع
LEVEL
.TP
.B پیش‌فرض
\fBnotice\fP
.UNINDENT
.sp
تمام پیام‌های پایین‌تر از آستانه مشخص‌شده را نادیده می‌گیرد. سطوح لاگ زیر در دسترس هستند:
.INDENT 7.0
.IP \(bu 2
\fBerror\fP: خطاها
.IP \(bu 2
\fBwarning\fP: هشدارها
.IP \(bu 2
\fBnotice\fP: پیام‌های اطلاعاتی مهم
.IP \(bu 2
\fBinfo\fP: پیام‌های اطلاعاتی کم‌اهمیت
.IP \(bu 2
\fBverbose\fP: پیام‌های اشکال‌زدایی (برای توسعه‌دهندگان و عیب‌یابی)
.UNINDENT
.UNINDENT
.SS "تنظیمات کارخواه (Client Settings)"
.INDENT 0.0
.TP
.B port
.INDENT 7.0
.TP
.B نوع
number
.TP
.B پیش‌فرض
\fB6600\fP
.UNINDENT
.sp
درگاهی (port) را مشخص می‌کند که mpd روی آن به درخواست‌ها گوش می‌دهد.
.UNINDENT
.SS "تنظیمات پرونده (File Settings)"
.INDENT 0.0
.TP
.B db_file
.INDENT 7.0
.TP
.B نوع
PATH
.UNINDENT
.sp
محل ذخیره‌سازی پرونده پایگاه‌داده را مشخص می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B sticker_file
.INDENT 7.0
.TP
.B نوع
PATH
.UNINDENT
.sp
محل پایگاه‌داده برچسب‌ها (sticker database). این پایگاه‌داده‌ای است که اطلاعات پویا و متصل به آهنگ‌ها را مدیریت می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B music_directory
.INDENT 7.0
.TP
.B نوع
PATH
.UNINDENT
.sp
دایرکتوری حاوی موسیقی‌ها را مشخص می‌کند. اگر این گزینه را پیکربندی نکنید، تنها قادر به پخش استریم‌ها خواهید بود.
.UNINDENT
.INDENT 0.0
.TP
.B playlist_directory
.INDENT 7.0
.TP
.B نوع
PATH
.UNINDENT
.sp
دایرکتوری ذخیره لیست‌های پخش ذخیره‌شده را مشخص می‌کند (ساختار تخت، بدون زیردایرکتوری). اگر این گزینه را پیکربندی نکنید، امکان ذخیره لیست‌های پخش را نخواهید داشت.
.UNINDENT
.INDENT 0.0
.TP
.B state_file
.INDENT 7.0
.TP
.B نوع
PATH
.UNINDENT
.sp
مشخص می‌کند که آیا از یک پرونده وضعیت استفاده شود و در کجا قرار گیرد. هنگامی که mpd با سیگنال TERM یا دستور \fBkill\fP خاتمه یابد، وضعیت mpd در این پرونده ذخیره خواهد شد. با راه‌اندازی مجدد mpd، این پرونده وضعیت خوانده شده و وضعیت mpd (از جمله لیست پخش) بازیابی می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B follow_outside_symlinks
.INDENT 7.0
.TP
.B نوع
\fByes\fP یا \fBno\fP
.TP
.B پیش‌فرض
\fByes\fP
.UNINDENT
.sp
کنترل می‌کند که آیا MPD پیوندهای نمادینی (symlinks) را که به بیرون از دایرکتوری موسیقی اشاره دارند دنبال کند یا خیر. پس از تغییر این گزینه باید پایگاه‌داده را دوباره ایجاد کنید.
.UNINDENT
.INDENT 0.0
.TP
.B follow_inside_symlinks
.INDENT 7.0
.TP
.B نوع
\fByes\fP یا \fBno\fP
.TP
.B پیش‌فرض
\fByes\fP
.UNINDENT
.sp
کنترل می‌کند که آیا MPD پیوندهای نمادینی را که به درون دایرکتوری موسیقی اشاره دارند دنبال کند یا خیر، که ممکن است مواردی تکراری به پایگاه‌داده اضافه کند. پس از تغییر این گزینه باید پایگاه‌داده را دوباره ایجاد کنید.
.UNINDENT
.INDENT 0.0
.TP
.B auto_update
.INDENT 7.0
.TP
.B نوع
\fByes\fP یا \fBno\fP
.TP
.B پیش‌فرض
\fBno\fP
.UNINDENT
.sp
پشتیبانی از به‌روزرسانی خودکار پایگاه‌داده موسیقی را هنگام تغییر پرونده‌ها در music_directory مشخص می‌کند.
(تنها در لینوکس پیاده‌سازی شده است.)
.UNINDENT
.INDENT 0.0
.TP
.B auto_update_depth
.INDENT 7.0
.TP
.B نوع
number
.TP
.B پیش‌فرض
unlimited
.UNINDENT
.sp
عمق دایرکتوری‌های تحت نظر را محدود می‌کند؛ مقدار 0 به معنای نظارت بر خود دایرکتوری موسیقی به تنهایی است.
.UNINDENT
.INDENT 0.0
.TP
.B save_absolute_paths_in_playlists
.INDENT 7.0
.TP
.B نوع
\fByes\fP یا \fBno\fP
.TP
.B پیش‌فرض
\fBno\fP
.UNINDENT
.sp
مشخص می‌کند که هنگام ذخیره لیست‌های پخش، آیا مسیرهای نسبی برای نام پرونده‌های آهنگ‌ها استفاده شوند یا مسیرهای مطلق.
.UNINDENT
.INDENT 0.0
.TP
.B filesystem_charset
.INDENT 7.0
.TP
.B نوع
CHARSET
.UNINDENT
.sp
مجموعه نویسه‌های (character set) استفاده‌شده برای فایل‌سیستم را مشخص می‌کند. فهرستی از مجموعه‌های نویسه پشتیبانی‌شده را می‌توان با اجرای \(dqiconv \-l\(dq به دست آورد. مقدار پیش‌فرض از محلی‌سازی (locale) هنگام ایجاد اولیه پایگاه‌داده تعیین می‌شود.
.UNINDENT
.SS "تنظیمات پخش‌کننده (Player Settings)"
.INDENT 0.0
.TP
.B restore_paused
.INDENT 7.0
.TP
.B نوع
\fByes\fP یا \fBno\fP
.TP
.B پیش‌فرض
\fBno\fP
.UNINDENT
.sp
قرار دادن MPD در حالت مکث به جای شروع خودکار پخش پس از راه‌اندازی.
.UNINDENT
.SS "سایر تنظیمات (Other Settings)"
.INDENT 0.0
.TP
.B zeroconf_enabled
.INDENT 7.0
.TP
.B نوع
\fByes\fP یا \fBno\fP
.TP
.B پیش‌فرض
\fByes\fP
.UNINDENT
.sp
اگر مقدار yes باشد و MPD با پشتیبانی از Avahi یا Bonjour کامپایل شده باشد، اطلاعات سرویس از طریق Zeroconf منتشر خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B zeroconf_name
.INDENT 7.0
.TP
.B نوع
NAME
.TP
.B پیش‌فرض
\fBMusic Player @ %h\fP
.UNINDENT
.sp
اگر Zeroconf فعال باشد، این نام سرویس برای انتشار است. این نام باید در شبکه محلی شما یکتا باشد، اما تداخل نام‌ها نیز به درستی مدیریت خواهد شد. \fB%h\fP با نام میزبان دستگاه اجراکننده MPD جایگزین می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B audio_output
بخش DESCRIPTION و بخش‌های گوناگون \fBAUDIO OUTPUT OPTIONS\fP را برای ساختار این بلوک ببینید. چندین بخش audio_output می‌تواند مشخص شود. اگر هیچ بخش audio_output مشخص نشود، MPD برای یافتن یک خروجی صوتی قابل استفاده جستجو می‌کند.
.UNINDENT
.SH "تنظیمات الزامی خروجی صوتی (REQUIRED AUDIO OUTPUT SETTINGS)"
.INDENT 0.0
.TP
.B type
.INDENT 7.0
.TP
.B نوع
NAME
.UNINDENT
.sp
نوع خروجی صوتی را مشخص می‌کند. برای مقادیر ممکن، فهرست خروجی‌های پشتیبانی‌شده را در \fBmpd \-\-version\fP ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B name
.INDENT 7.0
.TP
.B نوع
NAME
.UNINDENT
.sp
نامی یکتا برای خروجی صوتی مشخص می‌کند.
.UNINDENT
.SH "تنظیمات اختیاری خروجی صوتی (OPTIONAL AUDIO OUTPUT SETTINGS)"
.INDENT 0.0
.TP
.B format
.TP
.B :نوع: \(ga\(gasample_rate:bits:channels\(ga\(ga
نرخ نمونه‌برداری، بیت بر نمونه و تعداد کانال‌های صوتی ارسالی به دستگاه خروجی صوتی را مشخص می‌کند. برای جزئیات بیشتر مستندات گزینه \fBaudio_output_format\fP را ببینید. پیش‌فرض این است که از هر قالب صوتی ارائه‌شده به خروجی صدا استفاده شود. هر یک از این سه مشخصه می‌تواند یک ستاره (*) باشد تا نشان دهد نباید محدودیتی بر آن مشخصه اعمال شود.
.UNINDENT
.INDENT 0.0
.TP
.B replay_gain_handler
.INDENT 7.0
.TP
.B نوع
\fBsoftware\fP، \fBmixer\fP یا \fBnone\fP
.TP
.B پیش‌فرض
\fBsoftware\fP
.UNINDENT
.sp
نحوه اعمال replay gain را مشخص می‌کند. مقدار \fBsoftware\fP از کنترل نرم‌افزاری داخلی بلندی صدا استفاده می‌کند. مقدار \fBmixer\fP از کنترل میکسر (سخت‌افزاری) پیکربندی‌شده بهره می‌برد. مقدار \fBnone\fP قابلیت replay gain را روی این خروجی صوتی غیرفعال می‌سازد.
.UNINDENT
.INDENT 0.0
.TP
.B mixer_type
.INDENT 7.0
.TP
.B نوع
\fBhardware\fP، \fBsoftware\fP یا \fBnone\fP
.TP
.B پیش‌فرض
\fBhardware\fP (در صورت پشتیبانی) یا \fBnone\fP
.UNINDENT
.sp
مشخص می‌کند کدام میکسر باید برای این خروجی صوتی استفاده شود: میکسر سخت‌افزاری (در دسترس برای ALSA، OSS و PulseAudio)، میکسر نرم‌افزاری یا بدون میکسر (\fBnone\fP).
.UNINDENT
.SH "پرونده‌ها (FILES)"
.INDENT 0.0
.TP
.B \fB$XDG_CONFIG_HOME/mpd/mpd.conf\fP
پرونده پیکربندی کاربر (معمولاً \fB~/.config/mpd/mpd.conf\fP).
.TP
.B \fB/etc/mpd.conf\fP
پرونده پیکربندی سراسری سیستم.
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBmpd(1)\fP, \fBmpc(1)\fP
.SH "نویسنده (AUTHOR)"
Max Kellermann
.SH "کپی‌رایت (COPYRIGHT)"
2003-2025 The Music Player Daemon Project
.\" End of generated man page.