'\" t
.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 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 "MPC" "1" "Apr 09, 2026" "0.35" "mpc"
.SH "نام (NAME)"
mpc \- مستندات mpc
.SH "توضیحات (DESCRIPTION)"
.sp
برنامهٔ mpc یک کلاینت خط فرمانی برای دیمن پخش‌کننده موسیقی \%<http://\:www\:.musicpd\:.org> (MPD) است. این ابزار به MPD متصل شده و آن را بر اساس دستورها و آرگومان‌های ارائه‌شده کنترل می‌کند. اگر هیچ دستوری داده نشود، وضعیت فعلی چاپ می‌شود (مشابه \(dq\fBmpc status\fP\(dq).
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
mpc [options] <command> [\-\-] [<arguments>]
.UNINDENT
.UNINDENT
.sp
پس از \fB\-\-\fP، تمام پارامترها آرگومان در نظر گرفته می‌شوند و نه گزینه، حتی اگر با خط تیره آغاز شوند.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-f, \-\-format
قالب مورد استفاده برای نمایش آهنگ‌ها را پیکربندی می‌کند.
.sp
جداکننده‌های فراداده عبارت‌اند از:
.TS
box center;
l|l.
T{
نام
T}	T{
توضیحات
T}
_
T{
%name%
T}	T{
نامی برای این آهنگ. این فیلد عنوان قطعه نیست. معنای دقیق این برچسب به روشنی تعریف نشده است. معمولاً توسط ایستگاه‌های رادیویی اینترنتی با برچسب‌های ناقص و پیکربندی نادرست استفاده می‌شود تا هم نام هنرمند و هم عنوان آهنگ را در یک برچسب جای دهند.
T}
_
T{
%artist%
T}	T{
برچسب هنرمند فایل
T}
_
T{
%album%
T}	T{
برچسب آلبوم فایل
T}
_
T{
%albumartist%
T}	T{
برچسب هنرمند آلبوم فایل
T}
_
T{
%comment%
T}	T{
برچسب دیدگاه فایل (به‌طور پیش‌فرض در metadata_to_use فایل \fBmpd.conf\fP فعال نیست)
T}
_
T{
%composer%
T}	T{
برچسب آهنگساز فایل
T}
_
T{
%date%
T}	T{
برچسب تاریخ فایل
T}
_
T{
%originaldate%
T}	T{
برچسب تاریخ اصلی فایل
T}
_
T{
%disc%
T}	T{
برچسب دیسک فایل
T}
_
T{
%genre%
T}	T{
برچسب سبک فایل
T}
_
T{
%performer%
T}	T{
برچسب اجراکننده فایل
T}
_
T{
%title%
T}	T{
برچسب عنوان فایل
T}
_
T{
%track%
T}	T{
برچسب شماره قطعه فایل
T}
_
T{
%time%
T}	T{
مدت زمان فایل
T}
_
T{
%file%
T}	T{
مسیر فایل، نسبت به متغیر \fBmusic_directory\fP در MPD
T}
_
T{
%position%
T}	T{
شماره قطعه در صف
T}
_
T{
%id%
T}	T{
شماره شناسه قطعه در صف
T}
_
T{
%prio%
T}	T{
اولویت در صف (تصادفی).
T}
_
T{
%mtime%
T}	T{
تاریخ و زمان آخرین تغییر فایل
T}
_
T{
%mdate%
T}	T{
تاریخ آخرین تغییر فایل
T}
_
T{
%audioformat%
T}	T{
قالب صوتی آهنگ.
T}
.TE
.sp
عملگر \fB[]\fP برای گروه‌بندی خروجی به کار می‌رود؛ به گونه‌ای که اگر هیچ جداکنندهٔ فراداده‌ای بین \fB[\fP و \fB]\fP یافت نشود یا تطبیق نیابد، هیچ‌یک از نویسه‌های میان \fB[\fP و \fB]\fP در خروجی چاپ نمی‌شوند. \fB&\fP و \fB|\fP عملگرهای منطقی برای «و» (and) و «یا» (or) هستند. از \fB#\fP برای گریز (escape) نویسه‌ها استفاده می‌شود. چند مثال سودمند برای قالب عبارت‌اند از: \(dq\fB%file%\fP\(dq و \(dq\fB[[%artist% \- ]%title%]|[%file%]\fP\(dq. این دستور توالی‌های گریز تعریف‌شدهٔ زیر را نیز می‌پذیرد:
.TS
box center;
l|l.
T{
\e
T}	T{
بک‌اسلش
T}
_
T{
\e[
T}	T{
قلاب چپ (براکت باز)
T}
_
T{
\e]
T}	T{
قلاب راست (براکت بسته)
T}
_
T{
\ea
T}	T{
هشدار صوتی (alert)
T}
_
T{
\eb
T}	T{
پس‌بر (backspace)
T}
_
T{
\ee
T}	T{
گریز (escape)
T}
_
T{
\et
T}	T{
تب (tab)
T}
_
T{
\en
T}	T{
خط جدید (newline)
T}
_
T{
\ev
T}	T{
تب عمودی (vertical tab)
T}
_
T{
\ef
T}	T{
صفحه‌بند (form\-feed)
T}
_
T{
\er
T}	T{
بازگشت به ابتدای سطر (carriage return)
T}
.TE
.sp
در صورت مشخص نشدن، مقدار متغیر محیطی \fBMPC_FORMAT\fP استفاده می‌شود.
.UNINDENT
.INDENT 0.0.TP
.B \-\-wait
منتظر ماندن برای پایان عملیات (مانند به‌روزرسانی پایگاه‌داده).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-range=[START]:[END]
انجام عملیات روی یک بازه (مثلاً هنگام بارگذاری یک فهرست‌پخش). START اولین نمایهٔ بازه است و END اولین نمایهٔ پس از بازه است (یعنی شامل بازه نمی‌شود). START و END را می‌توان حذف کرد که باعث می‌شود بازه در آن انتها باز بماند. نمایه‌ها از صفر آغاز می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-with\-prio
تنها آهنگ‌هایی را نمایش می‌دهد که اولویتی غیرصفر دارند.
.UNINDENT
.INDENT 0.0
.TP
.B \-q, \-\-quiet, \-\-no\-status
از چاپ وضعیت آهنگ فعلی پس از اتمام برخی از دستورات جلوگیری می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verbose
خروجی پرگو (با جزئیات).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-host=HOST
سرور MPD برای اتصال به آن. این می‌تواند یک نام میزبان، نشانی IPv4/IPv6، یک مسیر مطلق (یعنی سوکت محلی) یا نامی باشد که با \fB@\fP آغاز می‌شود (یعنی یک سوکت انتزاعی، فقط در لینوکس).
.sp
برای استفاده از یک گذرواژه، مقداری به شکل
\(dq\fBpassword@host\fP\(dq ارائه دهید.
.sp
در صورت ارائه نشدن، از مقدار متغیر محیطی
\fBMPD_HOST\fP استفاده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-port=PORT, \-p PORT
پورت TCP سرور MPD برای اتصال به آن.
.sp
در صورت ارائه نشدن، از مقدار متغیر محیطی
\fBMPD_PORT\fP استفاده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-partition=PARTITION, \-a PARTITION
پارتیشن سرور MPD برای انجام عملیات روی آن.
.sp
در صورت مشخص نشدن، از پارتیشن پیش‌فرض استفاده می‌شود.
.UNINDENT
.SH "دستورات (COMMANDS)"
.sp
دستورات را می‌توان با کوتاه‌ترین پیشوند غیرمبهم آن‌ها به کار برد (مثلاً insert یا ins).
.SS "دستورات پخش‌کننده (Player Commands)"
.INDENT 0.0
.TP
\fBconsume <on|off>\fP \- تغییر حالت consume در صورتی که وضعیت (\fBon\fP یا \fBoff\fP) مشخص نشده باشد.
.TP
\fBcrossfade [<seconds>]\fP \- دریافت و تنظیم میزان فعلی crossfade میان آهنگ‌ها (\fB0\fP عمل crossfade را غیرفعال می‌کند).
.TP
\fBcurrent [\-\-wait]\fP \- نمایش آهنگی که هم‌اکنون در حال پخش است. با \fB\-\-wait\fP، برنامه mpc تا زمان تغییر آهنگ (یا تا شروع/توقف پخش) پیش از استعلام آهنگ فعلی از سرور منتظر می‌ماند.
.UNINDENT
.sp
\fBqueued\fP \- نمایش آهنگ بعدی که در صف قرار دارد.
.INDENT 0.0
.TP
\fBmixrampdb [<db>]\fP \- دریافت و تنظیم سطح بلندی صدا که در آن آهنگ‌های دارای برچسب MixRamp هم‌پوشانی خواهند داشت. این دستور محو شدن تدریجی دستور crossfade را غیرفعال کرده و صرفاً آهنگ‌ها را با یکدیگر ترکیب (میکس) می‌کند. مقدار \fB\-50.0\fP عملاً هرگونه وقفه را حذف می‌کند، \fB0.0\fP قطعه‌ها را در یکدیگر ادغام می‌کند. مقدار هم‌پوشانی توسط پارامتر پیکربندی audio_buffer_size در MPD محدود می‌شود.
.TP
\fBmixrampdelay [<seconds>]\fP \- دریافت و تنظیم میزان تأخیر اضافی فعلی که به مقدار محاسبه‌شده از برچسب‌های MixRamp افزوده می‌شود. (یک مقدار منفی، هم‌پوشانی با برچسب‌های MixRamp را غیرفعال کرده و مقدار قبلی crossfade را بازمی‌گرداند).
.UNINDENT
.sp
\fBnext\fP \- شروع پخش آهنگ بعدی در صف.
.sp
\fBpause\fP \- توقف موقت پخش (مکث).
.INDENT 0.0
.TP
\fBplay <position>\fP \- شروع پخش شماره آهنگ مشخص‌شده. در صورت تعیین نشدن، شماره ۱ را پخش می‌کند.
.UNINDENT
.sp
\fBprev\fP \- شروع پخش آهنگ قبلی.
.INDENT 0.0
.TP
\fBrandom <on|off>\fP \- تغییر حالت تصادفی (random) اگر وضعیت (\fBon\fP یا \fBoff\fP) مشخص نشده باشد.
.TP
\fBrepeat <on|off>\fP \- تغییر حالت تکرار (repeat) اگر وضعیت (\fBon\fP یا \fBoff\fP) مشخص نشده باشد.
.TP
\fBreplaygain [<off|track|album>]\fP \- تنظیم حالت replay gain. بدون آرگومان، حالت replay gain را چاپ می‌کند.
.TP
\fBsingle <on|once|off>\fP \- تغییر حالت تک‌آهنگ (single) اگر وضعیت (\fBon\fP، \fBonce\fP یا \fBoff\fP) مشخص نشده باشد. \fBonce\fP به \fBoff\fP تغییر می‌یابد\&.
.TP
\fBseek [+\-][<HH:MM:SS>] or <[+\-]<0\-100>%>\fP \- پرش زمانی بر اساس ساعت، دقیقه یا ثانیه؛ ساعت یا دقیقه می‌توانند حذف شوند. در صورت پرش بر حسب درصد، درون آهنگ فعلی به شیوهٔ مشخص‌شده پرش انجام می‌شود. در صورت استفاده از \fB+\fP یا \fB\-\fP، پرش نسبت به موقعیت فعلی آهنگ انجام می‌گیرد. به صورت پیش‌فرض پرش مطلق است.
.TP
\fBseekthrough [+\-][<HH:MM:SS>]\fP \- پرش زمانی بر اساس ساعت، دقیقه یا ثانیه، به صورت نسبی با موقعیت فعلی؛ ساعت یا دقیقه می‌توانند حذف شوند. اگر مدت‌زمان از حد آهنگ فعلی فراتر رود، دستور seek در طول فهرست‌پخش به جلو می‌رود تا به آن مدت‌زمان برسد. در صورت استفاده از \fB+\fP، پرش به جلو خواهد بود. در صورت استفاده از \fB\-\fP، پرش به عقب خواهد بود. پیش‌فرض پرش به جلو است.
.UNINDENT
.sp
\fBstop\fP \- توقف کامل پخش.
.INDENT 0.0
.TP
\fBtoggle\fP \- جابه‌جایی میان پخش و توقف موقت (pause). اگر پخش متوقف باشد، آن را آغاز می‌کند. از آغاز پخش در شماره آهنگ پشتیبانی نمی‌کند (از play استفاده کنید).
.UNINDENT.SS دستورهای صف (Queue Commands)
.INDENT 0.0
.TP
\fBadd <file>\fP \- ترانه‌ای را از پایگاه داده موسیقی به صف اضافه می‌کند. همچنین می‌تواند ورودی را از لوله‌ها (pipes) بخواند. برای افزودن تمام فایل‌ها به صف از \(dq\fBmpc add /\fP\(dq استفاده کنید.
.TP
\fBinsert <file>\fP \- دستور insert مشابه \fBadd\fP عمل می‌کند با این تفاوت که به‌جای انتهای صف، ترانه(ها) را پس از ترانه در حال پخش اضافه می‌کند. هنگامی که حالت تصادفی (random) فعال باشد، ترانه جدید پس از ترانه کنونی در صف قرار می‌گیرد.
.UNINDENT
.sp
\fBclear\fP \- صف را خالی می‌کند.
.INDENT 0.0
.TP
\fBcrop\fP \- تمام ترانه‌ها را به جز ترانه در حال پخش حذف می‌کند.
.TP
\fBdel <songpos>\fP \- یک شماره را از صف حذف می‌کند. همچنین می‌تواند ورودی را از لوله‌ها بخواند (\fB0\fP ترانه در حال پخش را حذف می‌کند).
.TP
\fBmv, move <from> <to>\fP \- ترانه را از موقعیت <from> به موقعیت <to> در صف منتقل می‌کند.
.TP
\fBsearchplay <type> <query> [<type> <query>]...\fP \- صف را برای یافتن ترانه‌ای منطبق جستجو کرده و آن را پخش می‌کند.
.UNINDENT
.sp
\fBshuffle\fP \- تمام ترانه‌های صف را بُر می‌زند (ترتیب آن‌ها را تصادفی می‌کند).
.SS دستورهای فهرست پخش (Playlist Commands)
.INDENT 0.0
.TP
\fBload <file>\fP \- فایل <file> را به عنوان صف بارگذاری می‌کند. از گزینه \fB\-\-range\fP می‌توان برای بارگذاری تنها بخشی از فایل استفاده کرد.
.UNINDENT
.sp
\fBlsplaylists\fP: \- فهرست‌های پخش موجود را فهرست می‌کند.
.INDENT 0.0
.TP
\fBplaylist [<playlist>]\fP \- تمام ترانه‌های موجود در <playlist> را فهرست می‌کند. اگر هیچ <playlist> مشخص نشود، تمام ترانه‌های صف کنونی را فهرست می‌کند.
.UNINDENT
.sp
\fBrm <file>\fP \- یک فهرست پخش مشخص را حذف می‌کند.
.sp
\fBsave <file>\fP \- فهرست پخش را با نام <file> ذخیره می‌کند.
.INDENT 0.0
.TP
\fBaddplaylist <playlist> <file>\fP \- ترانه‌ای را از پایگاه داده موسیقی به فهرست پخش اضافه می‌کند. اگر فهرست پخش وجود نداشته باشد، ایجاد خواهد شد. همچنین می‌تواند ورودی را از لوله‌ها بخواند.
.TP
\fBdelplaylist <playlist> <songpos>\fP \- ترانه واقع در موقعیت داده‌شده را از فهرست پخش حذف می‌کند. همچنین می‌تواند ورودی را از لوله‌ها بخواند.
.TP
\fBmoveplaylist <playlist> <from> <to>\fP \- ترانه را از موقعیت <from> مشخص‌شده به موقعیت <to> در فهرست پخش منتقل می‌کند.
.UNINDENT
.sp
\fBrenplaylist <playlist> <new playlist>\fP \- نام یک فهرست پخش را تغییر می‌دهد.
.sp
\fBclearplaylist <playlist>\fP \- محتوای فهرست پخش را پاک می‌کند (یعنی playlist.m3u را خالی می‌کند).
.SS دستورهای پایگاه داده (Database Commands)
.INDENT 0.0
.TP
\fBlistall [<file>]\fP \- موارد <file> را از پایگاه داده فهرست می‌کند. اگر هیچ \fBfile\fP مشخص نشده باشد، تمام ترانه‌های موجود در پایگاه داده را فهرست می‌کند.
.TP
\fBls [<directory>]\fP \- تمام فایل‌ها/پوشه‌ها را در \fBdirectory\fP فهرست می‌کند. اگر هیچ \fBdirectory\fP مشخص نشده باشد، تمام فایل‌های موجود در دایرکتوری موسیقی را فهرست می‌کند.
.TP
\fBlsdirs [<directory>]\fP \- زیرپوشه‌های \fBdirectory\fP را فهرست می‌کند. اگر هیچ \fBdirectory\fP مشخص نشده باشد، زیرپوشه‌های موجود در دایرکتوری موسیقی را فهرست می‌کند.
.TP
\fBsearch <type> <query> [<type> <query>]...\fP \- زیررشته‌ها را در برچسب‌های ترانه جستجو می‌کند. هر تعداد ترکیبی از نوع برچسب و عبارت جستجو قابل تعیین است. انواع برچسب‌های ممکن عبارتند از: artist، album، title، track، name، genre، date، composer، performer، comment، disc، filename، یا any (برای تطابق با هر برچسبی).
.TP
\fBsearch <expression>\fP \- با یک عبارت فیلتر جستجو می‌کند،
.INDENT 7.0
.INDENT 3.5
برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mpc search \(aq((artist == \(dqKraftwerk\(dq) AND (title == \(dqMetall auf
Metall\(dq))\(aq
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
برای جزئیات بیشتر، مستندات پروتکل MPD را در \%<https://\:www\:.musicpd\:.org/\:doc/\:protocol/\:filter_syntax\:.html> بررسی کنید. این نحو به همراه \fBfind\fP و \fBfindadd\fP نیز قابل استفاده است. (نیازمند libmpdclient 2.16 و MPD 0.21)
.TP
\fBfind <type> <query> [<type> <query>]...\fP \- همانند \fBsearch\fP است، اما مقادیر برچسب به‌جای تطابق زیررشته باید دقیقاً با \fBquery\fP مطابقت داشته باشند.
.TP
\fBfindadd <type> <query> [<type> <query>]...\fP \- همانند \fBfind\fP است، اما نتایج را به‌جای چاپ کردن به صف کنونی اضافه می‌کند.
.TP
\fBlist <type> [<type> <query>]... [group <type>]...\fP \- فهرستی از تمام برچسب‌های با نوع \fBtype\fP داده‌شده را برمی‌گرداند. گزینه‌های جستجوی اختیاری \fBtype\fP/\fBquery\fP نتایج را به شیوه‌ای مشابه search محدود می‌کنند. نتایج می‌توانند بر اساس یک یا چند برچسب گروه‌بندی شوند. مثال:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
mpc list album group artist
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBstats\fP \- آمارهای مربوط به MPD را نمایش می‌دهد.
.INDENT 0.0
.TP
\fBupdate [\-\-wait] [<path>]\fP \- فایل‌های به‌روزرسانی‌شده در دایرکتوری موسیقی را پویش می‌کند. پارامتر اختیاری \fBpath\fP (نسبت به دایرکتوری موسیقی) می‌تواند دامنه به‌روزرسانی را محدود کند.
.sp
با \fB\-\-wait\fP، برنامه mpc تا پایان به‌روزرسانی توسط MPD منتظر می‌ماند.
.TP
\fBrescan [\-\-wait] [<path>]\fP \- مانند update عمل می‌کند، اما فایل‌های تغییرنیافته را نیز مجدداً پویش می‌کند.
.UNINDENT.SS دستورهای فایل (File Commands)
.INDENT 0.0
.TP
\fBalbumart <file>\fP \- بارگیری تصویر جلد آلبوم برای آهنگ مشخص‌شده و
نوشتن آن در stdout.
.TP
\fBreadpicture <file>\fP \- بارگیری تصویر جاسازی‌شده در
آهنگ مشخص‌شده و نوشتن آن در stdout.
.UNINDENT
.SS دستورهای اتصال (Mount Commands)
.sp
\fBmount\fP \- فهرست کردن تمامی اتصالات.
.INDENT 0.0
.TP
\fBmount <mount\-path> <storage\-uri>\fP \- ایجاد یک اتصال جدید:
یک فضای ذخیره‌سازی را در مسیر مشخص‌شده متصل (mount) می‌کند. مثال:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
mpc mount server nfs://10.0.0.5/mp3
mpc mount stick udisks://by\-id\-ata\-FOO\-part2
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBunmount <mount\-path>\fP \- حذف یک اتصال.
.INDENT 0.0
.TP
\fBlistneighbors\fP \- چاپ فهرستی از \(dqهمسایه‌ها\(dq
(یعنی فضاهای ذخیره‌سازی خودکار شناسایی‌شده که قابلیت اتصال دارند). این
کار نیازمند فعال‌سازی حداقل یک پلاگین همسایه \%<https://\:mpd\:.readthedocs\:.io/\:en/\:stable/\:user\:.html#\:configuring-neighbor-plugins>
در \fBmpd.conf\fP است. مثال:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
$ mpc listneighbors
upnp://uuid:01234567\-89ab\-cdef\-0123\-456789abcdef/urn:schemas\-upnp\-org:service:ContentDirectory:1
udisks://by\-id\-dm\-name\-_dev_sdb3
udisks://by\-id\-ata\-FOO\-part2
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.SS دستورهای استیکر (Sticker Commands)
.sp
دستور \fBsticker\fP به شما امکان دریافت و تنظیم استیکرهای
آهنگ را می‌دهد.
.INDENT 0.0
.TP
\fBsticker <file> set <key> <value>\fP \- تنظیم مقدار یک استیکر
آهنگ.
.TP
\fBsticker <file> get <key>\fP \- چاپ مقدار یک استیکر
آهنگ.
.UNINDENT
.sp
\fBsticker <file> list\fP \- فهرست کردن تمامی استیکرهای یک آهنگ.
.sp
\fBsticker <file> delete <key>\fP \- حذف یک استیکر آهنگ.
.INDENT 0.0
.TP
\fBsticker <dir> find <key>\fP \- جست‌وجو برای استیکرهایی با
نام مشخص‌شده در زیر دایرکتوری تعیین‌شده.
.UNINDENT
.SS دستورهای خروجی (Output Commands)
.INDENT 0.0
.TP
\fBvolume [+\-]<num>\fP \- بلندی صدا را روی <num> تنظیم می‌کند (0\-100). اگر
از \fB+\fP یا \fB\-\fP استفاده شود، بلندی صدا نسبت به
میزان فعلی تنظیم می‌شود.
.UNINDENT
.sp
\fBoutputs\fP \- فهرست کردن تمامی خروجی‌های موجود
.INDENT 0.0
.TP
\fBdisable [only] <output # or name> [...]\fP \- غیرفعال‌سازی
خروجی(ها)؛ فهرستی از یک یا چند نام یا شماره الزامی
است. اگر \fBonly\fP اولین آرگومان باشد، همهٔ خروجی‌های دیگر
فعال می‌شوند.
.TP
\fBenable [only] <output # or name> [...]\fP \- فعال‌سازی
خروجی(ها)؛ فهرستی از یک یا چند نام یا شماره الزامی است. اگر
\fBonly\fP اولین آرگومان باشد، همهٔ خروجی‌های دیگر
غیرفعال می‌شوند.
.TP
\fBtoggleoutput <output # or name> [...]\fP \- تغییر وضعیت
برای خروجی(های) مشخص‌شده؛ فهرستی از یک یا چند نام یا
شماره الزامی است.
.TP
\fBmoveoutput <output # or name>\fP \- انتقال خروجی مشخص‌شده
به پارتیشن فعلی (گزینهٔ \-\-partition را ببینید).
.UNINDENT
.SS دستورهای پارتیشن (Partition Commands)
.sp
\fBpartitions\fP \- فهرست کردن تمامی پارتیشن‌های موجود
.sp
\fBmakepart <name> [...]\fP \- ایجاد پارتیشن‌های جدید
.sp
\fBdelpart <name> [...]\fP \- حذف پارتیشن‌ها
.SS دستورهای کلاینت به کلاینت (Client\-to\-client Commands)
.INDENT 0.0
.TP
\fBchannels\fP \- فهرست کردن کانال‌هایی که سایر کلاینت‌ها در آن‌ها
مشترک شده‌اند.
.TP
\fBsendmessage <channel> <message>\fP \- ارسال یک پیام به
کانال مشخص‌شده.
.TP
\fBwaitmessage <channel>\fP \- انتظار برای دست‌کم یک پیام در
کانال مشخص‌شده.
.TP
\fBsubscribe <channel>\fP \- اشتراک در کانال مشخص‌شده
و دریافت مداوم پیام‌ها.
.UNINDENT
.SS سایر دستورها (Other Commands)
.INDENT 0.0
.TP
\fBidle [events]\fP \- تا رخ دادن یک رویداد منتظر می‌ماند. فهرستی
از نام‌های رویدادها را، در هر سطر یکی، چاپ می‌کند. برای اطلاعات بیشتر
مستندات پروتکل MPD را ببینید.
.sp
اگر فهرستی از رویدادها را مشخص کنید، فقط این رویدادها در نظر گرفته می‌شوند.
.TP
\fBidleloop [events]\fP \- مشابه \fBidle\fP، اما
پس از چاپ رویدادها دوباره وارد حالت \(dqidle\(dq می‌شود.
.sp
اگر فهرستی از رویدادها را مشخص کنید، فقط این رویدادها در نظر گرفته می‌شوند.
.TP
\fBstatus [format]\fP \- بدون آرگومان، خروجی وضعیتی سه‌خطی معادل اجرای
\(dqmpc\(dq بدون هیچ آرگومانی چاپ می‌کند. اگر یک رشتهٔ قالب مشخص شده باشد،
جداکننده‌ها دقیقاً به همان صورتی که برای فراداده هستند پردازش می‌شوند. گزینهٔ \(aq\-f\(aq
را در بخش گزینه‌ها ببینید
.TS
box center;
l|l.
T{
نام
T}	T{
توضیحات
T}
_
T{
%totaltime%
T}	T{
مدت‌زمان کل آهنگ.
T}
_
T{
%currenttime%
T}	T{
زمانی که کلاینت در حال حاضر در آن قرار دارد.
T}
_
T{
%percenttime%
T}	T{
درصد زمان سپری‌شده از آهنگ فعلی.
T}
_
T{
%songpos%
T}	T{
موقعیت آهنگ فعلی در فهرست پخش.
T}
_
T{
%length%
T}	T{
تعداد آهنگ‌های موجود در فهرست پخش
T}
_
T{
%state%
T}	T{
یکی از موارد \(aqplaying\(aq، \(aqpaused\(aq یا \(aqstopped\(aq
T}
_
T{
%volume%
T}	T{
بلندی صدای فعلی، مرتب‌شده در ۴ نویسه شامل علامت درصد
T}
_
T{
%random%
T}	T{
وضعیت فعلی حالت تصادفی: \(aqon\(aq یا \(aqoff\(aq
T}
_
T{
%repeat%
T}	T{
وضعیت فعلی حالت تکرار: \(aqon\(aq یا \(aqoff\(aq
T}
_
T{
%single%
T}	T{
وضعیت فعلی حالت تکی: \(aqon\(aq، \(aqonce\(aq یا \(aqoff\(aq
T}
_
T{
%consume%
T}	T{
وضعیت فعلی حالت مصرف: \(aqon\(aq یا \(aqoff\(aq
T}
_
T{
%kbitrate%
T}	T{
نرخ بیت آهنگ فعلی بر حسب kbps.
T}
_
T{
%audioformat%
T}	T{
قالب صوتی که MPD در حال حاضر پخش می‌کند به‌صورت \(aqsamplerate:bits:channels\(aq.
T}
_
T{
%samplerate%
T}	T{
نرخ نمونه‌برداری بر حسب هرتز استخراج‌شده از قالب صوتی فعلی MPD.
T}
_
T{
%bits%
T}	T{
تعداد بیت‌های موثر به ازای هر نمونه، استخراج‌شده از قالب صوتی فعلی MPD.
T}
_
T{
%channels%
T}	T{
تعداد کانال‌های استخراج‌شده از قالب صوتی فعلی MPD.
T}
.TE.TP
\fBversion\fP \- نسخهٔ پروتکل استفاده‌شده را گزارش می‌کند، نه نسخهٔ واقعی دیمن را.
.UNINDENT
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.sp
تمامی متغیرهای محیطی با مقادیر مشخص‌شده از طریق گزینه‌های خط فرمان بازنویسی می‌شوند.
.INDENT 0.0
.TP
.B MPC_FORMAT
قالب مورد استفاده برای نمایش آهنگ‌ها را پیکربندی می‌کند. گزینهٔ
\fB\-\-format\fP\& را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B MPD_HOST
سرور MPD برای اتصال به آن. گزینهٔ \fB\-\-host\fP\& را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B MPD_PORT
درگاه TCP سرور MPD برای اتصال به آن. گزینهٔ
\fB\-\-port\fP\& را ببینید.
.UNINDENT
.SH "گزارش باگ‌ها (BUGS)"
.sp
گزارش باگ‌ها در \%<https://\:github\:.com/\:MusicPlayerDaemon/\:mpc/\:issues>
.sp
از آنجا که MPD از UTF\-8 استفاده می‌کند، mpc باید نویسه‌ها را به مجموعه نویسه‌های (charset) مورد استفاده در سیستم محلی تبدیل کند. اگر هنگام اجرای mpc با خطاهای تبدیل نویسه مواجه شدید، احتمالاً لازم است لوکال (locale) خود را تنظیم کنید. این کار با مقداردهی هر یک از متغیرهای محیطی LC_CTYPE، LANG یا LC_ALL انجام می‌شود (LC_CTYPE تنها بر مدیریت نویسه‌ها اثر می‌گذارد).
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBmpd(1)\fP
.SH "نویسندگان (AUTHORS)"
.sp
ببینید: \%<https://\:raw\:.githubusercontent\:.com/\:MusicPlayerDaemon/\:mpc/\:master/\:AUTHORS>
.SH "نویسندگان (AUTHORS)"
Max Kellermann
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر 2003-2021 The Music Player Daemon Project
.\" End of generated man page.