.TH CMUS\-REMOTE 1 05/11/2006 cmus
.nh
.ad l
.SH "نام (NAME)"
cmus\-remote \- کنترل و مدیریت پخش‌کننده صوتی cmus
.SH "خلاصه دستور (SYNOPSIS)"
cmus\-remote [\fBOPTION\fR]... [\fIFILE\fR|\fIDIR\fR|\fIPLAYLIST\fR]...
.br
cmus\-remote \fB\-C\fR \fICOMMAND\fR...
.br
cmus\-remote
.SH "توضیحات (DESCRIPTION)"
افزودن \fIFILE/DIR/PLAYLIST\fR به فهرست‌پخش، کتابخانه (\fB\-l\fR) یا صف پخش (\fB\-q\fR).
.PP
اگر هیچ آرگومانی داده نشود،
.B cmus\-remote
دستورات خام را از ورودی استاندارد (stdin) به‌صورت یک دستور در هر خط می‌خواند. دستورات خام همان دستورات حالت دستوری cmus هستند. همین دستورات در فایل‌های پیکربندی و کلیدهای میانبر نیز به کار می‌روند. صفحه راهنمای
.BR cmus (1)
شامل فهرست کامل دستورات است. برای سازگاری، جستجو نیز پشتیبانی می‌شود:
.BR "\-C /text" .
.PP
اگر گزینه
.B \-C
داده شود، تمام آرگومان‌های خط فرمان به عنوان دستورات خام در نظر گرفته می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
\-\-server SOCKET
.RS
اتصال با استفاده از سوکت \fBSOCKET\fR به جای \fI$XDG_RUNTIME_DIR/cmus\-socket\fR.
.RE

\-\-passwd PASSWD
.RS
گذرواژه مورد استفاده برای اتصال TCP/IP.
.RE

\-\-help
.RS
نمایش اطلاعات نحوه استفاده و خروج.
.RE

\-\-version
.RS
نمایش اطلاعات نسخه و خروج.
.RE

\-p, \-\-play
.RS
شروع پخش.
.RE

\-u, \-\-pause
.RS
تغییر وضعیت توقف موقت (مکث/ادامه).
.RE

\-U, \-\-pause\-playback
.RS
توقف موقت در صورت در حال پخش بودن.
.RE

\-s, \-\-stop
.RS
توقف کامل پخش.
.RE

\-n, \-\-next
.RS
پرش به قطعه بعدی در فهرست‌پخش.
.RE

\-r, \-\-prev
.RS
پرش به قطعه قبلی در فهرست‌پخش.
.RE

\-R, \-\-repeat
.RS
تغییر وضعیت تکرار.
.RE

\-S, \-\-shuffle
.RS
تغییر وضعیت پخش تصادفی.
.RE

\-v, \-\-volume VOL
.RS
تغییر میزان بلندی صدا. به دستور \fBvol\fR در \fBcmus\fR(1) مراجعه کنید.
.RE

\-k, \-\-seek SEEK
.RS
جابه‌جایی در زمان پخش قطعه (Seek). به دستور \fBseek\fR در \fBcmus\fR(1) مراجعه کنید.
.RE

\-f, \-\-file FILE
.RS
پخش از فایل.
.RE

\-Q
.RS
دریافت اطلاعات وضعیت پخش‌کننده. معادل \fB\-C status\fR. توجه داشته باشید که \fBstatus\fR یک دستور ویژه است که فقط برای cmus\-remote در دسترس است.
.RE

\-l, \-\-library
.RS
اعمال تغییرات در کتابخانه به جای فهرست‌پخش.
.RE

\-P, \-\-playlist
.RS
اعمال تغییرات در فهرست‌پخش (پیش‌فرض).
.RE

\-q, \-\-queue
.RS
اعمال تغییرات در صف پخش به جای فهرست‌پخش.
.RE

\-c, \-\-clear
.RS
پاک‌سازی فهرست‌پخش، کتابخانه (\fB\-l\fR) یا صف پخش (\fB\-q\fR).
.RE

\-C, \-\-raw
.RS
در نظر گرفتن آرگومان‌ها (به جای stdin) به عنوان دستورات خام.
.RE
.SH "دستورات از راه دور (REMOTE COMMANDS)"
دستورات ویژه‌ای که فقط برای cmus\-remote در دسترس هستند.

status
.RS
چاپ اطلاعات درباره قطعه در حال پخش.
.RE

format_print
.RS
چاپ آرگومان‌ها به عنوان \fIرشته‌های قالب‌بندی (Format Strings)\fR. هر آرگومان در یک خط جدید آغاز می‌شود.
.RE
.SH "مثال‌ها (EXAMPLES)"
افزودن فهرست‌های پخش/فایل‌ها/پوشه‌ها/نشانی‌های اینترنتی به نمای کتابخانه (۱ و ۲):

.RS
.nf
$ cmus\-remote \-l music.m3u \\
http://live.urn1350.net:8080/urn_high.ogg
.fi
.RE

بارگذاری (پاک‌سازی و افزودن) فهرست‌پخش به نمای فهرست‌پخش (۳):

.RS
.nf
$ cmus\-remote \-c music.m3u
.fi
.RE

سه روش مختلف برای تغییر وضعیت تکرار:

.RS
.nf
$ cmus\-remote \-R
$ cmus\-remote \-C "toggle repeat"
$ cmus\-remote
toggle repeat
^D
.fi
.RE

پرس‌وجوی تنظیمات یا کلیدهای میانبر:

.RS
.nf
$ cmus\-remote \-C "set repeat?"
setting: 'repeat=false'
$ cmus\-remote \-C "showbind common a"
bind common a win\-add\-l
.fi
.RE

تخلیه فهرست‌پخش در خروجی استاندارد (stdout):

.RS
.nf
$ cmus\-remote \-C "save \-p \-"
[...]
.fi
.RE

امکان جستجو نیز وجود دارد:

.RS
.nf
$ cmus\-remote \-C /beatles
.fi
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcmus\fR(1)
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Timo Hirvonen <tihirvon@gmail.com>