.\" xmms2 - رابط رسمی خط فرمان XMMS2 .\" .\" xmms2.1 - صفحه راهنمای xmms2 .\" .\" Copyright (C) 2009 Anthony Garcia .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer .\" in this position and unchanged. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .TH XMMS2 1 .SH "نام (NAME)" xmms2 \- رابط رسمی خط فرمان XMMS2 .SH "خلاصه دستور (SYNOPSIS)" .B xmms2 [\fIدستور\fR] [\fIآرگومان‌ها\fR] .br .B xmms2 help [\fIدستور\fR] .SH "توضیحات (DESCRIPTION)" XMMS2 بازطراحی پخش‌کننده موسیقی XMMS () است. این برنامه از یک ساختار کلاینت-سرور بهره می‌برد که اجازه می‌دهد چندین رابط کاربری متنی و گرافیکی (حتی به‌صورت هم‌زمان!) استفاده شوند. تمامی قالب‌های صوتی متداول به کمک افزونه‌ها پشتیبانی می‌شوند. علاوه بر این، یک کتابخانه رسانه‌ای انعطاف‌پذیر برای سازماندهی موسیقی‌ها فراهم شده است. .PP .B xmms2 رابط کاربری رسمی و خط فرمانی XMMS2 است. .SH "فراخوانی (INVOCATION)" .SS "حالت درون‌خطی (Inline mode)" اگر یک دستور به‌عنوان آرگومان به .B xmms2 داده شود، آن دستور تفسیر خواهد شد و پس از پایان کار، .B xmms2 خارج می‌شود. .SS "حالت تعاملی (Interactive mode)" .B xmms2 از طریق readline یک محیط قدرتمند شبیه پوسته ارائه می‌دهد که به کاربر امکان می‌دهد دستورات را در اعلان ورودی وارد کند و از ویژگی‌های معمول و سودمندی مانند بسط نام مسیر (pathname expansion) و ویرایش خط بهره‌مند شود. .SH "دستورات (COMMANDS)" .PP تمامی دستورات گزینه .BR \-h / \-\-help را می‌پذیرند که راهنمای همان دستور را نمایش می‌دهد. .PP شناسه \fIpattern\fR به تعریف یک مجموعه اشاره دارد (بخش \fBPATTERN\fR در ادامه را ببینید). .PP شناسه \fIposition\fR الگویی برای تطبیق موقعیت‌های فهرست پخش است. در صورت عدم ذکر در دستور، پیش‌فرض انتهای فهرست پخش خواهد بود (بخش \fBPOSITION PATTERN\fR در ادامه را ببینید). .SS "دستورات عمومی (General Commands)" \fBadd\fR [ \fB\-f\fR [\fB\-N\fR] [\fB\-P\fR] [\fB\-A\fR \fIkey=value\fR]... ] [\fB\-p\fR \fIplaylist\fR] [\fB\-n\fR | \fB\-a\fR \fIposition\fR] [\fB-o\fR \fIprop\fR[,...]] [\fB-j\fR] \fIarguments\fR... .br \fBadd\fR [\fB\-p\fR \fIplaylist\fR] [\fB\-n\fR | \fB\-a\fR \fIposition\fR] [\fB-o\fR \fIprop\fR[,...]] [\fB-j\fR] \fIpattern\fR... .PP .RS 4 افزودن رسانه به یک لیست پخش. تلاش می‌کند حدس بزند که آیا \fIarguments\fR بیانگر یک \fIpattern\fR است یا نشان‌دهنده مسیرهای فایل است. این رفتار را می‌توان با اجبار نوع از طریق \fB-f\fR و \fB-t\fR بازنویسی کرد. اگر مسیرهای فایل شامل نویسه‌های * یا ? باشند، تلاش می‌شود آن‌ها گسترش یابند. در صورت عدم یافتن تطابق، تلاش خواهد شد نویسه‌های * و ? به عنوان بخشی از URL اضافه شوند. .RE .PP .RS 4 \fB\-f\fR, \fB\-\-file\fR .RE .RS 8 اجبار به در نظر گرفتن \fIarguments\fR به عنوان مسیرهای فایل. .RE .PP .RS 4 \fB\-P\fR, \fB\-\-pls\fR .RE .RS 8 اجبار به در نظر گرفتن \fIarguments\fR به عنوان فایل‌های لیست پخش. این گزینه مستلزم \fB-f\fR است. .RE .PP .RS 4 \fB\-t\fR, \fB\-\-pattern\fR .RE .RS 8 اجبار به در نظر گرفتن \fIarguments\fR به عنوان یک الگو (pattern). .RE .PP .RS 4 \fB\-N\fR, \fB\-\-non-recursive\fR .RE .RS 8 پوشه‌ها به صورت بازگشتی اضافه نشوند. .RE .PP .RS 4 \fB\-p\fR, \fB\-\-playlist\fR \fIplaylist\fR .RE .RS 8 افزودن رسانه به \fIplaylist\fR به‌جای لیست پخش فعال. .RE .PP .RS 4 \fB\-n\fR, \fB\-\-next\fR .RE .RS 8 افزودن رسانه پس از قطعه جاری. .RE .PP .RS 4 \fB\-a\fR, \fB\-\-at\fR \fIposition\fR .RE .RS 8 افزودن رسانه در موقعیت داده‌شده. .RE .PP .RS 4 \fB\-A\fR, \fB\-\-attribute\fR \fIkey=value\fR .RE .RS 8 افزودن رسانه با صفت key=value داده‌شده. می‌تواند چندین بار تکرار شود. فقط هنگام افزودن فایل‌های جدید به کتابخانه رسانه معتبر است. .RE .PP .RS 4 \fB\-o\fR, \fB\-\-order\fR \fIprop\fR[,...] .RE .RS 8 افزودن رسانه‌ها مرتب‌شده بر اساس لیست مشخصه‌ها که با کاما جدا شده‌اند. اگر یک مشخصه دارای پیشوند \- باشد، رسانه‌ها بر اساس آن مشخصه به ترتیب معکوس مرتب می‌شوند. .RE .PP .RS 4 \fB\-j\fR, \fB\-\-jump\fR .RE .RS 8 پرش به رسانه تازه اضافه‌شده و آغاز پخش آن. .RE .PP .TP \fBexit\fR .PP .RS 4 خروج از رابط کاربری شبیه به خط فرمان (shell-like). .RE .PP .TP \fBhelp\fR [\fB\-a\fR] \fIcommand\fR .PP .RS 4 نمایش راهنمای \fIcommand\fR. این معادل \fBcommand \-h\fR است. اگر \fIcommand\fR یک نام مستعار (alias) باشد، تعریف نام مستعار را نمایش می‌دهد. اگر دستوری مشخص نشود، تمام دستورات موجود را فهرست می‌کند. .RE .PP .RS 4 \fB\-a\fR, \fB\-\-alias\fR .RE .RS 8 در صورتی که \fIcommand\fR مشخص نشده باشد، نام‌های مستعار موجود را فهرست می‌کند. در غیر این صورت، اثری ندارد. .RE .PP .TP \fBinfo\fR [\fIpattern\fR | \fIpositions\fR...] .PP .RS 4 نمایش مشخصه‌های تمام رسانه‌های منطبق با \fIpattern\fR یا در موقعیت‌های داده‌شده. بدون آرگومان، مشخصه‌های قطعه جاری را نمایش می‌دهد. .RE .PP .TP \fBjump\fR [\fB\-b\fR] \fIpattern\fR|\fIposition\fR .PP .RS 4 پرش به نخستین رسانه منطبق با \fIpattern\fR یا به موقعیت داده‌شده. .RE .PP .RS 4 \fB\-b\fR, \fB\-\-backward\fR .RE .RS 8 پرش به عقب به نخستین رسانه منطبق با الگو. .RE .PP .TP \fBlist\fR [\fB\-p\fR \fIname\fR] [\fIpattern\fR | \fIpositions\fR...] .PP .RS 4 فهرست کردن محتویات یک لیست پخش (به‌طور پیش‌فرض لیست پخش فعال). اگر \fIpattern\fR داده شود، محتویات بیشتر فیلتر شده و تنها رسانه‌های منطبق نمایش داده می‌شوند. .RE .PP .RS 4 \fB\-p\fR, \fB\-\-playlist\fR .RE .RS 8 فهرست کردن \fIplaylist\fR، به‌جای لیست پخش فعال. .RE .PP .TP \fBmove\fR [\fB\-p\fR \fIplaylist\fR] [\fB\-n\fR | \fB\-a\fR \fIposition\fR] \fIpattern\fR | \fIpositions\fR... .PP .RS 4 انتقال موارد در داخل یک لیست پخش (به‌طور پیش‌فرض لیست پخش فعال). .RE .PP .RS 4 \fB\-p\fR, \fB\-\-playlist\fR \fIplaylist\fR .RE .RS 8 لیست پخش (\fIplaylist\fR) برای اعمال عملیات روی آن. .RE .PP .RS 4 \fB\-n\fR, \fB\-\-next\fR .RE .RS 8 انتقال قطعه‌های منطبق به بعد از قطعه جاری. .RE .PP .RS 4 \fB\-a\fR, \fB\-\-at\fR \fIposition\fR .RE .RS 8 انتقال قطعه‌های منطبق با یک فاصله (offset) یا به یک موقعیت (\fIposition\fR). .RE .PP .TP \fBnext\fR [\fIoffset\fR] .PP .RS 4 پرش به آهنگ بعدی. اگر \fIoffset\fR ارائه شود، مانند \fBjump +\fIoffset\fR عمل می‌کند. .RE .PP .TP \fBpause\fR .PP .RS 4 مکث در پخش. .RE .PP .TP \fBplay\fR .PP .RS 4 آغاز پخش. .RE .PP .TP \fBprev\fR [\fIoffset\fR] .PP .RS 4 پرش به آهنگ قبلی. اگر \fIoffset\fR ارائه شود، مانند \fBjump -\fIoffset\fR عمل می‌کند. .RE .PP .TP \fBremove\fR [\fB\-p\fR \fIplaylist\fR] \fIpattern\fR | \fIpositions...\fR .PP .RS 4 حذف رسانه‌های منطبق از یک لیست پخش (به‌طور پیش‌فرض لیست پخش فعال). .RE .PP .RS 4 \fB\-p\fR, \fB\-\-playlist\fR \fIplaylist\fR .RE .RS 8 حذف از \fIplaylist\fR، به‌جای لیست پخش فعال. .RE .PP .TP \fBcurrent\fR [\fB\-r\fR \fIseconds\fR] [\fB\-f\fR \fIformat\fR] .PP .RS 4 نمایش وضعیت پخش، به‌طور مداوم یا یک‌باره. .RE .PP .RS 4 \fB\-r\fR, \fB\-\-refresh\fR \fIseconds\fR .RE .RS 8 تنظیم تأخیر، بر حسب ثانیه، میان هر نوسازی فراداده‌های پخش جاری. اگر 0 باشد، فراداده فقط یک‌بار چاپ می‌شود (پیش‌فرض) و دستور فوراً خارج می‌شود. در حالت نوسازی، کنترل پایه‌ای بر روی لیست پخش فعال فراهم می‌شود. .RE .PP .RS 4 \fB\-f\fR, \fB\-\-format\fR \fIformat\fR .RE .RS 8 تنظیم رشته قالب استفاده‌شده برای نمایش اطلاعات وضعیت، به‌جای رشته موجود در فایل پیکربندی (بخش \fBFORMAT STRING\fR را در زیر ببینید). .RE .PP .TP \fBsearch\fR [\fB\-o\fR \fIprop1\fR[,\fIprop2\fR...]] [\fB\-l\fR \fIprop1\fR[,\fIprop2\fR...] ] \fIpattern\fR .PP .RS 4 جستجو و چاپ تمام رسانه‌های منطبق با \fIpattern\fR. .RE .PP .RS 4 \fB\-o\fR, \fB\-\-order\fR \fIprop1\fR[,\fIprop2\fR...] .RE .RS 8 نمایش نتایج جستجو مرتب‌شده بر اساس لیست مشخصه‌های داده‌شده. اگر یک مشخصه دارای پیشوند '-' باشد، نتایج بر اساس آن مشخصه به ترتیب معکوس مرتب می‌شوند. .RE .PP .RS 4 \fB\-l\fR, \fB\-\-columns\fR \fIprop1\fR[,\fIprop2\fR...] .RE .RS 8 لیست \fIproperties\fR جهت استفاده به عنوان ستون‌ها. .RE .PP .TP \fBseek\fR \fItime\fR | \fIoffset\fR .PP .RS 4 پیمایش به زمان نسبی یا مطلق در قطعه جاری. .RE .PP .TP \fBstop\fR .PP .RS 4 توقف پخش. .RE .PP .TP \fBtoggle\fR .PP .RS 4 تغییر وضعیت پخش (پخش/توقف موقت). .RE .PP .SS "دستورات لیست پخش (Playlist Commands)" .BR .TP \fBplaylist clear\fR [\fIplaylist\fR] .PP .RS 4 پاک کردن یک لیست پخش. به‌طور پیش‌فرض، لیست پخش فعال را پاک می‌کند. .RE .PP .TP \fBplaylist config\fR [\fB\-t\fR \fItype\fR] [\fB\-s\fR \fIhistory\fR] [\fB\-u\fR \fIupcoming\fR] [\fB\-i\fR \fIcoll\fR] [\fB\-j\fR \fIplaylist\fR] [\fIplaylist\fR] .PP .RS 4 پیکربندی یک لیست پخش با تغییر نوع، ویژگی‌ها و موارد دیگر آن. به‌طور پیش‌فرض، لیست پخش فعال را پیکربندی می‌کند. .RE .PP .RS 4 \fB\-t\fR, \fB\-\-type\fR \fItype\fR .RE .RS 8 تغییر \fItype\fR (نوع) لیست پخش: list، queue، pshuffle. .RE .PP .RS 4 \fB\-s\fR, \fB\-\-history\fR \fIsize\fR .RE .RS 8 مقدار \fIsize\fR (اندازه) تاریخچه قطعات پخش‌شده (برای queue، pshuffle). .RE .PP .RS 4 \fB\-u\fR, \fB\-\-upcoming\fR \fIupcoming\fR .RE .RS 8 تعداد قطعات پیش‌رو (\fIupcoming\fR) جهت نگهداری (برای pshuffle). .RE .PP .RS 4 \fB\-i\fR, \fB\-\-input\fR \fIcollection\fR .RE .RS 8 مجموعه (\fIcollection\fR) ورودی برای لیست پخش (برای pshuffle). پیش‌فرض 'All Media' است. .RE .PP .RS 4 \fB\-j\fR, \fB\-\-jumplist\fR \fIplaylist\fR .RE .RS 8 پرش به یک \fIplaylist\fR دیگر هنگام رسیدن به انتهای لیست پخش. .RE .PP .TP \fBplaylist create\fR [\fB\-s\fR] [\fB\-p\fR \fIplaylist\fR] \fIname\fR .PP .RS 4 ایجاد یک لیست پخش جدید. .RE .PP .RS 4 \fB\-s\fR, \fB\-\-switch\fR .RE .RS 8 رفتن و سوئیچ به لیست پخش تازه ایجادشده. .RE .PP .RS 4 \fB\-p\fR, \fB\-\-playlist\fR \fIplaylist\fR .RE .RS 8 کپی کردن محتوای لیست پخش در لیست پخش جدید. .RE .PP .TP \fBplaylist list\fR [\fB\-a\fR] .PP .RS 4 فهرست کردن تمام لیست‌های پخش. .RE .PP .RS 4 \fB\-a\fR, \fB\-\-all\fR .RE .RS 8 شامل کردن لیست‌های پخش پنهان. .RE .PP .TP \fBplaylist remove\fR \fIplaylist\fR .PP .RS 4 حذف لیست پخش داده‌شده. .RE .PP .TP \fBplaylist rename\fR [\fB\-f\fR] [\fB\-p\fR \fIplaylist\fR] \fInewname\fR .PP .RS 4 تغییر نام یک لیست پخش. به‌طور پیش‌فرض، نام لیست پخش فعال را تغییر می‌دهد. .RE .PP .RS 4 \fB\-f\fR, \fB\-\-force\fR .RE .RS 8 تغییر نام اجباری لیست پخش و بازنویسی روی لیست پخش موجود در صورت نیاز. .RE .PP .RS 4 \fB\-p\fR, \fB\-\-playlist\fR .RE .RS 8 تغییر نام لیست پخش داده‌شده. .RE .PP .TP \fBplaylist shuffle\fR [\fIplaylist\fR] .PP .RS 4 برزدن (shuffle) یک لیست پخش. به‌طور پیش‌فرض، لیست پخش فعال را برمی‌زند. .RE .PP .TP \fBplaylist sort\fR [\fB\-p\fR \fIplaylist\fR] [\fIprop\fR] ... .PP .RS 4 مرتب‌سازی یک لیست پخش. به‌طور پیش‌فرض، لیست پخش فعال را مرتب می‌کند. برای مرتب‌سازی معکوس، پیشوند '\-' را به ویژگی‌ها اضافه کنید. اگر هیچ ویژگی‌ای مشخص نشود، لیست پخش بر اساس هنرمند (artist)، آلبوم (album) و شماره قطعه (track number) مرتب می‌شود. .RE .PP .RS 4 \fB\-p\fR, \fB\-\-playlist\fR .RE .RS 8 مرتب‌سازی لیست پخش داده‌شده. .RE .PP .TP \fBplaylist switch\fR \fIplaylist\fR .PP .RS 4 تغییر لیست پخش فعال. .RE .PP .SS "دستورات مجموعه (Collection Commands)" .BR .TP \fBcollection config\fR \fIcollection\fR [\fIattrname\fR [\fIattrvalue\fR]] .PP .RS 4 دریافت یا تنظیم مشخصه‌های مجموعه داده‌شده. اگر نام مشخصه‌ای ارائه نشود، تمام مشخصه‌ها فهرست می‌شوند. اگر فقط نام مشخصه ارائه شود، مقدار آن مشخصه نمایش داده می‌شود. اگر هم نام مشخصه و هم مقدار آن ارائه شوند، مقدار جدید مشخصه تنظیم می‌شود. .RE .PP .TP \fBcollection create\fR [\fB\-f\fR] [\fB\-e\fR] [\fB\-c\fR \fIcollection\fR] \fIname\fR [\fIpattern\fR] .PP .RS 4 ایجاد یک مجموعه جدید. اگر الگو ارائه شود، برای تعریف مجموعه استفاده می‌شود. در غیر این صورت، مجموعه جدید شامل کل کتابخانه رسانه خواهد بود. .RE .PP .RS 4 \fB\-f\fR, \fB\-\-force\fR .RE .RS 8 اجبار در ایجاد مجموعه و بازنویسی روی مجموعه موجود در صورت نیاز. .RE .PP .RS 4 \fB\-c\fR, \fB\-\-collection\fR \fIcollection\fR .RE .RS 8 کپی کردن یک مجموعه موجود در مجموعه جدید. .RE .PP .RS 4 \fB\-e\fR, \fB\-\-empty\fR .RE .RS 8 مقداردهی اولیه یک مجموعه خالی. .RE .PP .TP \fBcollection list\fR .PP .RS 4 فهرست کردن تمام مجموعه‌ها. .RE .PP .TP \fBcollection show\fR \fIcollection\fR .PP .RS 4 نمایش توضیحات خوانا برای انسان از یک مجموعه. .RE .PP .TP \fBcollection remove\fR \fIcollection\fR .PP .RS 4 حذف یک مجموعه. .RE .PP .TP \fBcollection rename\fR [\fB\-f\fR] \fIoldname\fR \fInewname\fR .PP .RS 4 تغییر نام یک مجموعه. .RE .PP .RS 4 \fB\-f\fR, \fB\-\-force\fR .RE .RS 8 اجبار در تغییر نام مجموعه و بازنویسی روی مجموعه موجود در صورت نیاز. .RE .PP .SS "دستورات سرور (Server Commands)" .BR .TP \fBserver browse\fR \fIURL\fR .PP .RS 4 مرور یک نشانی اینترنتی (URL) از طریق افزونه‌های xform موجود در دیمن. .RE .PP .TP \fBserver config\fR [\fIname\fR [\fIvalue\fR]] .PP .RS 4 دریافت یا تنظیم مقادیر پیکربندی. اگر نام یا مقداری ارائه نشود، تمام مقادیر پیکربندی فهرست می‌شوند. اگر فقط نام ارائه شود، محتوای مقدار پیکربندی مربوطه نمایش داده می‌شود. اگر هم نام و هم مقدار ارائه شوند، محتوای جدید برای مقدار پیکربندی تنظیم می‌شود. نام مقدار پیکربندی مشمول بسط نویسه‌های عام شل (shell wildcard expansion) است، به‌طوری که می‌توان چندین مقدار را هم‌زمان پرس‌وجو کرد (اما نه تنظیم). .RE .PP .TP \fBserver import\fR [\fB\-N\fR] \fIpath\fR .PP .RS 4 وارد کردن فایل‌های جدید به کتابخانه رسانه. به‌طور پیش‌فرض، پوشه‌ها به‌صورت بازگشتی وارد می‌شوند. .RE .PP .RS 4 \fB\-N\fR, \fB\-\-non-recursive\fR .RE .RS 8 عدم وارد کردن پوشه‌ها به‌صورت بازگشتی. .RE .PP .TP \fBserver plugins\fR .PP .RS 4 فهرست کردن افزونه‌های بارگذاری‌شده در سرور. .RE .PP .TP \fBserver property\fR [\fB\-i\fR | \fB\-s\fR | \fB\-D\fR] [\fB\-S\fR] \fImid\fR [\fIname\fR [\fIvalue\fR]] .PP .RS 4 دریافت یا تنظیم ویژگی‌های یک رسانه مشخص. اگر نام یا مقداری ارائه نشود، تمام ویژگی‌ها فهرست می‌شوند. اگر فقط نام ارائه شود، مقدار آن ویژگی نمایش داده می‌شود. اگر هم نام و هم مقدار ارائه شوند، مقدار جدید برای ویژگی تنظیم می‌شود. به‌طور پیش‌فرض، عملیات تنظیم از منبع "client/xmms2-cli" استفاده می‌کنند، در حالی که عملیات فهرست و نمایش از source-preference استفاده می‌کنند. برای نادیده گرفتن این رفتار از گزینه \fB\-\-source\fR استفاده کنید. به‌طور پیش‌فرض، از مقدار برای تعیین اینکه باید به‌صورت یک رشته یا عدد صحیح ذخیره شود استفاده می‌شود. برای نادیده گرفتن این رفتار از فلگ \fB\-\-int\fR یا \fB\-\-string\fR استفاده کنید. .RE .PP .RS 4 \fB\-i\fR, \fB\-\-int\fR .RE .RS 8 اجبار به در نظر گرفتن مقدار به‌صورت عدد صحیح. .RE .PP .RS 4 \fB\-s\fR, \fB\-\-string\fR .RE .RS 8 اجبار به در نظر گرفتن مقدار به‌صورت رشته. .RE .PP .RS 4 \fB\-D\fR, \fB\-\-delete\fR .RE .RS 8 حذف ویژگی انتخاب‌شده. .RE .PP .RS 4 \fB\-S\fR, \fB\-\-source\fR .RE .RS 8 منبع ویژگی. .RE .PP .TP \fBserver rehash\fR [\fIpattern\fR] .PP .RS 4 محاسبه مجدد هش (rehash) رسانه‌های منطبق با الگو، یا کل کتابخانه رسانه در صورت عدم ارائه الگو. .RE .PP .TP \fBserver remove\fR [\fIpattern\fR] .PP .RS 4 حذف رسانه‌های منطبق از کتابخانه رسانه. .RE .PP .TP \fBserver shutdown\fR .PP .RS 4 خاموش کردن سرور. .RE .PP .TP \fBserver stats\fR .PP .RS 4 نمایش آمارهای مربوط به سرور: مدت زمان بالا بودن (uptime)، نسخه، اندازه کتابخانه رسانه و غیره. .RE .PP .TP \fBserver sync\fR .PP .RS 4 ذخیره فوری مجموعه‌ها روی دیسک. (در غیر این صورت فقط هنگام خاموش شدن یا ۱۰ ثانیه پس از آخرین تغییر در مجموعه‌ها انجام می‌شود.) .RE .PP .TP \fBserver volume\fR [\fB\-c\fR \fIname\fR] [\fIvalue\fR] .PP .RS 4 دریافت یا تنظیم بلندی صدا (در محدوده ۰-۱۰۰). اگر مقداری ارائه شود، بلندی صدا روی \fIvalue\fR تنظیم می‌شود. در غیر این صورت، بلندی صدای فعلی نمایش داده می‌شود. به‌طور پیش‌فرض، این دستور روی تمام کانال‌های صوتی اعمال می‌شود. برای نادیده گرفتن این رفتار از فلگ \fB\-\-channel\fR استفاده کنید. تغییرات نسبی در بلندی صدا با قرار دادن پیشوند \fB+\fR یا \fB\-\fR قبل از \fIvalue\fR امکان‌پذیر است. .RE .PP .RS 4 \fB\-c\fR, \fB\-\-channel\fR .RE .RS 8 دریافت یا تنظیم بلندی صدا فقط برای کانال مشخص‌شده. .RE .PP .SH "الگو (PATTERN)" الگوها برای جستجوی آهنگ‌ها در کتابخانه چندرسانه‌ای به کار می‌روند؛ بسته به پوسته مورد استفاده، ممکن است برخی از این الگوها نیاز به اسکیپ کردن (با '\\') داشته باشند. ویژگی‌ها را می‌توان در خروجی \fBxmms2 info\fR مشاهده کرد. .PP .TP \fB:\fR .PP .RS 4 تطبیق آهنگ‌هایی که ویژگی آن‌ها با رشته مطابقت دارد. یک \fI?\fR در رشته بیانگر یک نویسه عام منفرد و یک \fI*\fR بیانگر چند نویسه عام است. .RE .TP \fB~\fR .PP .RS 4 تطبیق فازی آهنگ‌هایی که ویژگی آن‌ها با رشته مطابقت دارد. معادل با تطبیق با \fB:\fR**. .RE .TP .PP .RS 4 عملگر می‌تواند \fB<\fR، \fB<=\fR، \fB>\fR یا \fB>=\fR باشد؛ الگو آهنگ‌هایی را تطبیق می‌دهد که ویژگی آن‌ها مقداری عددی و در مقایسه با عدد داده‌شده، کوچکتر، کوچکتر یا مساوی، بزرگتر، یا بزرگتر یا مساوی است. .RE .TP \fB+\fR .PP .RS 4 تطبیق آهنگ‌هایی که دارای این ویژگی هستند. .RE .TP \fBin:\fR/ .PP .RS 4 تطبیق آهنگ‌ها در مجموعه داده‌شده. فضای نام می‌تواند \fIPlaylists\fR یا \fICollections\fR باشد. .RE .TP \fBNOT\fR .PP .RS 4 تطبیق مکمل الگو. .RE .br \fBAND\fR .PP .RS 4 تطبیق آهنگ‌هایی که با هر دو الگو مطابقت دارند. .RE .TP \fBOR\fR .PP .RS 4 تطبیق آهنگ‌هایی که حداقل با یکی از دو الگو مطابقت دارند. .RE .TP \fB(\fR \fB)\fR .PP .RS 4 تطبیق آهنگ‌های منطبق بر الگو، مورد استفاده برای گروه‌بندی تطبیق‌های AND و OR. .RE .TP .PP .RS 4 تطبیق آهنگ‌هایی که هنرمند، عنوان یا آلبوم آن‌ها با رشته مطابقت دارد. .RE .TP ~ .PP .RS 4 تطبیق فازی آهنگ‌هایی که هنرمند، عنوان یا آلبوم آن‌ها با رشته مطابقت دارد. .RE .TP \fB#\fR .PP .RS 4 تطبیق یک شناسه خاص در کتابخانه چندرسانه‌ای. .RE .SH "الگوی موقعیت (POSITION PATTERN)" الگوهای موقعیت به همراه دستوراتی استفاده می‌شوند که روی محتوای فهرست پخش عمل می‌کنند. .TP \fBM\fR_\fBN\fR .PP .RS 4 انتخاب مدخل‌های فهرست پخش در بازه‌ای از \fBM\fR موقعیت قبل از آهنگ فعلی تا \fBN\fR موقعیت پس از آن. هر دو مقدار \fBM\fR و \fBN\fR را می‌توان نادیده گرفت که در این صورت پیش‌فرض 0 خواهد بود. .RE .TP -\fBN\fR .PP .RS 4 انتخاب آهنگ در \fBN\fR موقعیت قبل از آهنگ فعلی. .RE .TP +\fBN\fR .PP .RS 4 انتخاب آهنگ در \fBN\fR موقعیت بعد از آهنگ فعلی. .RE .TP \fBpos0\fR,\fBpos1\fR,...,\fBposN\fR .PP .RS 4 انتخاب یک تا چند موقعیت از فهرست پخش. .RE .SH "رشته قالب‌بندی (FORMAT STRING)" .PP دستوراتی که فراداده‌ها را به صورت قالب‌بندی‌شده نمایش می‌دهند را می‌توان با کمک رشته‌های قالب‌بندی تعریف‌شده توسط کاربر مانند نمونه زیر سفارشی‌سازی کرد: .PP \'${artist} - ${title}\' .RE هنگام ارسال فراداده، نام هنرمند و عنوان در رشته حاصل درج خواهد شد. علاوه بر فراداده ارائه‌شده از سوی کتابخانه چندرسانه‌ای، فهرست ویژگی‌های زیر نیز در دسترس است: .TP \fBposition\fR .PP .RS 4 موقعیت فعلی در فهرست پخش. .RE .TP \fBplayback_status\fR .PP .RS 4 وضعیت پخش به صورت یک رشته (Stopped، Playing، Paused، Unknown). .RE .TP \fBplaytime\fR .PP .RS 4 مدت زمان پخش‌شده از آهنگ در حال پخش. .RE .TP \fBduration\fR .PP .RS 4 مدت زمان کل آهنگ فعلی، به صورت دقیقه:ثانیه همراه با صفر پیشین. .RE .TP \fBminutes\fR .PP .RS 4 بخش دقیقه از مدت زمان آهنگ فعلی، همراه با صفر پیشین. .RE .TP \fBseconds\fR .PP .RS 4 بخش ثانیه از مدت زمان آهنگ فعلی، همراه با صفر پیشین. .RE .SH "نام‌های مستعار (ALIASES)" .PP فهرستی از نام‌های مستعار دستورات در زمان اجرا از بخش [alias] در فایل پیکربندی خوانده می‌شود. نحو دستورات .B xmms2 تا حدی شبیه به bash و سایر پوسته‌ها است. یک نام مستعار توسط فهرستی از دستورات و آرگومان‌های جداشده با نقطه-ویرگول تعریف می‌شود. گسترش پارامترها پشتیبانی می‌شود (بخش .B گسترش در زیر را ببینید). .PP .TP پیکربندی پیش‌فرض شامل نام‌های مستعار زیر است: .PP .TP \fBaddpls\fR .PP .RS 4 add \-f \-P $@ .RE .PP .TP \fBclear\fR .PP .RS 4 playlist clear .RE .PP .TP \fBstatus\fR .PP .RS 4 current \-f $1 .RE .PP .TP \fBls\fR .PP .RS 4 list .RE .PP .TP \fBmute\fR .PP .RS 4 server volume 0 .RE .PP .TP \fBquit\fR .PP .RS 4 server shutdown .RE .PP .TP \fBrepeat\fR .PP .RS 4 seek 0 .RE .PP .TP \fBscap\fR .PP .RS 4 stop ; playlist clear ; add $@ ; play .RE .PP .SS "گسترش (Expansion)" .B پارامترهای مکانی (Positional Parameters) .RS 4 یک نام مستعار می‌تواند از پارامترهای مکانی استفاده کند، برای مثال: .PP foo = add \-f $1 $3 .PP foo ctkoz.ogg and slre.ogg .PP منجر خواهد شد به: .PP add \-f ctkoz.ogg slre.ogg .PP .RE .B پارامترهای ویژه (Special Parameters) .RS 4 .B $@ .RS 4 این مورد به تمام پارامترهای ارسال‌شده به نام مستعار گسترش می‌یابد. .RE .PP .RE .SH "پیکربندی (CONFIGURATION)" .PP تمام کاراکترهای کنترلی همان‌طور که انتظار می‌رود تفسیر می‌شوند، از جمله دنباله‌های گریز ANSI. .PP AUTO_UNIQUE_COMPLETE .RS 4 بولی، تکمیل کردن مخفف یک دستور و آرگومان‌های آن. برای مثال: `serv vol 42' به `server volume 42' تکمیل خواهد شد. (توجه: مخفف‌ها باید بدون ابهام باشند) .RE .PP CLASSIC_LIST .RS 4 بولی، قالب‌بندی خروجی .B list مشابه با cli کلاسیک. .RE .PP CLASSIC_LIST_FORMAT .RS 4 رشته‌ای برای قالب‌بندی خروجی .B list کلاسیک. .RE .PP GUESS_PLS .RS 4 بولی، تلاش برای حدس زدن اینکه آیا URL یک لیست پخش است و افزودن مطابق با آن. (غیرقابل اتکا) .RE .PP HISTORY_FILE .RS 4 فایلی برای ذخیره تاریخچه دستورات. .RE .PP PLAYLIST_MARKER .RS 4 رشته‌ای برای مشخص کردن ورودی فعال کنونی در لیست پخش. .RE .PP PROMPT .RS 4 رشته‌ای برای استفاده به عنوان اعلان در .B حالت تعاملی (INTERACTIVE MODE) .RE .PP SERVER_AUTOSTART .RS 4 بولی، در صورت true بودن، xmms2 در صورتی که \fBxmms2d\fR(1) از قبل در حال اجرا نباشد تلاش می‌کند آن را راه‌اندازی کند. .RE .PP SHELL_START_MESSAGE .RS 4 بولی، در صورت true بودن، .B xmms2 هنگام شروع در .B حالت تعاملی (INTERACTIVE MODE) یک پیام خوش‌آمدگویی و راهنمای اولیه را نمایش می‌دهد. .RE .PP STATUS_FORMAT .RS 4 رشته‌ای برای قالب‌بندی خروجی .B status با آن. .RE .SH "فایل‌ها (FILES)" .PP $XDG_CACHE_HOME/xmms2/nyxmms2_history .RS 4 فایل پیش‌فرض تاریخچه دستورات در صورت تنظیم نشدن HISTORY_FILE. .RE .PP $XDG_CONFIG_HOME/xmms2/clients/nycli.conf .RS 4 فایل پیکربندی برای .B xmms2 .RE .SH "محیط (ENVIRONMENT)" .PP XMMS_PATH .RS 4 مسیر اتصال پیش‌فرض را لغو و جایگزین می‌کند. .TP برای اتصال از طریق IPv4 tcp://IPv4-Address:port .TP برای اتصال از طریق IPv6 tcp://[IPv6-Address]:port .TP برای اتصال از طریق سوکت یونیکس (unix socket) unix:///path/to/socket .RE .SH "اشکالات (BUGS)" لطفاً همه اشکالات را در https://github.com/xmms2 گزارش دهید .SH "نویسندگان (AUTHORS)" Igor Assis, Anders Waldenborg, Anthony Garcia, Sebastien Cevey, and Jonne Lehtinen, Daniel Svensson, Raphaël Bois .PP برای اطلاعات بیشتر فایل .B AUTHORS را در توزیع منبع XMMS2 ببینید. .PP مسئولیت این صفحه راهنما بر عهده آنتونی (Anthony) است. .PP اگر در پروژه مشارکت داشته‌اید و فکر می‌کنید نام شما باید در اینجا باشد، لطفاً یک ایمیل برای من ارسال کنید.