نام (NAME)

mpdscribble - یک کلاینت Music Player Daemon (MPD) برای ارسال اطلاعات قطعات در حال پخش به یک اسکرابلر (مانند last.fm)

خلاصه دستور (SYNOPSIS)

mpdscribble [options]

توضیحات (DESCRIPTION)

دستور mpdscribble یک کلاینت برای MPD (سرور پخش موسیقی یا Music Player Daemon) است. mpdscribble به یک MPD در حال اجرا بر روی شبکه محلی متصل می‌شود و به صورت موازی با سایر کلاینت‌های MPD روی شبکه کار می‌کند.

به‌طور پیش‌فرض، نام میزبان و درگاه مربوط به mpd را از متغیرهای محیطی MPD_HOST و MPD_PORT دریافت می‌کند. اگر این متغیرها تنظیم نشده باشند، mpdscribble از localhost:6600 استفاده خواهد کرد. همچنین می‌توان نام میزبان و درگاه را در فایل پیکربندی یا در خط فرمان مشخص کرد.

$ mpdscribble --host myhost --port=12345

مقادیر مشخص‌شده در خط فرمان، مقادیر تعیین‌شده در فایل پیکربندی یا متغیرهای محیطی را بازنویسی (override) می‌کنند.

اگر می‌خواهید از mpdscribble به همراه یک MPD محافظت‌شده با گذرواژه استفاده کنید، متغیر محیطی MPD_HOST را به صورت password@host تنظیم نمایید، یا میزبان را به روشی مشابه در فایل پیکربندی مشخص کنید.

در صورت عدم موفقیت در ارسال، mpdscribble مدتی منتظر می‌ماند و سپس دوباره تلاش می‌کند. ارسال یک سیگنال USR1 به پردازش در حال اجرای mpdscribble موجب می‌شود تا بلافاصله اطلاعات را ارسال کند.

گزینه‌ها (OPTIONS)

--help: نمایش راهنما و خروج.
--version: نمایش اطلاعات نسخه و خروج.
--no-daemon: برنامه mpdscribble را به دیمن تبدیل نمی‌کند و آن را در پیش‌زمینه اجرا می‌نماید.
--pidfile FILE: نوشتن شناسه پردازش (PID) در این فایل.
--daemon-user USERNAME: تغییر به این کاربر سیستم پس از تبدیل شدن به دیمن.
--log FILE: مشخص کردن فایل گزارش (log). مقدار ویژه "syslog" باعث می‌شود mpdscribble از دیمن محلی syslog استفاده کند (که حالت پیش‌فرض است). مقدار "-" به معنی ثبت گزارش در stderr است.
--conf FILE: خواندن گزینه‌های پیکربندی از فایل. به‌طور پیش‌فرض از /etc/mpdscribble.conf استفاده می‌شود (در صورتی که sysconfdir=/etc-- باشد).
--host [PASSWORD@]HOSTNAME: مشخص کردن میزبانی که با گذرواژه محافظت شده است. برای اتصال از طریق سوکت دامنه یونیکس (Unix Domain Socket)، یک مسیر مطلق در اینجا وارد کنید.
--port PORT: مشخص کردن درگاهی که MPD روی آن گوش می‌دهد.
--proxy URL: نشانی پروکسی HTTP.
--verbose LEVEL: مشخص کردن میزان پرحرفی mpdscribble در ثبت گزارش‌ها. مقادیر ممکن از 0 تا 3 هستند و پیش‌فرض 1 است.

پیکربندی (CONFIGURATION)

برنامه mpdscribble فایل پیکربندی خود را به ترتیب زیر جستجو می‌کند: $XDG_CONFIG_HOME/mpdscribble/mpdscribble.conf, ~/.config/mpdscribble/mpdscribble.conf, ~/.mpdscribble/mpdscribble.conf, /etc/mpdscribble.conf (اگر sysconfdir=/etc-- باشد) اما این مورد را می‌توان با مشخص کردن یک فایل پیکربندی دیگر با استفاده از گزینه خط فرمان --conf بازنویسی کرد.

گزینه‌های پیکربندی پشتیبانی‌شده:

pidfile = FILE: نوشتن شناسه پردازش در این فایل.
log = FILE: فایلی که mpdscribble باید اطلاعات اشکال‌زدایی را در آن خروجی دهد. مقدار ویژه "syslog" باعث می‌شود mpdscribble از دیمن محلی syslog استفاده کند (که حالت پیش‌فرض است). "-" به معنای ارسال گزارش به stderr است.
host = [PASSWORD@]HOSTNAME: میزبان اجراکننده MPD، که ممکن است با یک گذرواژه محافظت شده باشد. برای اتصال از طریق سوکت دامنه یونیکس (Unix Domain Socket)، یک مسیر مطلق در اینجا وارد کنید.
port = PORT: درگاهی که MPD روی آن گوش می‌دهد و mpdscribble باید برای اتصال به آن تلاش کند.
proxy = URL: نشانی پروکسی HTTP.
verbose = 0, 1, 2, 3: میزان پرحرفی ثبت وقایع mpdscribble. مقدار پیش‌فرض 1 است. "0" فقط خطاهای حیاتی را ثبت می‌کند (مانند "out of memory")؛ "1" خطاهای غیرحیاتی را نیز ثبت می‌کند (مانند "server unreachable")؛ "2" پیام‌های اطلاعاتی را ثبت می‌کند (مانند "new song")؛ "3" تعداد زیادی پیام‌های اشکال‌زدایی را چاپ می‌کند.

