| MPC(1) | mpc | MPC(1) |
نام (NAME)
mpc - مستندات mpc
توضیحات (DESCRIPTION)
برنامهٔ mpc یک کلاینت خط فرمانی برای دیمن پخش‌کننده موسیقی http://www.musicpd.org (MPD) است. این ابزار به MPD متصل شده و آن را بر اساس دستورها و آرگومان‌های ارائه‌شده کنترل می‌کند. اگر هیچ دستوری داده نشود، وضعیت فعلی چاپ می‌شود (مشابه "mpc status").
خلاصه دستور (SYNOPSIS)
پس از --، تمام پارامترها آرگومان در نظر گرفته می‌شوند و نه گزینه، حتی اگر با خط تیره آغاز شوند.
گزینه‌ها (OPTIONS)
- -f, --format
- قالب مورد
استفاده
برای نمایش
آهنگ‌ها را
پیکربندی
می‌کند.
جداکننده‌های فراداده عبارت‌اند از:
نام توضیحات %name% نامی برای این آهنگ. این فیلد عنوان قطعه نیست. معنای دقیق این برچسب به روشنی تعریف نشده است. معمولاً توسط ایستگاه‌های رادیویی اینترنتی با برچسب‌های ناقص و پیکربندی نادرست استفاده می‌شود تا هم نام هنرمند و هم عنوان آهنگ را در یک برچسب جای دهند. %artist% برچسب هنرمند فایل %album% برچسب آلبوم فایل %albumartist% برچسب هنرمند آلبوم فایل %comment% برچسب دیدگاه فایل (به‌طور پیش‌فرض در metadata_to_use فایل mpd.conf فعال نیست) %composer% برچسب آهنگساز فایل %date% برچسب تاریخ فایل %originaldate% برچسب تاریخ اصلی فایل %disc% برچسب دیسک فایل %genre% برچسب سبک فایل %performer% برچسب اجراکننده فایل %title% برچسب عنوان فایل %track% برچسب شماره قطعه فایل %time% مدت زمان فایل %file% مسیر فایل، نسبت به متغیر music_directory در MPD %position% شماره قطعه در صف %id% شماره شناسه قطعه در صف %prio% اولویت در صف (تصادفی). %mtime% تاریخ و زمان آخرین تغییر فایل %mdate% تاریخ آخرین تغییر فایل %audioformat% قالب صوتی آهنگ. عملگر [] برای گروه‌بندی خروجی به کار می‌رود؛ به گونه‌ای که اگر هیچ جداکنندهٔ فراداده‌ای بین [ و ] یافت نشود یا تطبیق نیابد، هیچ‌یک از نویسه‌های میان [ و ] در خروجی چاپ نمی‌شوند. & و | عملگرهای منطقی برای «و» (and) و «یا» (or) هستند. از # برای گریز (escape) نویسه‌ها استفاده می‌شود. چند مثال سودمند برای قالب عبارت‌اند از: "%file%" و "[[%artist% - ]%title%]|[%file%]". این دستور توالی‌های گریز تعریف‌شدهٔ زیر را نیز می‌پذیرد:
\ بک‌اسلش \[ قلاب چپ (براکت باز) \] قلاب راست (براکت بسته) \a هشدار صوتی (alert) \b پس‌بر (backspace) \e گریز (escape) \t تب (tab) \n خط جدید (newline) \v تب عمودی (vertical tab) \f صفحه‌بند (form-feed) \r بازگشت به ابتدای سطر (carriage return) در صورت مشخص نشدن، مقدار متغیر محیطی MPC_FORMAT استفاده می‌شود.
- --range=[START]:[END]
- انجام عملیات روی یک بازه (مثلاً هنگام بارگذاری یک فهرست‌پخش). START اولین نمایهٔ بازه است و END اولین نمایهٔ پس از بازه است (یعنی شامل بازه نمی‌شود). START و END را می‌توان حذف کرد که باعث می‌شود بازه در آن انتها باز بماند. نمایه‌ها از صفر آغاز می‌شوند.
- --with-prio
- تنها آهنگ‌هایی را نمایش می‌دهد که اولویتی غیرصفر دارند.
- -q, --quiet, --no-status
- از چاپ وضعیت آهنگ فعلی پس از اتمام برخی از دستورات جلوگیری می‌کند.
- --verbose
- خروجی پرگو (با جزئیات).
- --host=HOST
- سرور MPD برای
اتصال به
آن. این
می‌تواند
یک نام
میزبان،
نشانی IPv4/IPv6،
یک مسیر
مطلق (یعنی
سوکت محلی)
یا نامی
باشد که با
@ آغاز
می‌شود
(یعنی یک
سوکت
انتزاعی،
فقط در
لینوکس).
برای استفاده از یک گذرواژه، مقداری به شکل "password@host" ارائه دهید.
در صورت ارائه نشدن، از مقدار متغیر محیطی MPD_HOST استفاده می‌شود.
- --port=PORT, -p PORT
- پورت TCP سرور MPD
برای اتصال
به آن.
در صورت ارائه نشدن، از مقدار متغیر محیطی MPD_PORT استفاده می‌شود.
- --partition=PARTITION, -a PARTITION
- پارتیشن
سرور MPD برای
انجام
عملیات روی
آن.
در صورت مشخص نشدن، از پارتیشن پیش‌فرض استفاده می‌شود.
دستورات (COMMANDS)
دستورات را می‌توان با کوتاه‌ترین پیشوند غیرمبهم آن‌ها به کار برد (مثلاً insert یا ins).
دستورات پخش‌کننده (Player Commands)
- consume <on|off> - تغییر حالت consume در صورتی که وضعیت (on یا off) مشخص نشده باشد.
- crossfade [<seconds>] - دریافت و تنظیم میزان فعلی crossfade میان آهنگ‌ها (0 عمل crossfade را غیرفعال می‌کند).
- current [--wait] - نمایش آهنگی که هم‌اکنون در حال پخش است. با --wait، برنامه mpc تا زمان تغییر آهنگ (یا تا شروع/توقف پخش) پیش از استعلام آهنگ فعلی از سرور منتظر می‌ماند.
queued - نمایش آهنگ بعدی که در صف قرار دارد.
- mixrampdb [<db>] - دریافت و تنظیم سطح بلندی صدا که در آن آهنگ‌های دارای برچسب MixRamp هم‌پوشانی خواهند داشت. این دستور محو شدن تدریجی دستور crossfade را غیرفعال کرده و صرفاً آهنگ‌ها را با یکدیگر ترکیب (میکس) می‌کند. مقدار -50.0 عملاً هرگونه وقفه را حذف می‌کند، 0.0 قطعه‌ها را در یکدیگر ادغام می‌کند. مقدار هم‌پوشانی توسط پارامتر پیکربندی audio_buffer_size در MPD محدود می‌شود.
- mixrampdelay [<seconds>] - دریافت و تنظیم میزان تأخیر اضافی فعلی که به مقدار محاسبه‌شده از برچسب‌های MixRamp افزوده می‌شود. (یک مقدار منفی، هم‌پوشانی با برچسب‌های MixRamp را غیرفعال کرده و مقدار قبلی crossfade را بازمی‌گرداند).
next - شروع پخش آهنگ بعدی در صف.
pause - توقف موقت پخش (مکث).
prev - شروع پخش آهنگ قبلی.
- random <on|off> - تغییر حالت تصادفی (random) اگر وضعیت (on یا off) مشخص نشده باشد.
- repeat <on|off> - تغییر حالت تکرار (repeat) اگر وضعیت (on یا off) مشخص نشده باشد.
- replaygain [<off|track|album>] - تنظیم حالت replay gain. بدون آرگومان، حالت replay gain را چاپ می‌کند.
- single <on|once|off> - تغییر حالت تک‌آهنگ (single) اگر وضعیت (on، once یا off) مشخص نشده باشد. once به off تغییر می‌یابد.
- seek [+-][<HH:MM:SS>] or <[+-]<0-100>%> - پرش زمانی بر اساس ساعت، دقیقه یا ثانیه؛ ساعت یا دقیقه می‌توانند حذف شوند. در صورت پرش بر حسب درصد، درون آهنگ فعلی به شیوهٔ مشخص‌شده پرش انجام می‌شود. در صورت استفاده از + یا -، پرش نسبت به موقعیت فعلی آهنگ انجام می‌گیرد. به صورت پیش‌فرض پرش مطلق است.
- seekthrough [+-][<HH:MM:SS>] - پرش زمانی بر اساس ساعت، دقیقه یا ثانیه، به صورت نسبی با موقعیت فعلی؛ ساعت یا دقیقه می‌توانند حذف شوند. اگر مدت‌زمان از حد آهنگ فعلی فراتر رود، دستور seek در طول فهرست‌پخش به جلو می‌رود تا به آن مدت‌زمان برسد. در صورت استفاده از +، پرش به جلو خواهد بود. در صورت استفاده از -، پرش به عقب خواهد بود. پیش‌فرض پرش به جلو است.
stop - توقف کامل پخش.
- add <file> - ترانه‌ای را از پایگاه داده موسیقی به صف اضافه می‌کند. همچنین می‌تواند ورودی را از لوله‌ها (pipes) بخواند. برای افزودن تمام فایل‌ها به صف از "mpc add /" استفاده کنید.
- insert <file> - دستور insert مشابه add عمل می‌کند با این تفاوت که به‌جای انتهای صف، ترانه(ها) را پس از ترانه در حال پخش اضافه می‌کند. هنگامی که حالت تصادفی (random) فعال باشد، ترانه جدید پس از ترانه کنونی در صف قرار می‌گیرد.
clear - صف را خالی می‌کند.
- crop - تمام ترانه‌ها را به جز ترانه در حال پخش حذف می‌کند.
- del <songpos> - یک شماره را از صف حذف می‌کند. همچنین می‌تواند ورودی را از لوله‌ها بخواند (0 ترانه در حال پخش را حذف می‌کند).
- mv, move <from> <to> - ترانه را از موقعیت <from> به موقعیت <to> در صف منتقل می‌کند.
- searchplay <type> <query> [<type> <query>]... - صف را برای یافتن ترانه‌ای منطبق جستجو کرده و آن را پخش می‌کند.
shuffle - تمام ترانه‌های صف را بُر می‌زند (ترتیب آن‌ها را تصادفی می‌کند).
دستورهای فهرست پخش (Playlist Commands)
lsplaylists: - فهرست‌های پخش موجود را فهرست می‌کند.
rm <file> - یک فهرست پخش مشخص را حذف می‌کند.
save <file> - فهرست پخش را با نام <file> ذخیره می‌کند.
- addplaylist <playlist> <file> - ترانه‌ای را از پایگاه داده موسیقی به فهرست پخش اضافه می‌کند. اگر فهرست پخش وجود نداشته باشد، ایجاد خواهد شد. همچنین می‌تواند ورودی را از لوله‌ها بخواند.
- delplaylist <playlist> <songpos> - ترانه واقع در موقعیت داده‌شده را از فهرست پخش حذف می‌کند. همچنین می‌تواند ورودی را از لوله‌ها بخواند.
- moveplaylist <playlist> <from> <to> - ترانه را از موقعیت <from> مشخص‌شده به موقعیت <to> در فهرست پخش منتقل می‌کند.
renplaylist <playlist> <new playlist> - نام یک فهرست پخش را تغییر می‌دهد.
clearplaylist <playlist> - محتوای فهرست پخش را پاک می‌کند (یعنی playlist.m3u را خالی می‌کند).
دستورهای پایگاه داده (Database Commands)
- listall [<file>] - موارد <file> را از پایگاه داده فهرست می‌کند. اگر هیچ file مشخص نشده باشد، تمام ترانه‌های موجود در پایگاه داده را فهرست می‌کند.
- ls [<directory>] - تمام فایل‌ها/پوشه‌ها را در directory فهرست می‌کند. اگر هیچ directory مشخص نشده باشد، تمام فایل‌های موجود در دایرکتوری موسیقی را فهرست می‌کند.
- lsdirs [<directory>] - زیرپوشه‌های directory را فهرست می‌کند. اگر هیچ directory مشخص نشده باشد، زیرپوشه‌های موجود در دایرکتوری موسیقی را فهرست می‌کند.
- search <type> <query> [<type> <query>]... - زیررشته‌ها را در برچسب‌های ترانه جستجو می‌کند. هر تعداد ترکیبی از نوع برچسب و عبارت جستجو قابل تعیین است. انواع برچسب‌های ممکن عبارتند از: artist، album، title، track، name، genre، date، composer، performer، comment، disc، filename، یا any (برای تطابق با هر برچسبی).
- search <expression> - با یک عبارت فیلتر جستجو می‌کند،
mpc search '((artist == "Kraftwerk") AND (title == "Metall auf Metall"))'
برای جزئیات بیشتر، مستندات پروتکل MPD را در https://www.musicpd.org/doc/protocol/filter_syntax.html بررسی کنید. این نحو به همراه find و findadd نیز قابل استفاده است. (نیازمند libmpdclient 2.16 و MPD 0.21)
- find <type> <query> [<type> <query>]... - همانند search است، اما مقادیر برچسب به‌جای تطابق زیررشته باید دقیقاً با query مطابقت داشته باشند.
- findadd <type> <query> [<type> <query>]... - همانند find است، اما نتایج را به‌جای چاپ کردن به صف کنونی اضافه می‌کند.
- list <type> [<type> <query>]... [group <type>]... - فهرستی از تمام برچسب‌های با نوع type داده‌شده را برمی‌گرداند. گزینه‌های جستجوی اختیاری type/query نتایج را به شیوه‌ای مشابه search محدود می‌کنند. نتایج می‌توانند بر اساس یک یا چند برچسب گروه‌بندی شوند. مثال:
mpc list album group artist
stats - آمارهای مربوط به MPD را نمایش می‌دهد.
- update [--wait] [<path>] - فایل‌های به‌روزرسانی‌شده در دایرکتوری موسیقی را پویش می‌کند. پارامتر اختیاری path (نسبت به دایرکتوری موسیقی) می‌تواند دامنه به‌روزرسانی را محدود کند.
-
با --wait، برنامه mpc تا پایان به‌روزرسانی توسط MPD منتظر می‌ماند.
- rescan [--wait] [<path>] - مانند update عمل می‌کند، اما فایل‌های تغییرنیافته را نیز مجدداً پویش می‌کند.
- albumart <file> - بارگیری تصویر جلد آلبوم برای آهنگ مشخص‌شده و
- نوشتن آن در stdout.
- readpicture <file> - بارگیری تصویر جاسازی‌شده در
- آهنگ مشخص‌شده و نوشتن آن در stdout.
دستورهای اتصال (Mount Commands)
mount - فهرست کردن تمامی اتصالات.
- mount <mount-path> <storage-uri> - ایجاد یک اتصال جدید:
- یک فضای ذخیره‌سازی را در مسیر مشخص‌شده متصل (mount) می‌کند. مثال:
mpc mount server nfs://10.0.0.5/mp3 mpc mount stick udisks://by-id-ata-FOO-part2
unmount <mount-path> - حذف یک اتصال.
- listneighbors - چاپ فهرستی از "همسایه‌ها"
- (یعنی فضاهای ذخیره‌سازی خودکار شناسایی‌شده که قابلیت اتصال دارند). این کار نیازمند فعال‌سازی حداقل یک پلاگین همسایه https://mpd.readthedocs.io/en/stable/user.html#configuring-neighbor-plugins در mpd.conf است. مثال:
$ 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
دستورهای استیکر (Sticker Commands)
دستور sticker به شما امکان دریافت و تنظیم استیکرهای آهنگ را می‌دهد.
sticker <file> list - فهرست کردن تمامی استیکرهای یک آهنگ.
sticker <file> delete <key> - حذف یک استیکر آهنگ.
- sticker <dir> find <key> - جست‌وجو برای استیکرهایی با
- نام مشخص‌شده در زیر دایرکتوری تعیین‌شده.
دستورهای خروجی (Output Commands)
- volume [+-]<num> - بلندی صدا را روی <num> تنظیم می‌کند (0-100). اگر
- از + یا - استفاده شود، بلندی صدا نسبت به میزان فعلی تنظیم می‌شود.
outputs - فهرست کردن تمامی خروجی‌های موجود
- disable [only] <output # or name> [...] - غیرفعال‌سازی
- خروجی(ها)؛ فهرستی از یک یا چند نام یا شماره الزامی است. اگر only اولین آرگومان باشد، همهٔ خروجی‌های دیگر فعال می‌شوند.
- enable [only] <output # or name> [...] - فعال‌سازی
- خروجی(ها)؛ فهرستی از یک یا چند نام یا شماره الزامی است. اگر only اولین آرگومان باشد، همهٔ خروجی‌های دیگر غیرفعال می‌شوند.
- toggleoutput <output # or name> [...] - تغییر وضعیت
- برای خروجی(های) مشخص‌شده؛ فهرستی از یک یا چند نام یا شماره الزامی است.
- moveoutput <output # or name> - انتقال خروجی مشخص‌شده
- به پارتیشن فعلی (گزینهٔ --partition را ببینید).
دستورهای پارتیشن (Partition Commands)
partitions - فهرست کردن تمامی پارتیشن‌های موجود
makepart <name> [...] - ایجاد پارتیشن‌های جدید
delpart <name> [...] - حذف پارتیشن‌ها
دستورهای کلاینت به کلاینت (Client-to-client Commands)
- channels - فهرست کردن کانال‌هایی که سایر کلاینت‌ها در آن‌ها
- مشترک شده‌اند.
- sendmessage <channel> <message> - ارسال یک پیام به
- کانال مشخص‌شده.
- waitmessage <channel> - انتظار برای دست‌کم یک پیام در
- کانال مشخص‌شده.
- subscribe <channel> - اشتراک در کانال مشخص‌شده
- و دریافت مداوم پیام‌ها.
سایر دستورها (Other Commands)
- idle [events] - تا رخ دادن یک رویداد منتظر می‌ماند. فهرستی
- از نام‌های
رویدادها
را، در هر
سطر یکی،
چاپ می‌کند.
برای
اطلاعات
بیشتر
مستندات
پروتکل MPD را
ببینید.
اگر فهرستی از رویدادها را مشخص کنید، فقط این رویدادها در نظر گرفته می‌شوند.
- idleloop [events] - مشابه idle، اما
- پس از چاپ
رویدادها
دوباره
وارد حالت
"idle" می‌شود.
اگر فهرستی از رویدادها را مشخص کنید، فقط این رویدادها در نظر گرفته می‌شوند.
- status [format] - بدون آرگومان، خروجی وضعیتی سه‌خطی معادل اجرای
- "mpc" بدون هیچ
آرگومانی
چاپ می‌کند.
اگر یک
رشتهٔ قالب
مشخص شده
باشد،
جداکننده‌ها
دقیقاً به
همان صورتی
که برای
فراداده
هستند
پردازش
می‌شوند.
گزینهٔ '-f' را
در بخش
گزینه‌ها
ببینید
نام توضیحات %totaltime% مدت‌زمان کل آهنگ. %currenttime% زمانی که کلاینت در حال حاضر در آن قرار دارد. %percenttime% درصد زمان سپری‌شده از آهنگ فعلی. %songpos% موقعیت آهنگ فعلی در فهرست پخش. %length% تعداد آهنگ‌های موجود در فهرست پخش %state% یکی از موارد 'playing'، 'paused' یا 'stopped' %volume% بلندی صدای فعلی، مرتب‌شده در ۴ نویسه شامل علامت درصد %random% وضعیت فعلی حالت تصادفی: 'on' یا 'off' %repeat% وضعیت فعلی حالت تکرار: 'on' یا 'off' %single% وضعیت فعلی حالت تکی: 'on'، 'once' یا 'off' %consume% وضعیت فعلی حالت مصرف: 'on' یا 'off' %kbitrate% نرخ بیت آهنگ فعلی بر حسب kbps. %audioformat% قالب صوتی که MPD در حال حاضر پخش می‌کند به‌صورت 'samplerate:bits:channels'. %samplerate% نرخ نمونه‌برداری بر حسب هرتز استخراج‌شده از قالب صوتی فعلی MPD. %bits% تعداد بیت‌های موثر به ازای هر نمونه، استخراج‌شده از قالب صوتی فعلی MPD. %channels% تعداد کانال‌های استخراج‌شده از قالب صوتی فعلی MPD. version - نسخهٔ پروتکل استفاده‌شده را گزارش می‌کند، نه نسخهٔ واقعی دیمن را. 168u "متغیرهای محیطی (ENVIRONMENT VARIABLES)" تمامی متغیرهای محیطی با مقادیر مشخص‌شده از طریق گزینه‌های خط فرمان بازنویسی می‌شوند. 0.0 MPC_FORMAT قالب مورد استفاده برای نمایش آهنگ‌ها را پیکربندی می‌کند. گزینهٔ --format را ببینید. 168u 0.0 MPD_HOST سرور MPD برای اتصال به آن. گزینهٔ --host را ببینید. 168u 0.0 MPD_PORT درگاه TCP سرور MPD برای اتصال به آن. گزینهٔ --port را ببینید. 168u "گزارش باگ‌ها (BUGS)" گزارش باگ‌ها در https://github.com/MusicPlayerDaemon/mpc/issues از آنجا که MPD از UTF-8 استفاده می‌کند، mpc باید نویسه‌ها را به مجموعه نویسه‌های (charset) مورد استفاده در سیستم محلی تبدیل کند. اگر هنگام اجرای mpc با خطاهای تبدیل نویسه مواجه شدید، احتمالاً لازم است لوکال (locale) خود را تنظیم کنید. این کار با مقداردهی هر یک از متغیرهای محیطی LC_CTYPE، LANG یا LC_ALL انجام می‌شود (LC_CTYPE تنها بر مدیریت نویسه‌ها اثر می‌گذارد). "همچنین ببینید (SEE ALSO)" mpd(1) "نویسندگان (AUTHORS)" ببینید: https://raw.githubusercontent.com/MusicPlayerDaemon/mpc/master/AUTHORS "نویسندگان (AUTHORS)" Max Kellermann "کپی‌رایت و تکثیر (COPYRIGHT)" حق نشر 2003-2021 The Music Player Daemon Project
| April 9, 2026 | 0.35 |