.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH mpdscribble 1 "JANUARY 2009" Linux "User Manuals"
.SH "نام (NAME)"
mpdscribble \- یک کلاینت Music Player Daemon (MPD) برای ارسال اطلاعات قطعات در حال پخش به یک اسکرابلر (مانند last.fm)
.SH "خلاصه دستور (SYNOPSIS)"
.B mpdscribble [options] 
.SH "توضیحات (DESCRIPTION)"
دستور
.B 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 موجب می‌شود تا بلافاصله اطلاعات را ارسال کند.

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

گزینه‌های پیکربندی پشتیبانی‌شده:
.TP
.B pidfile = FILE
نوشتن شناسه پردازش در این فایل.
.TP
.B log = FILE
فایلی که mpdscribble باید اطلاعات اشکال‌زدایی را در آن خروجی دهد.
مقدار ویژه "syslog" باعث می‌شود mpdscribble از دیمن محلی syslog استفاده کند (که حالت پیش‌فرض است). "-" به معنای ارسال گزارش به stderr است.
.TP
.B host = [PASSWORD@]HOSTNAME
میزبان اجراکننده MPD، که ممکن است با یک گذرواژه محافظت شده باشد.
برای اتصال از طریق سوکت دامنه یونیکس (Unix Domain Socket)، یک مسیر مطلق در اینجا وارد کنید.
.TP
.B port = PORT
درگاهی که MPD روی آن گوش می‌دهد و mpdscribble باید برای اتصال به آن تلاش کند.
.TP
.B proxy = URL
نشانی پروکسی HTTP.
.TP
.B verbose = 0, 1, 2, 3
میزان پرحرفی ثبت وقایع mpdscribble. مقدار پیش‌فرض 1 است. "0" فقط خطاهای حیاتی را ثبت می‌کند (مانند "out of memory")؛ "1" خطاهای غیرحیاتی را نیز ثبت می‌کند (مانند "server unreachable")؛ "2" پیام‌های اطلاعاتی را ثبت می‌کند (مانند "new song")؛ "3" تعداد زیادی پیام‌های اشکال‌زدایی را چاپ می‌کند.
.SH "اسکرابلرها (SCROBBLERS)"
این گزینه‌ها حداقل با یک بخش اسکرابلر دنبال می‌شوند (یک نام بخش یکتا مانند "libre.fm" انتخاب کنید که تنها در فایل گزارش ظاهر می‌شود؛ نام "mpdscribble" رزرو شده است).
.TP
.B file = PATH
ثبت وقایع در یک فایل به جای ارسال آهنگ‌ها به یک سرور AudioScrobbler.
.TP
.B url = URL
نشانی دست‌تکانی (handshake) اسکرابلر. مثال:
"https://post.audioscrobbler.com"، "http://turtle.libre.fm"
.TP
.B username = USERNAME
نام کاربری audioscrobbler شما.
.TP
.B password = MD5SUM
گذرواژه Last.fm شما، به صورت متن خام یا چک‌سام MD5 آن.
.TP
.B journal = FILE
فایلی که mpdscribble در صورت عدم اتصال به اسکرابلر باید ژورنال خود را در آن ذخیره کند. این گزینه پیش‌تر "cache" نامیده می‌شد. این گزینه اختیاری است.
.TP
.B ignore = FILE
افزودن یک فایل ignore برای این اسکرابلر به منظور مستثنی کردن قطعات از اسکرابل شدن.

.SH "قالب فایل نادیده‌گیری (IGNORE FILE FORMAT)"
قطعات را می‌توان با فهرست کردن در یک \fBفایل نادیده‌گیری (ignore file)\fP مستثنی کرد.
هر خط در فایل، الگویی را برای تطبیق قطعاتی که می‌خواهید از اسکرابل شدن حذف شوند، مشخص می‌کند.
این قالب ساده و منعطف است و به شما امکان می‌دهد بر اساس artist (هنرمند)، album (آلبوم)، title (عنوان)، track (شماره قطعه) یا ترکیبی از این فیلدها تطبیق انجام دهید.
.SS "قالب فایل (File Format)"
یک تطبیق تگ به صورت tagname="value" تعیین می‌شود، که در آن tagname با یکی از تگ‌های پشتیبانی‌شده (artist، album، title، track) جایگزین می‌گردد.
مقادیر \fBباید\fP درون علامت نقل قول (کوتیشن) قرار گیرند و فاصله در دو طرف علامت مساوی مجاز نیست.

هر خط شامل یک یا چند تطبیق تگ است که با فاصله از یکدیگر جدا شده‌اند:
.nf
.in +4
tag1="value1" tag2="value2" ...
.in
.fi

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

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

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

.SS "مثال‌ها (Examples)"
اگر یک تگ ذکر نشود، با هر مقداری برای آن فیلد مطابقت داده خواهد شد:
.TP
.B title="Bohemian Rhapsody"
با هر قطعه‌ای به نام \fIBohemian Rhapsody\fP تطبیق می‌یابد.
.TP
.B artist="Queen"
با هر قطعه‌ای از \fIQueen\fP، بدون در نظر گرفتن آلبوم یا عنوان تطبیق می‌یابد.
.TP
.B artist="Queen" album="A Night at the Opera"
با هر قطعه‌ای از \fIQueen\fP از آلبوم \fIA Night at the Opera\fP، بدون در نظر گرفتن عنوان تطبیق می‌یابد.
.TP
.B artist="Queen" album="A Night at the Opera" title="Bohemian Rhapsody"
با قطعه‌ای خاص از \fIQueen\fP، از آلبوم \fIA Night at the Opera\fP با عنوان \fIBohemian Rhapsody\fP تطبیق می‌یابد.
.TP
.B artist="Queen" album="A Night at the Opera" track="01"
با قطعه اول از آلبوم \fIA Night at the Opera\fP از گروه \fIQueen\fP تطبیق می‌یابد.
توجه داشته باشید که تگ‌های track به صورت متن تفسیر می‌شوند و نه عدد؛ یعنی "01" با "1" یکسان نیست.
.TP
.B artist="Clark \e"Plazmataz\e" Powell"
با قطعاتی اثر \fIClark "Plazmataz" Powell\fP تطبیق می‌یابد.


.SH "فایل‌ها (FILES)"
.I /etc/mpdscribble.conf
.RS
فایل پیکربندی سراسری سیستم.
.RE

.I ~/.config/mpdscribble/mpdscribble.conf
.RS
فایل پیکربندی مخصوص به هر کاربر.
.RE

.I /var/cache/mpdscribble/mpdscribble.cache
.RS
فایل حافظه پنهان (کَش) سراسری سیستم برای Last.fm.
.RE

.I ~/.cache/mpdscribble/mpdscribble.cache
.RS
فایل حافظه پنهان (کَش) مخصوص به هر کاربر برای Last.fm.
.RE

.I /var/log/mpdscribble/mpdscribble.log
.RS
فایل گزارش (log) سراسری سیستم.
.RE

.RE
.SH "گزارش باگ‌ها (BUGS)"
مجوزهای دسترسی فایل‌ها در فایل‌های cache/log ممکن است به‌طور پیش‌فرض ناامن باشند.

لطفاً باگ‌های جدید را به سامانه ردیابی باگ MPD گزارش دهید:
<http://www.musicpd.org/mantis>

.SH "همچنین ببینید (SEE ALSO)"
.BR mpd (1),
.BR mpc (1)