اسکرابلرها (SCROBBLERS)

این گزینه‌ها حداقل با یک بخش اسکرابلر دنبال می‌شوند (یک نام بخش یکتا مانند "libre.fm" انتخاب کنید که تنها در فایل گزارش ظاهر می‌شود؛ نام "mpdscribble" رزرو شده است).

file = PATH: ثبت وقایع در یک فایل به جای ارسال آهنگ‌ها به یک سرور AudioScrobbler.
url = URL: نشانی دست‌تکانی (handshake) اسکرابلر. مثال: "https://post.audioscrobbler.com"، "http://turtle.libre.fm"
username = USERNAME: نام کاربری audioscrobbler شما.
password = MD5SUM: گذرواژه Last.fm شما، به صورت متن خام یا چک‌سام MD5 آن.
journal = FILE: فایلی که mpdscribble در صورت عدم اتصال به اسکرابلر باید ژورنال خود را در آن ذخیره کند. این گزینه پیش‌تر "cache" نامیده می‌شد. این گزینه اختیاری است.
ignore = FILE: افزودن یک فایل ignore برای این اسکرابلر به منظور مستثنی کردن قطعات از اسکرابل شدن.

قالب فایل نادیده‌گیری (IGNORE FILE FORMAT)

قطعات را می‌توان با فهرست کردن در یک فایل نادیده‌گیری (ignore file) مستثنی کرد. هر خط در فایل، الگویی را برای تطبیق قطعاتی که می‌خواهید از اسکرابل شدن حذف شوند، مشخص می‌کند. این قالب ساده و منعطف است و به شما امکان می‌دهد بر اساس artist (هنرمند)، album (آلبوم)، title (عنوان)، track (شماره قطعه) یا ترکیبی از این فیلدها تطبیق انجام دهید.

قالب فایل (File Format)

یک تطبیق تگ به صورت tagname="value" تعیین می‌شود، که در آن tagname با یکی از تگ‌های پشتیبانی‌شده (artist، album، title، track) جایگزین می‌گردد. مقادیر باید درون علامت نقل قول (کوتیشن) قرار گیرند و فاصله در دو طرف علامت مساوی مجاز نیست.

هر خط شامل یک یا چند تطبیق تگ است که با فاصله از یکدیگر جدا شده‌اند:

tag1="value1" tag2="value2" ...

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

یک بک‌اسلش (\) به عنوان نویسه گریز تفسیر می‌شود و ممکن است برای گریز از دابل‌کوتیشن‌های واقعی درون یک مقدار استفاده شود. برای نوشتن یک بک‌اسلش واقعی، از دو بک‌اسلش (\\) استفاده کنید.

هر خط به همراه نویسه خط جدید به ۴۰۹۶ نویسه محدود است. نویسه‌های اضافی بدون هیچ هشداری نادیده گرفته می‌شوند.

مثال‌ها (Examples)

اگر یک تگ ذکر نشود، با هر مقداری برای آن فیلد مطابقت داده خواهد شد:

title="Bohemian Rhapsody": با هر قطعه‌ای به نام Bohemian Rhapsody تطبیق می‌یابد.
artist="Queen": با هر قطعه‌ای از Queen، بدون در نظر گرفتن آلبوم یا عنوان تطبیق می‌یابد.
artist="Queen" album="A Night at the Opera": با هر قطعه‌ای از Queen از آلبوم A Night at the Opera، بدون در نظر گرفتن عنوان تطبیق می‌یابد.
artist="Queen" album="A Night at the Opera" title="Bohemian Rhapsody": با قطعه‌ای خاص از Queen، از آلبوم A Night at the Opera با عنوان Bohemian Rhapsody تطبیق می‌یابد.
artist="Queen" album="A Night at the Opera" track="01": با قطعه اول از آلبوم A Night at the Opera از گروه Queen تطبیق می‌یابد. توجه داشته باشید که تگ‌های track به صورت متن تفسیر می‌شوند و نه عدد؛ یعنی "01" با "1" یکسان نیست.
artist="Clark \"Plazmataz\" Powell": با قطعاتی اثر Clark "Plazmataz" Powell تطبیق می‌یابد.