.TH CMUS 1 31/01/2010 cmus
.nh
.ad l
.SH "نام (NAME)"
cmus \- پخش‌کننده موسیقی متنی و سبک (C* Music Player)
.SH "خلاصه دستور (SYNOPSIS)"
\fBcmus\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
دستور \fBcmus\fR یک پخش‌کننده موسیقی متنی و سبک مبتنی بر ncurses است. این برنامه با استفاده از افزونه‌های خروجی بارگذاری‌پذیر پویا از روش‌های مختلف خروجی صدا پشتیبانی می‌کند. برنامه cmus دارای کلیدهای میانبر قابل پیکربندی است و می‌تواند از بیرون با استفاده از \fBcmus\-remote\fR(1) کنترل شود.
.SH "گزینه‌ها (OPTIONS)"
\-\-listen ADDR
.RS
گوش دادن روی ADDR (سوکت یونیکس) به‌جای \fI$CMUS_SOCKET\fR یا \fI$XDG_RUNTIME_DIR/cmus\-socket\fR. شناسه ADDR باید یک سوکت یونیکس یا host[:port] باشد.
.RE

.RS
\fBهشدار\fR: استفاده از host[:port] حتی با رمز عبور نیز ناامن است! این حالت تنها در صورتی برای شبکه محلی (LAN) مناسب است که بخواهید چندین کاربر بتوانند cmus را کنترل کنند. هرگز cmus را در دسترس اینترنت قرار ندهید.
.RE

.RS
نکته: از این گزینه برای اجرای چندین نمونه به‌صورت همزمان با یک کاربر استفاده نکنید؛ زیرا این کار حافظه نهان (کش) متاداده‌های قطعات موسیقی را خراب می‌کند.
.RE

\-\-plugins
.RS
فهرست کردن افزونه‌های موجود و خروج.
.RE

\-\-show\-cursor
.RS
همیشه مکان‌نما را نمایش می‌دهد. این گزینه برای صفحه‌خوان‌ها مفید است.
.RE

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

\-\-version
.RS
نمایش اطلاعات نگارش و خروج.
.RE
.SH "نماها (VIEWS)"
در cmus هفت نما وجود دارد. برای جابه‌جایی میان نماهای فعال، کلیدهای 1 تا 7 را فشار دهید.

نمای کتابخانه (1)
.RS
تمام قطعات موجود در \fBlibrary\fR (کتابخانه) را نمایش می‌دهد. قطعات در یک درخت گروه‌بندی‌شده بر اساس هنرمند/آلبوم مرتب شده و نمایش داده می‌شوند. مرتب‌سازی هنرمندان به‌صورت الفبایی و آلبوم‌ها بر اساس سال تولید انجام می‌شود.
.RE

نمای مرتب‌شده کتابخانه (2)
.RS
همان محتوای نمای ۱ را نمایش می‌دهد، اما به‌صورت یک فهرست ساده که بر اساس معیارهای کاربر به‌طور خودکار مرتب شده است.
.RE

نمای لیست پخش (3)
.RS
فهرست‌های پخش (playlists) قابل ویرایش را همراه با قابلیت مرتب‌سازی اختیاری نمایش می‌دهد.
.RE

نمای صف پخش (4)
.RS
قطعات بعدی در صف پخش را نمایش می‌دهد. این قطعات پیش از هر چیز دیگری (مانند لیست پخش یا کتابخانه) پخش می‌شوند. هنگامی که صف خالی شود، پخش موسیقی از آخرین موقعیت در کتابخانه از سر گرفته خواهد شد.
.RE

مرورگر فایل (5)
.RS
مرورگر پوشه‌ها را نمایش می‌دهد. در این نما می‌توان فایل‌های صوتی را از سیستم فایل به کتابخانه، لیست پخش فعال یا صف پخش اضافه کرد.
.RE

نمای فیلترها (6)
.RS
فیلترهای تعریف‌شده توسط کاربر را فهرست می‌کند.
.RE

نمای تنظیمات (7)
.RS
کلیدهای میانبر، دستورات بدون کلید و گزینه‌ها را فهرست می‌کند. برای حذف کلیدهای میانبر از \fBD\fR یا \fBdel\fR، برای تغییر کلیدها و متغیرها از \fBenter\fR، و برای جابه‌جایی مقادیر متغیرها از \fBspace\fR استفاده کنید.
.RE
.SH "خط فرمان (COMMAND LINE)"
تمام قابلیت‌ها در cmus به‌صورت دستوراتی پیاده‌سازی شده‌اند که می‌توان آن‌ها را در خط فرمان تایپ کرد یا به یک کلید نسبت داد. برای ورود به حالت فرمان، نویسه \fB:\fR را تایپ کنید. برای اجرای یک دستور کلید \fBENTER\fR و برای لغو آن \fBESC\fR یا \fBCTRL\-C\fR را فشار دهید. از کلیدهای جهت‌نمای بالا/پایین برای مرور تاریخچه دستورات استفاده کنید. از کلید \fBTAB\fR برای تکمیل خودکار دستورات و پارامترها بهره بگیرید. اگر نام دستور ابهامی نداشته باشد (هیچ دستور دیگری با همان حروف آغاز نشود)، نیازی به تایپ کامل نام دستور ندارید.

مثال‌ها:

.RS
.nf
# افزودن فایل‌ها، مخفف ':add ~/music'
:a ~/music

# تغییر افزونه خروجی
:set output_plugin=oss

# آغاز پخش
# همچنین می‌توانید کلید 'x' را فشار دهید که کلید
# میانبر پیش‌فرض این دستور است
:player\-play

# پاک‌سازی نمای جاری (کتابخانه، لیست پخش یا صف پخش)
:clear
.fi
.RE
.SH "جستجو (SEARCHING)"
حالت جستجو مانند حالت فرمان کار می‌کند. برای ورود به حالت جستجو، کلید \fB/\fR را فشار داده و عبارت جستجو را تایپ کنید، سپس \fBENTER\fR را بزنید. کلید \fBn\fR را برای رفتن به نتیجه بعدی یا \fBN\fR را برای رفتن به نتیجه قبلی فشار دهید. برای جستجو به سمت عقب، \fB?\fR را تایپ کنید.

در نماهای ۱ تا ۴، عبارت جستجو با برچسب‌های هنرمند، آلبوم و عنوان قطعه مطابقت داده می‌شود. برای جستجو تنها میان هنرمندان/آلبوم‌ها در نمای ۱ و تنها میان عناوین در نماهای ۲ تا ۴، عبارت \fB//WORDS\fR یا \fB??WORDS\fR را تایپ کنید. اگر فایل فاقد برچسب متاداده باشد، کلمات با نام فایل (بدون مسیر پوشه) مقایسه می‌شوند.

قابلیت جستجو در نماهای ۵ تا ۷ نیز کار می‌کند.
.SH "ویرایش لیست پخش (PLAYLIST EDITING)"
.SS انتخاب قطعات
دستورات ویرایش بر روی قطعات علامت‌گذاری‌شده جاری اعمال می‌شوند. اگر هیچ قطعه‌ای علامت‌گذاری نشده باشد، قطعه انتخاب‌شده جاری (یا هنرمند/آلبوم انتخاب‌شده در نمای ۱) استفاده می‌شود.

برای علامت‌گذاری قطعه انتخاب‌شده، کلید \fBSPACE\fR را فشار دهید. قطعات علامت‌گذاری‌شده با پس‌زمینه خاکستری نمایش داده می‌شوند. علامت‌گذاری قطعات فقط در نماهای فهرستی (۲ تا ۴) امکان‌پذیر است.
.SS کپی قطعات میان نماها
می‌توانید قطعات علامت‌گذاری‌شده یا انتخاب‌شده را در نماهای ۱ تا ۵ کپی کنید.
.TP
\fBa\fR
کپی قطعات به کتابخانه (۱-۲)
.TP
\fBy\fR
کپی قطعات به لیست پخش علامت‌گذاری‌شده (۳)
.TP
\fBe\fR
افزودن قطعات به انتهای صف پخش (۴)
.TP
\fBE\fR
افزودن قطعات به ابتدای صف پخش (۴)
.SS جابه‌جایی قطعات
در نماهای ۲ تا ۴، قطعات را می‌توان درون فهرست جابه‌جا کرد. توجه داشته باشید در صورتی که نما دارای مرتب‌سازی خودکار باشد، جابه‌جایی غیرفعال خواهد بود (گزینه‌های \fBlib_sort\fR و \fBpl_sort\fR را ببینید).

فشردن کلید \fBp\fR قطعات علامت‌گذاری‌شده را به موقعیت بلافاصله پس از قطعه انتخاب‌شده منتقل می‌کند. کلید \fBP\fR آن‌ها را به موقعیت بلافاصله پیش از قطعه انتخاب‌شده منتقل می‌کند. اگر هیچ قطعه‌ای علامت‌گذاری نشده باشد، قطعه انتخاب‌شده به سمت پایین (\fBp\fR) یا بالا (\fBP\fR) جابه‌جا می‌شود.

توجه داشته باشید که تغییر فیلترهای فعال در نمای ۲ باعث بارگذاری مجدد آن شده و هرگونه تغییرات اعمال‌شده در ترتیب قطعات از بین می‌رود.
.SS حذف قطعات
برای حذف قطعات علامت‌گذاری‌شده یا انتخاب‌شده در نمای جاری (۱ تا ۴)، کلید \fBD\fR یا \fBdelete\fR را فشار دهید. قطعات بلافاصله و بدون درخواست تایید از نما حذف خواهند شد. در مرورگر فایل و نمای فیلترها، همین کلیدها برای حذف یک فایل یا فیلتر پس از درخواست تایید به کار می‌روند.
.SH "خط وضعیت (STATUS LINE)"
سمت راست خط وضعیت (سطر دوم از پایین، متن سیاه روی پس‌زمینه خاکستری) شامل بخش‌های زیر است:

.nf
aaa_mode & play_sorted & play_library | volume | continue follow repeat shuffle
.fi

نکته: گزینه‌های \fBaaa_mode\fR و \fBplay_sorted\fR تنها در صورتی نمایش داده می‌شوند که \fBplay_library\fR برابر با \fBtrue\fR باشد، زیرا این گزینه‌ها هنگام پخش لیست‌های پخش (نمای ۳) بی‌معنی هستند.

فشردن کلیدهای \fBm\fR، \fBo\fR، \fBM\fR، \fBC\fR، \fBr\fR و \fBs\fR به درک بهتر معنای این بخش‌ها کمک می‌کند.

برای اطلاعات بیشتر درباره این گزینه‌ها، بخش گزینه‌های پیکربندی (CONFIGURATION OPTIONS) را ببینید.
.SH "کلیدهای میانبر (KEYBINDINGS)"
فهرست کلیدهای میانبر پیش‌فرض در ادامه آمده است. برای تغییر آن‌ها، دستورات \fBunbind\fR و \fBbind\fR را در بخش دستورات (COMMANDS) ببینید.
.SS عمومی: کنترل پخش
.nf
b                           player\-next
c                           player\-pause
x                           player\-play
z                           player\-prev
v                           player\-stop

B                           player\-next\-album
Z                           player\-prev\-album

]                           vol +0 +1%
[                           vol +1% +0
+                           vol +10%
=                           vol +10%
}                           vol \-0 \-1%
{                           vol \-1% \-0
\-                           vol \-10%

,                           seek \-1m
\&.                           seek +1m

h                           seek \-5
l                           seek +5

left                        seek \-5
right                       seek +5

mlb_click_bar               player\-pause
mlb_click_bar_right         player\-pause
mouse_scroll_up_bar         seek +5
mouse_scroll_down_bar       seek \-5
mouse_scroll_up_bar_right   vol +1%
mouse_scroll_down_bar_right vol \-1%
.fi
.SS عمومی: تغییر وضعیت تنظیمات
.nf
m                       toggle aaa_mode
C                       toggle continue
M                       toggle play_library
o                       toggle play_sorted
r                       toggle repeat
^R                      toggle repeat_current
t                       toggle show_remaining_time
s                       toggle shuffle
f                       toggle follow
.fi
.SS عمومی: دستورات
.nf
q                       quit \-i
^C                      echo Type :quit<enter> to exit cmus.
I                       echo {}

!                       push shell<space>
.fi
.SS عمومی: ناوبری نماها و پنجره‌ها
.nf
1                       view tree
2                       view sorted
3                       view playlist
4                       view queue
5                       view browser
6                       view filters
7                       view settings

mouse_scroll_up_title   left\-view
mouse_scroll_down_title right\-view

tab                     win\-next

^L                      refresh
.fi
.SS عمومی: پیمایش و ناوبری
.nf
^Y                      win\-scroll\-up
^E                      win\-scroll\-down
^B                      win\-page\-up
^F                      win\-page\-down
^U                      win\-half\-page\-up
^D                      win\-half\-page\-down

k                       win\-up
j                       win\-down
g                       win\-top
G                       win\-bottom

up                      win\-up
down                    win\-down
home                    win\-top
end                     win\-bottom
page_up                 win\-page\-up
page_down               win\-page\-down

mouse_scroll_up         win\-up
mouse_scroll_down       win\-down
.fi
.SS عمومی: انتخاب و علامت‌گذاری
.nf
i                       win\-sel\-cur
enter                   win\-activate
mlb_click_selected      win\-activate

space                   win\-toggle
D                       win\-remove
delete                  win\-remove
p                       win\-mv\-after
P                       win\-mv\-before

E                       win\-add\-Q
a                       win\-add\-l
y                       win\-add\-p
e                       win\-add\-q

u                       update\-cache
U                       win\-update\-cache
.fi
.SS عمومی: فیلترها
.nf
/                       search\-start
?                       search\-b\-start
n                       search\-next
N                       search\-prev

F                       push filter<space>
L                       push live\-filter<space>
.fi
.SS مرورگر فایل
.nf
space                   win\-activate
backspace               browser\-up
i                       toggle show_hidden
u                       win\-update
.fi
.SH "مرتب‌سازی نمای کتابخانه (LIBRARY VIEW SORTING)"
نمای کتابخانه (نمای درختی؛ نه نمای مرتب‌شده کتابخانه که با lib_sort پیکربندی می‌شود \- بخش \fICONFIGURATION OPTIONS\fR را ببینید)، به‌طور خودکار با استفاده از برچسب‌های متاداده فایل‌های صوتی مرتب می‌شود.

نکته: آلبوم‌هایی که شامل چندین هنرمند هستند (مانند گلچین‌ها یا آلبوم‌های گردآوری‌شده) به‌صورت ویژه مدیریت می‌شوند. اگر برچسب هنرمند آلبوم (album artist) یا فریم ID3v2 با نام \fBTPE2\fR تنظیم شده باشد، به‌جای نام هنرمند واقعی از آن استفاده می‌شود. در غیر این صورت، cmus بررسی می‌کند که آیا آلبوم گردآوری‌شده است یا خیر (اگر \fBalbumartist\fR یا \fBartist\fR برابر با \fBVarious Artists\fR، \fBVarious\fR، \fBVA\fR یا \fBV/A\fR باشد؛ یا اگر \fBcompilation\fR یا \fBpartofacompilation\fR مقداری معادل درست (truthy) داشته باشد؛ یا فریم ID3v2 با نام \fBTCMP\fR تنظیم شده باشد). در این حالت، هنرمند با عنوان \fB<Various Artists>\fR نام‌گذاری می‌شود.

نکته: اگر نام فایل یک URL باشد، برچسب‌های هنرمند/آلبوم روی \fB<Stream>\fR تنظیم می‌شوند. اگر یک فایل باشد، در صورتی که برچسب‌های هنرمند و/یا آلبوم تنظیم نشده باشند، cmus آن‌ها را روی \fB<No Name>\fR تنظیم می‌کند. این نام‌ها در مرتب‌سازی مانند سایر نام‌ها مدیریت می‌شوند.

به‌طور کلی، سه سطح مرتب‌سازی در نمای کتابخانه به کار می‌رود: ابتدا نام هنرمند، سپس آلبوم و در نهایت خود قطعه موسیقی.

ابتدا، cmus بر اساس مقدار الفبایی-عددی برچسب هنرمند مرتب‌سازی می‌کند. در صورت وجود برچسب مرتب‌سازی ویژه، مقدار آن استفاده خواهد شد.

سپس، cmus بر اساس آلبوم مرتب‌سازی می‌کند. قطعات بر اساس نام آلبوم گروه‌بندی می‌شوند و گروه‌ها ابتدا بر اساس تاریخ اولین قطعه و سپس به‌صورت الفبایی-عددی بر اساس نام آلبوم مرتب می‌گردند. اگر هدر تاریخ مشخص نشده باشد، آلبوم در بالای فهرست قرار می‌گیرد.

در نهایت، هر آلبوم بر اساس شماره دیسک قطعه (\fBdiscnumber\fR)، شماره قطعه (\fBtracknumber\fR) و سپس نام فایل (نه نام قطعه) مرتب می‌شود.
.SH "دستورات (COMMANDS)"
این بخش دستورات cmus را شرح می‌دهد که می‌توان آن‌ها را به کلیدها و رویدادهای ماوس مقید کرد، در فایل‌های پیکربندی قرار داد، در حالت فرمان اجرا نمود یا به cmus\-remote ارسال کرد.

پارامترهای اختیاری درون [براکت]، پارامترهای اجباری درون <براکت شکسته> و کلیدهای میانبر پیش‌فرض درون (پرانتز) آورده شده‌اند.

add [\-l] [\-p] [\-q] [\-Q] <file|dir|url|playlist>
.RS
افزودن فایل/پوشه/نشانی وب/لیست پخش به نمای مشخص‌شده یا نمای جاری.
.TP
\-l
افزودن به کتابخانه
.TP
\-p
افزودن به لیست پخش
.TP
\-q
افزودن به انتهای صف پخش
.TP
\-Q
افزودن به ابتدای صف پخش
.RE

.RS
فایل‌های پشتیبانی‌شده بر اساس افزونه‌های ورودی بارگذاری‌شده تعیین می‌شوند.
.RE

.RS
نشانی‌های وب (URLs) پشتیبانی‌شده: Shoutcast (\fIhttp://\fR...)، CDDA (\fIcdda://\fR...).
.RE

.RS
انواع لیست‌های پخش پشتیبانی‌شده: متنی ساده (plain)، m3u.، pls.
.RE

bind [\-f] <context> <key> <command>
.RS
افزودن یک کلید میانبر.
.TP
\-f
بازنویسی کلید میانبر موجود
.RE

.RS
زمینه‌ها (contexts) معتبر: common (یعنی همه نماها)، library (نماهای ۱-۲)، playlist (نمای ۳)، queue (نمای ۴)، browser (نمای ۵)، filters (نمای ۶)
.RE

.RS
برای هر نما یک زمینه وجود دارد. common یک زمینه ویژه است که در آن کلیدهای تعریف‌شده در همه نماها کار می‌کنند.
.RE

.RS
می‌توانید کلیدهای خاصی را در زمینه common برای یک نمای مشخص بازنویسی (override) کنید. برای نمونه، کلید \fBi\fR در نماهای ۱ تا ۳ قطعه جاری را انتخاب می‌کند، اما در مرورگر بازنویسی شده تا وضعیت نمایش فایل‌های پنهان را تغییر دهد.
.RE

.RS
هنگام تنظیم کلیدهای میانبر سفارشی در \fI$XDG_CONFIG_HOME/cmus/rc\fR، پیشنهاد می‌شود از گزینه \-f استفاده کنید؛ در غیر این صورت ممکن است دستور bind به دلیل وجود کلید میانبر پیشین در فایل‌های ذخیره خودکار یا پیکربندی سطح سیستم با شکست روبرو شود.
.RE

.RS
راهنمایی: می‌توانید در حالت فرمان کلید \fBtab\fR را فشار دهید تا زمینه‌ها، کلیدها و دستورات به‌طور خودکار تکمیل شوند.
.RE

browser\-up (\fBbackspace\fR)
.RS
هدایت نمای مرورگر به پوشه والد (۵). استفاده از این دستور فقط در زمینه کلید \fBbrowser\fR منطقی است، اگرچه حتی در صورت فعال نبودن نمای مرورگر نیز می‌توان از آن استفاده کرد.
.RE

cd [directory]
.RS
تغییر پوشه کاری جاری. همچنین پوشه نمایش‌داده‌شده در نمای مرورگر را تغییر می‌دهد.
.RE

clear [\-l] [\-p] [\-q]
.RS
پاک‌سازی و حذف تمام قطعات از یک نمای مشخص.
.TP
\-l
پاک‌سازی کتابخانه
.TP
\-p
پاک‌سازی لیست پخش
.TP
\-q
پاک‌سازی صف پخش
.RE

.RS
اگر نمایی مشخص نشود، از نمای جاری استفاده می‌شود.
.RE

colorscheme <name>
.RS
تغییر طرح رنگ (تم). طرح‌های رنگ در \fI/usr/share/cmus/\fR یا \fI$XDG_CONFIG_HOME/cmus/\fR قرار دارند و پسوند آن‌ها \fB.theme\fR است.
.RE

echo <arg>...
.RS
نمایش آرگومان‌ها در خط فرمان.
.RE

.RS
عبارت \fB{}\fR با نام فایل اولین قطعه انتخاب‌شده جایگزین می‌شود.
.RE

factivate <user\-defined\-filter>...
.RS
انتخاب و فعال‌سازی فیلترهای مشخص‌شده تعریف‌شده توسط کاربر (نمایش‌داده‌شده در نمای فیلترها). نام فیلترها با فاصله از یکدیگر جدا می‌شوند. این دستور بیش از همه زمانی مفید است که برای تغییر سریع فیلترهای فعال به یک کلید مقید شود. اگر هیچ آرگومانی ارائه نشود، تمام فیلترها غیرفعال می‌شوند.
.RE

.RS
قرار دادن پیشوند \fB!\fR پیش از نام فیلتر، آن را نقیض (معکوس) می‌کند.
.RE

filter <filter\-expression>
.RS
فیلتر کردن موقت نمای کتابخانه. فیلتر ذخیره نمی‌شود (برای ذخیره از \fBfset\fR و \fBfactivate\fR استفاده کنید).
.RE

fset <name>=<filter\-expression>
.RS
تعریف یا جایگزینی یک فیلتر موجود و افزودن آن به نمای فیلترها (۶).
.RE

help
.RS
نمایش اطلاعات درباره فایل‌های راهنما.
.RE

invert
.RS
معکوس کردن وضعیت علامت‌گذاری قطعات در نماهای لیست پخش و صف پخش. دستورات \fBmark\fR و \fBunmark\fR را ببینید.
.RE

live\-filter <simple\-filter\-expression|short\-filter\-expression>
.RS
مشابه filter است، اما از فیلترهای ساده استفاده می‌کند و همزمان با تایپ شما پیش‌نمایش را نمایش می‌دهد. این فیلتر حتی پس از خروج از حالت فرمان نیز باقی می‌ماند.
.RE

load [\-l] <playlist>
.RS
بارگذاری یک لیست پخش در یک نما.
.TP
\-l
بارگذاری در نماهای کتابخانه
.RE

.RS
اگر نمایی مشخص نشود، از نمای جاری استفاده می‌شود که باید ۱ یا ۲ باشد.
.RE

lqueue [NUM]
.RS
افزودن NUM (پیش‌فرض ۱) آلبوم تصادفی از کتابخانه به صف پخش. دستور \fBtqueue\fR را نیز ببینید.
.RE

mark <filter\-expression>
.RS
علامت‌گذاری قطعات در نمای لیست پخش و صف پخش با استفاده از عبارت فیلتر.
.RE

mute
.RS
تغییر وضعیت بی‌صدا (mute) برای خروجی صدا.
.RE

pl\-create <name>
.RS
ایجاد یک لیست پخش جدید.
.RE

pl\-delete [\-a] <name>
.RS
حذف لیست پخش با نام داده‌شده.
.RE

.RS
\-a
.RS
حذف تمام لیست‌های پخش
.RE
.RE

pl\-export <filename>
.RS
خروجی گرفتن از لیست پخش انتخاب‌شده جاری. در صورت وجود فایل، بازنویسی خواهد شد.
.RE

pl\-import [filename]
.RS
وارد کردن (ایمپورت) یک لیست پخش به نمای لیست پخش. در نمای مرورگر فایل می‌توان این آرگومان را نادیده گرفت.
.RE

pl\-rename <name>
.RS
تغییر نام لیست پخش انتخاب‌شده.
.RE

player\-next (\fBb\fR)
.RS
پرش به قطعه بعدی.
.RE

player\-next\-album (\fBB\fR)
.RS
پرش به آلبوم بعدی. اگر \fBshuffle\fR=\fItracks\fR باشد یا یک لیست پخش فعال باشد، به قطعه بعدی می‌پرد.
.RE

player\-pause (\fBc\fR)
.RS
تغییر وضعیت مکث (pause).
.RE

player\-pause\-playback
.RS
مکث در صورت پخش در حال حاضر.
.RE

player\-play [filename] (\fBx\fR)
.RS
پخش قطعه مشخص‌شده، یا در صورت مشخص نشدن، پخش مجدد قطعه جاری از ابتدا.
.RE

player\-prev (\fBz\fR)
.RS
پرش به قطعه قبلی.
.RE

player\-prev\-album (\fBZ\fR)
.RS
پرش به آلبوم قبلی. اگر \fBshuffle\fR=\fItracks\fR باشد یا یک لیست پخش فعال باشد، به قطعه قبلی می‌پرد.
.RE

player\-stop (\fBv\fR)
.RS
توقف پخش.
.RE

prev\-view
.RS
رفتن به نمایی که پیش از این استفاده شده است.
.RE

left\-view [\-n]
.RS
رفتن به نمای سمت چپ نمای جاری (برای نمونه: نمای ۴ به نمای ۳).
.TP
\-n
عدم چرخش به انتها هنگام رسیدن به اولین نما
.RE

right\-view [\-n]
.RS
رفتن به نمای سمت راست نمای جاری (برای نمونه: نمای ۳ به نمای ۴).
.TP
\-n
عدم چرخش به ابتدا هنگام رسیدن به آخرین نما
.RE

push [text]
.RS
ورود به حالت فرمان با خط فرمانی که از پیش با متن تنظیم شده است. مثال:
.RE

.RS
.RS
bind common w push filter artist=
.RE
.RE

.RS
متن می‌تواند شامل فاصله‌ها باشد که به همان شکل استفاده می‌شوند (فاصله‌های انتهایی حفظ می‌شوند). اگر متنی داده نشود، به خط فرمان خالی پیش‌فرض می‌شود.
.RE

.RS
این دستور تنها می‌تواند از طریق کلیدهای میانبر استفاده شود.
.RE

pwd
.RS
چاپ پوشه کاری جاری.
.RE

quit [\-i] (\fBq\fR, \fB:wq\fR)
.RS
خروج از cmus.
.TP
\-i
درخواست تایید پیش از خروج
.RE

raise\-vte
.RS
بالا آوردن پنجره شبیه‌ساز ترمینال مجازی. تنها درون یک نشست X کار می‌کند.
.RE

rand
.RS
تصادفی‌سازی (بر زدن) قطعات در نمای کتابخانه، لیست پخش یا صف پخش.
.RE

refresh (\fB^L\fR)
.RS
بازتولید و ترسیم مجدد پنجره ترمینال.
.RE

reshuffle
.RS
بر زدن مجدد فهرست‌های تصادفی برای هر دو نمای کتابخانه و لیست پخش.
.RE

run <command>
.RS
اجرای یک دستور برای قطعات علامت‌گذاری‌شده یا قطعه انتخاب‌شده (در صورت علامت‌گذاری نشدن قطعه‌ای).
.RE

.RS
به‌طور پیش‌فرض، نام فایل‌ها به انتهای دستور پیوست می‌شوند. اگر دستور حاوی \fB{}\fR باشد، با فهرستی از نام‌های فایل جایگزین می‌شود.
.RE

.RS
نکته: در نمای ۱ می‌توانید یک دستور را برای تمام فایل‌های آلبوم یا هنرمند انتخاب‌شده اجرا کنید.
.RE

save [\-e]  [\-l] [\-L] [\-p] [\-q]  [file]  (\fB:w\fR)
.RS
ذخیره محتویات یک نما در یک فایل لیست پخش. در حالت توسعه‌یافته (\-e)، متاداده قطعه نیز ذخیره می‌شود.
.TP
\-l
ذخیره نماهای کتابخانه
.TP
\-L
ذخیره نماهای فیلترشده کتابخانه
.TP
\-p
ذخیره نمای لیست پخش
.TP
\-q
ذخیره نمای صف پخش
.RE

.RS
اگر نمایی مشخص نشود، از نمای جاری استفاده می‌شود.
.RE

.RS
اگر نام فایلی داده نشود، از نام فایل قبلی استفاده می‌شود. مقدار "\-" خروجی را به خروجی استاندارد هدایت می‌کند (تنها به‌صورت راه دور کار می‌کند).
.RE

search\-b\-start
.RS
ورود به حالت جستجوی معکوس (به سمت عقب). نمی‌توان مستقیماً از حالت فرمان استفاده کرد.
.RE

.RS
دستور \fBsearch\-start\fR را ببینید.
.RE

search\-next (\fBn\fR)
.RS
در صورت وجود جستجوی فعال، به تطابق بعدی در نمای جاری می‌رود. بخش \fBجستجو (SEARCHING)\fR در بالا را ببینید.
.RE

search\-prev (\fBN\fR)
.RS
در صورت وجود جستجوی فعال، به تطابق قبلی در نمای جاری می‌رود. بخش \fBجستجو (SEARCHING)\fR در بالا را ببینید.
.RE

search\-start
.RS
ورود به حالت جستجو. نمی‌تواند مستقیماً از حالت فرمان استفاده شود.
.RE

.RS
این دستور مشابه live\-filter است، جز اینکه موقتی است و به‌جای فیلتر کردن کل نما، تنها تطابق جاری را انتخاب می‌کند.
.RE

seek [+\-](<num>[mh] | [HH:]MM:SS)
.RS
پرش به موقعیت مطلق یا نسبی در قطعه، که می‌تواند بر حسب ثانیه، دقیقه (m)، ساعت (h) یا قالب HH:MM:SS مشخص شود که در آن HH: اختیاری است.
.RE

.RS
۱ دقیقه به عقب
.RS
:seek \-1m
.RE
.RE

.RS
۵ ثانیه به جلو
.RS
:seek +5
.RE
.RE

.RS
پرش به موقعیت مطلق ۱ ساعت
.RS
:seek 1h
.RE
.RE

.RS
۹۰ ثانیه به جلو
.RS
:seek +1:30
.RE
.RE

set <option>=<value>
.RS
تنظیم مقدار یک گزینه. بخش \fBگزینه‌ها (OPTIONS)\fR را ببینید.
.RE

set <option>
.RS
نمایش مقدار گزینه. نگارش سازگار با ویم \fBset <option>?\fR نیز پشتیبانی می‌شود.
.RE

shell <command>
.RS
اجرای یک دستور از طریق bin/sh \-c/.
.RE

showbind <context> <key>
.RS
نمایش کلید میانبر.
.RE

source <filename>
.RS
خواندن و اجرای دستورات از <filename>.
.RE

toggle <option>
.RS
تغییر وضعیت مقدار یک گزینه دودویی یا قابل تغییر وضعیت (تمام مقادیر بولی و گزینه‌های \fBshuffle\fR، \fBaaa_mode\fR و \fBreplaygain\fR).
.RE

tqueue [NUM]
.RS
افزودن NUM (پیش‌فرض ۱) قطعه تصادفی از کتابخانه به صف پخش. دستور \fBlqueue\fR را نیز ببینید.
.RE

unbind [\-f] <context> <key>
.RS
حذف یک کلید میانبر. از tab برای چرخش میان کلیدهای مقیدشده استفاده کنید.
.RE

.RS
\-f
.RS
عدم صدور خطا در صورت ناشناخته بودن کلید میانبر
.RE
.RE

unmark
.RS
لغو علامت‌گذاری تمام قطعات (دستور \fBmark\fR را ببینید).
.RE

update\-cache [\-f]
.RS
به‌روزرسانی حافظه نهان (کش) متاداده‌های قطعات ($XDG_CONFIG_HOME/cmus/cache). به‌طور پیش‌فرض، تنها موارد حذف‌شده یا فایل‌هایی با زمان ویرایش تغییریافته به‌روزرسانی می‌شوند.
.RE

.RS
\-f
.RS
به‌روزرسانی تمام فایل‌ها. معادل quit، سپس rm \-f $XDG_CONFIG_HOME/cmus/cache و اجرای مجدد cmus.
.RE
.RE

version
.RS
چاپ اطلاعات نگارش.
.RE

view <name or 1\-7>
.RS
تغییر نمای فعال.
.RE

.RS
از این دستور در \fI$XDG_CONFIG_HOME/cmus/rc\fR برای تغییر نمای شروع استفاده نکنید. به‌جای آن گزینه \fBstart_view\fR را تنظیم کنید.
.RE

vol [+\-]NUM[%] [[+\-]NUM[%]]
.RS
تغییر بلندی صدا.
.RE

.RS
اگر یک آرگومان داده شود، هر دو کانال تغییر می‌کنند. در غیر این صورت، مقادیر اول/دوم به‌ترتیب مربوط به کانال‌های چپ/راست هستند.
.RE

.RS
برای افزایش یا کاهش صدا، مقدار را با \fB\-\fR یا \fB+\fR پیشوندگذاری کنید؛ در غیر این صورت مقدار به‌عنوان بلندی صدای مطلق در نظر گرفته می‌شود.
.RE

.RS
هر دو مقدار مطلق و نسبی می‌توانند به‌صورت واحد درصدی (با پسوند \fB%\fR) یا به‌عنوان مقادیر داخلی (برای نمونه سخت‌افزار ممکن است بلندی صدایی در محدوده ۰-۳۱ داشته باشد) ارائه شوند.
.RE

w
.RS
دستور \fBquit\fR را ببینید. برای استفاده در حالت فرمان در نظر گرفته شده است.
.RE

win\-activate (\fBenter\fR)
.RS
در نماهای ۱ تا ۳، قطعه انتخاب‌شده را پخش می‌کند. در نمای ۵، فایل انتخاب‌شده را پخش کرده یا وارد پوشه انتخاب‌شده می‌شود. در نمای ۶، فیلترهای انتخاب‌شده را فعال می‌کند. در نمای تنظیمات (۷)، کلید میانبر یا متغیر را تغییر می‌دهد.
.RE

win\-add\-l [\-n] (\fBa\fR)
.RS
افزودن قطعه(های) علامت‌گذاری‌شده یا انتخاب‌شده جاری (نماهای ۳-۴)، یا فایل/پوشه انتخاب‌شده جاری (نمای ۵) به کتابخانه.
.RE

.RS
مشابه \fB:add \-l\fR
.RE

.RS
\-n
.RS
عدم انتقال انتخاب به مورد بعدی.
.RE
.RE

win\-add\-p [\-n] (\fBy\fR)
.RS
افزودن قطعه(های) علامت‌گذاری‌شده یا انتخاب‌شده جاری (نماهای ۱-۲، ۴)، یا فایل/پوشه انتخاب‌شده جاری (نمای ۵) به لیست پخش علامت‌گذاری‌شده.
.RE

.RS
مشابه \fB:add \-p\fR
.RE

.RS
\-n
.RS
عدم انتقال انتخاب به مورد بعدی.
.RE
.RE

win\-add\-Q [\-n] (\fBE\fR)
.RS
افزودن قطعه(های) علامت‌گذاری‌شده یا انتخاب‌شده جاری (نماهای ۱-۳)، یا فایل/پوشه انتخاب‌شده جاری (نمای ۵) به ابتدای صف پخش.
.RE

.RS
مشابه \fB:add \-Q\fR
.RE

.RS
\-n
.RS
عدم انتقال انتخاب به مورد بعدی.
.RE
.RE

win\-add\-q [\-n] (\fBe\fR)
.RS
افزودن قطعه(های) علامت‌گذاری‌شده یا انتخاب‌شده جاری (نماهای ۱-۳)، یا فایل/پوشه انتخاب‌شده جاری (نمای ۵) به انتهای صف پخش.
.RE

.RS
مشابه \fB:add \-q\fR
.RE

.RS
\-n
.RS
عدم انتقال انتخاب به مورد بعدی.
.RE
.RE

win\-bottom (\fBG\fR, \fBend\fR)
.RS
رفتن به انتهای پنجره جاری.
.RE

win\-down [NUM] (\fBj\fR, \fBdown\fR)
.RS
رفتن به اندازه NUM (پیش‌فرض ۱) سطر به سمت پایین در پنجره جاری.
.RE

win\-half\-page\-down (\fB^D\fR)
.RS
رفتن به اندازه نیم صفحه به سمت پایین در پنجره جاری.
.RE

win\-half\-page\-up (\fB^U\fR)
.RS
رفتن به اندازه نیم صفحه به سمت بالا در پنجره جاری.
.RE

win\-mv\-after (\fBp\fR)
.RS
انتقال قطعات علامت‌گذاری‌شده به زیر قطعه انتخاب‌شده. اگر هیچ قطعه‌ای انتخاب نشده باشد، قطعه قبلی را انتخاب می‌کند. اگر هیچ قطعه‌ای علامت‌گذاری نشده باشد، قطعه انتخاب‌شده را یک سطر بالا می‌برد. این دستور در نماهای لیست پخش و صف پخش کار می‌کند.
.RE

win\-mv\-before (\fBP\fR)
.RS
انتقال قطعات علامت‌گذاری‌شده به بالای قطعه انتخاب‌شده. اگر هیچ قطعه‌ای انتخاب نشده باشد، قطعه قبلی را انتخاب می‌کند. اگر هیچ قطعه‌ای علامت‌گذاری نشده باشد، قطعه انتخاب‌شده را یک سطر پایین می‌برد. این دستور در نماهای لیست پخش و صف پخش کار می‌کند.
.RE

win\-next (\fBtab\fR)
.RS
فعال‌سازی پنجره بعدی (درخت/فهرست). تنها در نمای ۱ کاربرد دارد.
.RE

win\-page\-bottom
.RS
رفتن به انتهای بخش قابل مشاهده پنجره جاری.
.RE

win\-page\-down (\fB^F\fR, \fBpage_down\fR)
.RS
رفتن یک صفحه به سمت پایین در پنجره جاری.
.RE

win\-page\-middle
.RS
رفتن به میانه بخش قابل مشاهده پنجره جاری.
.RE

win\-page\-top
.RS
رفتن به بالای بخش قابل مشاهده پنجره جاری.
.RE

win\-page\-up (\fB^B\fR, \fBpage_up\fR)
.RS
رفتن یک صفحه به سمت بالا در پنجره جاری.
.RE

win\-remove (\fBD\fR, \fBdelete\fR)
.RS
حذف مورد انتخاب‌شده. برای قطعات موسیقی، تاییدی نیاز نیست. برای لیست‌های پخش (نمای ۳)، فایل‌ها (نمای ۵)، فیلترها (نمای ۶) و کلیدهای میانبر (نمای ۷)، کاربر باید عملیات را تایید کند.
.RE

win\-scroll\-down (\fB^E\fR)
.RS
پیمایش پنجره جاری به اندازه یک سطر به سمت پایین.
.RE

win\-scroll\-up (\fB^Y\fR)
.RS
پیمایش پنجره جاری به اندازه یک سطر به سمت بالا.
.RE

win\-sel\-cur (\fBi\fR)
.RS
انتخاب قطعه جاری (موقعیت در کتابخانه یا لیست پخش، نه لزوماً همان قطعه‌ای که هم‌اکنون در حال پخش است). فقط در نماهای ۱ تا ۳ کار می‌کند و در سایر نماها کاری انجام نمی‌دهد.
.RE

win\-toggle (\fBspace\fR)
.RS
گسترش یا بستن آلبوم‌ها در نمای کتابخانه (۱)، علامت‌گذاری قطعات در نماهای ۲ تا ۴، تعیین لیست پخش علامت‌گذاری‌شده در نمای ۳، تغییر وضعیت انتخاب یک فیلتر در نمای ۶، یا تغییر وضعیت مقدار یک متغیر در نمای ۷.
.RE

win\-top (\fBg\fR, \fBhome\fR)
.RS
رفتن به ابتدای پنجره جاری.
.RE

win\-up [NUM] (\fBk\fR, \fBup\fR)
.RS
رفتن به اندازه NUM (پیش‌فرض ۱) سطر به سمت بالا در پنجره جاری.
.RE

win\-update (\fBu\fR)
.RS
بررسی زمان ویرایش فایل‌ها در کتابخانه و به‌روزرسانی متاداده برای فایل‌های تغییریافته. حذف فایل‌های ناموجود از کتابخانه.
.RE

.RS
بارگذاری مجدد محتویات پوشه در نمای مرورگر.
.RE

.RS
تنها در نماهای ۱-۲ و ۵ کار می‌کند؛ در سایر نماها کاری انجام نمی‌دهد.
.RE

win\-update\-cache [\-f]
.RS
مشابه \fBupdate\-cache\fR، اما تنها برای قطعات علامت‌گذاری‌شده / انتخاب‌شده. فقط در نماهای ۱ تا ۲ کار می‌کند؛ در سایر نماها کاری انجام نمی‌دهد.
.RE

wq
.RS
دستور \fBquit\fR را ببینید. برای استفاده از حالت فرمان در نظر گرفته شده است.
.RE
.SH "گزینه‌های پیکربندی (CONFIGURATION OPTIONS)"
این بخش گزینه‌های پیکربندی مورد استفاده در cmus را شرح می‌دهد.

این گزینه‌ها را می‌توان با استفاده از دستورات \fBset\fR و \fBtoggle\fR تغییر داد. مقادیر پیش‌فرض درون (پرانتز) و مقادیر ممکن درون [براکت] قرار دارند.

auto_expand_albums_follow, auto_expand_albums_search, auto_expand_albums_selcur (true)
.RS
همیشه هنگام دنبال کردن قطعه در حال پخش یا انجام اقداماتی مانند «جستجو» یا «رفتن به قطعه جاری»، هنرمند را باز کرده و آلبوم را انتخاب می‌کند. این گزینه پیوند نزدیکی با گزینه show_all_tracks دارد. هر «auto_expand_albums_* = false» متضمن «show_all_tracks = true» است.
.RE

auto_hide_playlists_panel (false)
.RS
پنهان کردن پنل سمت چپ در نمای لیست پخش. این پنل در صورت نیاز هنگام فعال‌سازی با win\-next (\fBtab\fR) نمایش داده می‌شود.
.RE

auto_reshuffle (true)
.RS
بر زدن مجدد لیست پخش هنگامی که به انتهای فهرست تصادفی‌شده برسد.
.RE

aaa_mode (all) [all, artist, album]
.RS
مشخص می‌کند چه قطعاتی باید در نمای کتابخانه پخش شوند. در سایر نماها استفاده نمی‌شود.
.RE

.RS
برای نمونه، اگر روی \fBartist\fR تنظیم شود، پخش‌کننده به‌گونه‌ای عمل می‌کند که گویی تنها فایل‌های هنرمند در حال پخش در کتابخانه وجود دارند.
.RE

altformat_current [\fIFormat String\fR]
.RS
رشته قالب جایگزین برای سطری که قطعه در حال پخش جاری را نمایش می‌دهد.
.RE

.RS
نکته: در صورت خالی بودن، از \fBformat_current\fR استفاده می‌شود.
.RE

altformat_playlist [\fIFormat String\fR]
.RS
رشته قالب جایگزین برای نماهای فهرستی (۲ تا ۴).
.RE

.RS
نکته: در صورت خالی بودن، از \fBformat_playlist\fR استفاده می‌شود.
.RE

altformat_title [\fIFormat String\fR]
.RS
رشته قالب جایگزین برای عنوان ترمینال.
.RE

.RS
نکته: همه پایانه‌ها از تغییر عنوان پنجره پشتیبانی نمی‌کنند.
.RE

.RS
نکته: در صورت خالی بودن، از \fBformat_title\fR استفاده می‌شود.
.RE

altformat_trackwin [\fIFormat String\fR]
.RS
رشته قالب جایگزین برای پنجره قطعات نمای درختی (۱).
.RE

.RS
نکته: در صورت خالی بودن، از \fBformat_trackwin\fR استفاده می‌شود.
.RE

block_key_paste (true)
.RS
جلوگیری از ورودی تصادفی با پذیرش متن جای‌گذاری‌شده (paste) تنها در خط فرمان. فقط در پایانه‌هایی کار می‌کند که از براکتد پیست (bracketed paste) پشتیبانی می‌کنند.
.RE

buffer_seconds (10) [1\-300]
.RS
اندازه بافر پخش‌کننده بر حسب ثانیه.
.RE

color_cmdline_bg (default) [\fIColor\fR]
.RS
رنگ پس‌زمینه خط فرمان.
.RE

color_cmdline_fg (default) [\fIColor\fR]
.RS
رنگ پیش‌زمینه خط فرمان.
.RE

color_cmdline_attr (default) [\fIAttributes\fR]
.RS
ویژگی‌های قلم خط فرمان.
.RE

color_error (lightred) [\fIColor\fR]
.RS
رنگ پیام‌های خطای نمایش‌داده‌شده در خط فرمان.
.RE

color_info (lightyellow) [\fIColor\fR]
.RS
رنگ پیام‌های اطلاع‌رسانی نمایش‌داده‌شده در خط فرمان.
.RE

color_separator (blue) [\fIColor\fR]
.RS
رنگ خط جداکننده بین پنجره‌ها در نمای (۱).
.RE

color_statusline_bg (gray) [\fIColor\fR]
.RS
رنگ پس‌زمینه خط وضعیت.
.RE

color_statusline_fg (black) [\fIColor\fR]
.RS
رنگ پیش‌زمینه خط وضعیت.
.RE

color_statusline_attr (default) [\fIAttributes\fR]
.RS
ویژگی‌های قلم خط وضعیت.
.RE

color_statusline_progress_bg (blue) [\fIColor\fR]
.RS
رنگ پس‌زمینه نوار پیشرفت در خط وضعیت، در صورت فعال بودن.
.RE

color_statusline_progress_fg (white) [\fIColor\fR]
.RS
رنگ پیش‌زمینه نوار پیشرفت در خط وضعیت، در صورت فعال بودن.
.RE

color_statusline_progress_attr (default) [\fIAttributes\fR]
.RS
ویژگی‌های قلم نوار پیشرفت در خط وضعیت، در صورت فعال بودن.
.RE

color_titleline_bg (blue) [\fIColor\fR]
.RS
رنگ پس‌زمینه سطر نمایش‌دهنده قطعه در حال پخش جاری.
.RE

color_titleline_fg (white) [\fIColor\fR]
.RS
رنگ پیش‌زمینه سطر نمایش‌دهنده قطعه در حال پخش جاری.
.RE

color_titleline_attr (default) [\fIAttributes\fR]
.RS
ویژگی‌های قلم سطر نمایش‌دهنده قطعه در حال پخش جاری.
.RE

color_win_bg (default) [\fIColor\fR]
.RS
رنگ پس‌زمینه پنجره.
.RE

color_win_cur (lightyellow) [\fIColor\fR]
.RS
رنگ قطعه در حال پخش جاری.
.RE

color_win_cur_attr (default) [\fIAttributes\fR]
.RS
ویژگی‌های قلم قطعه در حال پخش جاری.
.RE

color_win_cur_sel_bg (blue) [\fIColor\fR]
.RS
رنگ پس‌زمینه سطر انتخاب‌شده‌ای که در پنجره فعال هم‌زمان قطعه در حال پخش نیز هست.
.RE

color_win_cur_sel_fg (lightyellow) [\fIColor\fR]
.RS
رنگ پیش‌زمینه سطر انتخاب‌شده‌ای که در پنجره فعال هم‌زمان قطعه در حال پخش نیز هست.
.RE

color_win_cur_sel_attr (default) [\fIAttributes\fR]
.RS
ویژگی‌های قلم سطر انتخاب‌شده‌ای که در پنجره فعال هم‌زمان قطعه در حال پخش نیز هست.
.RE

color_win_dir (lightblue) [\fIColor\fR]
.RS
رنگ پوشه‌ها در مرورگر.
.RE

color_win_fg (default) [\fIColor\fR]
.RS
رنگ پیش‌زمینه پنجره.
.RE

color_win_attr (default) [\fIAttributes\fR]
.RS
ویژگی‌های قلم پنجره.
.RE

color_win_inactive_cur_sel_bg (gray) [\fIColor\fR]
.RS
رنگ پس‌زمینه سطر انتخاب‌شده‌ای که در پنجره غیرفعال هم‌زمان قطعه در حال پخش نیز هست.
.RE

color_win_inactive_cur_sel_fg (lightyellow) [\fIColor\fR]
.RS
رنگ پیش‌زمینه سطر انتخاب‌شده‌ای که در پنجره غیرفعال هم‌زمان قطعه در حال پخش نیز هست.
.RE

color_win_inactive_cur_sel_attr (default) [\fIAttributes\fR]
.RS
ویژگی‌های قلم سطر انتخاب‌شده‌ای که در پنجره غیرفعال هم‌زمان قطعه در حال پخش نیز هست.
.RE

color_win_inactive_sel_bg (gray) [\fIColor\fR]
.RS
رنگ پس‌زمینه سطر انتخاب‌شده در پنجره غیرفعال.
.RE

color_win_inactive_sel_fg (black) [\fIColor\fR]
.RS
رنگ پیش‌زمینه سطر انتخاب‌شده در پنجره غیرفعال.
.RE

color_win_inactive_sel_attr (default) [\fIAttributes\fR]
.RS
ویژگی‌های قلم سطر انتخاب‌شده در پنجره غیرفعال.
.RE

color_win_sel_bg (blue) [\fIColor\fR]
.RS
رنگ پس‌زمینه سطر انتخاب‌شده در پنجره فعال.
.RE

color_win_sel_fg (white) [\fIColor\fR]
.RS
رنگ پیش‌زمینه سطر انتخاب‌شده در پنجره فعال.
.RE

color_win_sel_attr (default) [\fIAttributes\fR]
.RS
ویژگی‌های قلم سطر انتخاب‌شده در پنجره فعال.
.RE

color_win_title_bg (blue) [\fIColor\fR]
.RS
رنگ پس‌زمینه عنوان پنجره‌ها (بالاترین سطر صفحه نمایش).
.RE

color_win_title_fg (white) [\fIColor\fR]
.RS
رنگ پیش‌زمینه عنوان پنجره‌ها (بالاترین سطر صفحه نمایش).
.RE

color_win_title_attr (default) [\fIAttributes\fR]
.RS
ویژگی‌های قلم عنوان پنجره‌ها (بالاترین سطر صفحه نمایش).
.RE

color_trackwin_album_bg (default) [\fIColor\fR]
.RS
رنگ پس‌زمینه سطر آلبوم نمایش‌داده‌شده در پنجره قطعات.
.RE

color_trackwin_album_fg (default) [\fIColor\fR]
.RS
رنگ پیش‌زمینه سطر آلبوم نمایش‌داده‌شده در پنجره قطعات.
.RE

color_trackwin_album_attr (bold) [\fIAttributes\fR]
.RS
ویژگی‌های قلم سطر آلبوم نمایش‌داده‌شده در پنجره قطعات.
.RE

confirm_run (true)
.RS
درخواست تایید پیش از اجرای \fB:run\fR.
.RE

continue (true)
.RS
ادامه پخش پس از پایان قطعه جاری.
.RE

continue_album (true)
.RS
ادامه پخش آلبوم بعدی پس از پایان آلبوم جاری.
.RE

device (/dev/cdrom)
.RS
فایل دستگاه CDDA.
.RE

display_artist_sort_name (false)
.RS
در صورت فعال بودن، به‌جای نام‌های عادی، همواره نام‌های هنرمند مورد استفاده برای مرتب‌سازی را در نمای درختی نمایش می‌دهد (مانند «Artist, The» به‌جای «The Artist»)، تا ستون هنرمندان به‌صورت الفبایی مرتب به نظر برسد.
.RE

follow (false)
.RS
در صورت فعال بودن، با تغییر هر قطعه، همواره قطعه در حال پخش انتخاب می‌شود.
.RE

format_clipped_text [\fIPlain String\fR]
.RS
رشته‌ای که برای نشان دادن متون بریده‌شده به‌دلیل محدودیت طول فیلد استفاده می‌شود.
.RE

.RS
نکته: قواعد \fIرشته قالب\fR اعمال نمی‌شوند. یک رشته متنی ساده مانند «...» انتظار می‌رود.
.RE

format_current [\fIFormat String\fR]
.RS
رشته قالب برای سطر نمایش‌دهنده قطعه در حال پخش جاری.
.RE

format_heading_album [\fIFormat String\fR]
.RS
رشته قالب برای سطر سرآیند پنجره قطعات هنگامی که یک آلبوم در درخت انتخاب شده باشد.
.RE

format_heading_artist [\fIFormat String\fR]
.RS
رشته قالب برای سطر سرآیند پنجره قطعات هنگامی که یک هنرمند در درخت انتخاب شده باشد.
.RE

format_heading_playlist [\fIFormat String\fR]
.RS
رشته قالب برای سطر سرآیند در نمای لیست پخش (۳).
.RE

format_playlist [\fIFormat String\fR]
.RS
رشته قالب برای نماهای فهرستی (۲ تا ۴).
.RE

format_playlist_va [\fIFormat String\fR]
.RS
رشته قالب برای نماهای فهرستی (۲ تا ۴)، در صورتی که فرض شود یک قطعه بخشی از آلبوم گردآوری‌شده است (برای جزئیات \fIمرتب‌سازی نمای کتابخانه\fR را ببینید).
.RE

.RS
نکته: در صورت خالی بودن، از \fBformat_playlist\fR استفاده می‌شود.
.RE

format_statusline [\fIFormat String\fR]
.RS
رشته قالب برای خط وضعیت.
.RE

format_title [\fIFormat String\fR]
.RS
رشته قالب برای عنوان پنجره ترمینال.
.RE

.RS
نکته: همه پایانه‌ها از تغییر عنوان پنجره پشتیبانی نمی‌کنند.
.RE

format_trackwin [\fIFormat String\fR]
.RS
رشته قالب برای پنجره قطعات نمای درختی (۱).
.RE

format_trackwin_album [\fIFormat String\fR]
.RS
رشته قالب برای آلبوم‌ها در پنجره قطعات نمای درختی (۱).
.RE

format_trackwin_va [\fIFormat String\fR]
.RS
رشته قالب برای پنجره قطعات نمای درختی (۱)، اگر قطعه بخشی از یک گردآوری باشد (برای جزئیات \fIمرتب‌سازی نمای کتابخانه\fR را ببینید).
.RE

.RS
نکته: در صورت خالی بودن، از \fBformat_trackwin\fR استفاده می‌شود.
.RE

format_treewin [\fIFormat String\fR]
.RS
رشته قالب برای پنجره درختی در نمای درختی (۱).
.RE

format_treewin_artist [\fIFormat String\fR]
.RS
رشته قالب برای هنرمندان در پنجره درختی نمای درختی (۱).
.RE

smart_artist_sort (true)
.RS
در صورت فعال بودن، مرتب‌سازی نمای درختی پیشوند «The» را در ابتدای نام هنرمندان نادیده می‌گیرد و مانع از تجمع هنرمندانی که با «The» شروع می‌شوند در یک‌جا می‌گردد. برچسب‌های واقعی \fIartistsort\fR در صورت وجود این گزینه را لغو می‌کنند.
.RE

sort_albums_by_name (false)
.RS
در نمای درختی (۱)، آلبوم‌ها به‌جای تاریخ بر اساس نام مرتب خواهند شد.
.RE

id3_default_charset (ISO\-8859\-1)
.RS
مجموعه نویسه‌های پیش‌فرض برای برچسب‌های ID3v1 و برچسب‌های خراب ID3v2.
.RE

.RS
نکته: این مورد تنها زمانی استفاده می‌شود که برچسب یک UTF\-8 معتبر نباشد.
.RE

icecast_default_charset (ISO\-8859\-1)
.RS
مجموعه نویسه‌های پیش‌فرض برای متاداده‌های غیراستاندارد استریم‌های icecast غیر UTF\-8.
.RE

.RS
نکته: این مورد تنها در صورتی استفاده می‌شود که متاداده یک UTF\-8 معتبر نباشد.
.RE

ignore_duplicates (false)
.RS
نادیده گرفتن قطعات تکراری هنگام افزودن به کتابخانه. یک قطعه در صورتی تکراری محسوب می‌شود که هنرمند، آلبوم، شماره دیسک، شماره قطعه و نام قطعه یکسانی داشته باشد.
.RE

lib_add_filter [\fIFilter\fR]
.RS
اعمال فیلتر هنگام افزودن فایل‌ها به کتابخانه. بخش \fBFILTERS\fR را ببینید.
.RE

lib_sort (artist album discnumber tracknumber title filename) [\fISort Keys\fR]
.RS
کلیدهای مرتب‌سازی برای نمای مرتب‌شده کتابخانه (۲).
.RE

mouse (false)
.RS
فعال‌سازی پشتیبانی از ماوس.
.RE

.RS
نکته: پیمایش با چرخ ماوس ممکن است در صورتی که cmus با نسخه قدیمی ncurses کامپایل شده باشد با تاخیر مواجه شود.
.RE

mpris (true)
.RS
فعال‌سازی پشتیبانی از MPRIS. بخش \fBD\-Bus Interface (MPRIS)\fR را ببینید.
.RE

.RS
نکته: این فلگ در صورتی که cmus بدون پشتیبانی از MPRIS کامپایل شده باشد تاثیری ندارد.
.RE

output_plugin [roar, pulse, alsa, arts, oss, sndio, sun, coreaudio, aaudio]
.RS
نام افزونه خروجی صدا.
.RE

passwd [\fIpassword\fR]
.RS
تنظیم گذرواژه برای اتصالات TCP/IP. در صورت گوش دادن روی host[:port] الزامی است. در صورت گوش دادن روی سوکت یونیکس تاثیری ندارد. همراه با \-\-listen استفاده می‌شود.
.RE

pause_on_output_change (false)
.RS
مکث پخش هنگام تغییر خروجی صدا.
.RE

.RS
افزونه‌های خروجی پشتیبانی‌شده: pulse، aaudio.
.RE

pl_env_vars
.RS
فهرست جداشده با کاما از متغیرهای محیطی جهت جایگزینی هنگام ذخیره فایل‌های کتابخانه/لیست پخش. مسیرها باید مطلق باشند تا اعمال شوند. بخش \fIمتغیرهای محیطی کتابخانه\fR را ببینید.
.RE

.RS
نکته: این گزینه تا زمان راه‌اندازی مجدد cmus کاملاً اعمال نخواهد شد.
.RE

pl_sort () [\fISort Keys\fR]
.RS
کلیدهای مرتب‌سازی برای نمای لیست پخش (۳). مقدار خالی مرتب‌سازی را غیرفعال کرده و امکان جابه‌جایی دستی قطعات را فراهم می‌کند.
.RE

play_library (true)
.RS
پخش قطعات از کتابخانه به‌جای لیست پخش.
.RE

play_sorted (false)
.RS
پخش قطعات از کتابخانه به ترتیب نمای مرتب‌شده (۲) به‌جای ترتیب نمای درختی (۱). تنها زمانی استفاده می‌شود که play_library برابر با true باشد.
.RE

progress_bar (line) [disabled, line, shuttle, color, color_shuttle]
.RS
ترسیم یک نوار در خط وضعیت که پیشرفت جاری قطعه را نمایش می‌دهد.
.RE

repeat (false)
.RS
تکرار پخش پس از پایان تمام قطعات.
.RE

repeat_current (false)
.RS
تکرار مداوم قطعه جاری.
.RE

replaygain (disabled) [track, album, track\-preferred, album\-preferred, smart]
.RS
فعال‌سازی Replay Gain. تنظیم smart هنگام فعال بودن حالت بر زدن (shuffle)، یا فعال بودن صف، یا هنگام پخش از یک لیست پخش مانند track\-preferred عمل می‌کند. در غیر این صورت، مانند album\-preferred رفتار می‌نماید.
.RE

replaygain_limit (true)
.RS
استفاده از محدودکننده replay gain هنگام بریده شدن دامنه صدا (clipping).
.RE

replaygain_preamp (0.0)
.RS
پیش‌تقویت replay gain بر حسب دسی‌بل.
.RE

resume (false)
.RS
ادامه پخش در زمان راه‌اندازی برنامه.
.RE

rewind_offset (5) [\-1\-9999]
.RS
اگر موقعیت قطعه جاری کمتر از rewind_offset باشد، دستور player_prev به قطعه قبلی می‌پرد. در غیر این صورت، player_prev به ابتدای قطعه جاری بازمی‌گردد. اگر rewind_offset=\-1 باشد، player_prev همواره به قطعه قبلی می‌پرد.
.RE

scroll_offset (2) [0\-9999]
.RS
حداقل تعداد سطرهای صفحه نمایش که باید بالا و پایین مکان‌نما خالی نگه داشته شوند.
.RE

search_resets_position (true)
.RS
آغاز جستجوها از ابتدای نمای جاری به‌جای موقعیت مورد جاری.
.RE

show_all_tracks (true)
.RS
نمایش تمام قطعات هنرمند هنگامی که هنرمند در نمای درختی انتخاب شده باشد. این گزینه با گزینه‌های auto_expand_albums_* پیوند نزدیکی دارد. مقدار «show_all_tracks = false» متضمن «auto_expand_albums_* = true» است.
.RE

show_hidden (false)
.RS
نمایش فایل‌های پنهان در مرورگر فایل.
.RE

show_current_bitrate (false)
.RS
نمایش نرخ بیت (bitrate) جاری در خطوط وضعیت.
.RE

show_playback_position (true)
.RS
نمایش زمان سپری‌شده (یا باقی‌مانده) در خط وضعیت. می‌تواند غیرفعال شود تا برای نمونه ناظر فعالیت tmux را فعال نکند.
.RE

show_remaining_time (false)
.RS
نمایش زمان باقی‌مانده به‌جای زمان سپری‌شده.
.RE

shuffle (off) [off, tracks, albums]
.RS
.TP
\fBoff\fR
پخش تمام قطعات به ترتیب. گزینه‌های \fBlib_sort\fR و \fBpl_sort\fR را نیز ببینید.
.TP
\fBtracks\fR
پخش تمام قطعات در کتابخانه یا لیست پخش به ترتیب بر زده شده (تصادفی).
.TP
\fBalbums\fR
پخش کامل هر آلبوم کتابخانه پیش از رفتن تصادفی به اولین قطعه از آلبوم دیگر کتابخانه. در لیست‌های پخش این گزینه به رفتار \fBtracks\fR بازمی‌گردد.
.RE

.RS
فیلترها و \fBaaa_mode\fR می‌توانند برای محدود کردن موارد در دسترس برای پخش استفاده شوند. توجه داشته باشید که \fBshuffle\fR=\fIalbums\fR همراه با \fBaaa_mode\fR=\fIalbum\fR هیچ تاثیری نخواهد داشت.
.RE

skip_track_info (false)
.RS
عدم بارگذاری متاداده هنگام افزودن قطعات. هنگامی که از سیستم فایل شبکه‌ای استفاده می‌شود و حجم عظیمی از فایل‌ها وجود دارد مفید است. برچسب‌ها را می‌توان بعداً با استفاده از دستورات 'update\-cache' یا 'win\-update\-cache' بارگذاری کرد.
.RE

softvol (false)
.RS
استفاده از کنترل نرم‌افزاری بلندی صدا.
.RE

.RS
نکته: شما احتمالاً باید هنگام استفاده از \fBao\fR به‌عنوان \fBoutput_plugin\fR برای خروجی به فایل‌های wav این گزینه را روی false تنظیم کنید.
.RE

softvol_state (100 100)
.RS
برای ذخیره مقادیر کانال‌های چپ و راست برای کنترل نرم‌افزاری بلندی صدا استفاده می‌شود. دو عدد صحیح در محدوده ۰..۱۰۰ که با یک فاصله از هم جدا شده‌اند. این گزینه معمولاً مستقیماً تغییر داده نمی‌شود زیرا دستور \fBvol\fR در صورت درست بودن \fBsoftvol\fR همین کار را انجام می‌دهد.
.RE

start_view (tree) [tree, sorted, playlist, queue, browser, filters, settings]
.RS
مشخص کردن نمایی که هنگام شروع cmus نمایش داده می‌شود.
.RE

status_display_program () [command]
.RS
این دستور، در صورت تنظیم، برای هر تغییر وضعیت اجرا می‌شود. برای نمونه می‌توان از آن برای نمایش قطعه در حال پخش روی پس‌زمینه دسکتاپ یا پنل استفاده کرد. فایل \fI/usr/share/doc/cmus/examples/cmus\-status\-display\fR را ببینید.
.RE

stop_after_queue (false)
.RS
توقف پخش هنگام رسیدن به انتهای صف پخش.
.RE

time_show_leading_zero (true)
.RS
افزودن صفر پیشرو برای مدت‌زمان‌های کمتر از ۱۰ دقیقه.
.RE

tree_width_percent (33) [1\-100]
.RS
درصد عرض پنجره برای استفاده در پنل سمت چپ.
.RE

tree_width_max (0) [0\-9999]
.RS
محدود کردن اندازه محاسبه‌شده از tree_width_percent. مقدار ۰ این گزینه را غیرفعال می‌کند.
.RE

.RS
این گزینه بر درخت در نمای کتابخانه و فهرست لیست‌های پخش در نمای لیست پخش تاثیر می‌گذارد.
.RE

.RS
توجه داشته باشید که این مقدار بیشتر توسط عرض پنجره و/یا حداقل اندازه درخت محدود خواهد شد.
.RE

.RS
برای نمونه، جهت تنظیم اندازه ثابت ۶۰ ستون:
.RE

.RS
.RS
.nf
set tree_width_percent=100
set tree_width_max=60
.fi
.RE
.RE

.RS
یا برای داشتن ۳۳٪ عرض، اما حداکثر ۶۰ ستون:
.RE

.RS
.RS
.nf
set tree_width_percent=33
set tree_width_max=60
.fi
.RE
.RE

.RS
یا همواره ۳۳٪ عرض در صورت امکان (رفتار پیش‌فرض):
.RE

.RS
.RS
.nf
set tree_width_percent=33
set tree_width_max=0
.fi
.RE
.RE

wrap_search (true)
.RS
کنترل می‌کند که آیا جستجو پس از رسیدن به انتها دور می‌زند یا خیر.
.RE
.SS رنگ‌ها (Colors)
رنگ یک عدد صحیح در محدوده ۱\-..۲۵۵ است.

نام‌های رنگ زیر شناسایی می‌شوند:

رنگ پیش‌فرض پایانه، ۱\-
.RS
default
.RE

پیش‌زمینه و پس‌زمینه، ۰..۷
.RS
black, red, green, yellow, blue, magenta, cyan, gray
.RE

پیش‌زمینه، ۸..۱۵
.RS
darkgray, lightred, lightgreen, lightyellow, lightblue, lightmagenta, lightcyan, white
.RE
.SS ویژگی‌ها (Attributes)
ویژگی‌ها مجموعه‌ای از نام‌های "standout|bold" هستند:

مقدار \fIdefault\fR کاری انجام نمی‌دهد؛ اگر آن را همراه با سایر ویژگی‌ها قرار دهید، ویژگی‌های دیگر اعمال خواهند شد.

مقدار \fIstandout\fR متن را برجسته (standout) می‌کند.

مقدار \fIbold\fR متن را پررنگ (bold) می‌کند.

مقدار \fIreverse\fR رنگ‌های متن را معکوس می‌کند.

مقدار \fIunderline\fR زیر متن خط می‌کشد.

مقدار \fIitalic\fR متن را مورب می‌کند (در تمام نسخه‌های ncurses پشتیبانی نمی‌شود).

مقدار \fIblink\fR متن را چشمک‌زن می‌کند.
.SS رشته‌های قالب (Format Strings)
رشته‌های قالب نحوه نمایش قطعات را در نماهای کتابخانه، لیست پخش و صف پخش کنترل می‌کنند.

نکته: گزینه‌های \fBaltformat_*\fR زمانی استفاده می‌شوند که هیچ برچسبی در دسترس نباشد.

کلیدهای ویژه:

.RS
%a  %{artist}  
.br
%A  %{albumartist} 
.br
%l  %{album}  
.br
%D  %{discnumber} 
.br
%T  %{totaldiscs} 
.br
%n  %{tracknumber} 
.br
%X  %{play_count} 
.br
%t  %{title}  
.br
%g  %{genre}  
.br
%c  %{comment}  
.br
%y  %{date}  
.br
%d  %{duration}  
.br
%f  %{path}  
.br
%F  %{filename}  
.br
    %{albumduration}    
.br
    %{originaldate} 
.br
    %{maxdate}  
.br
    %{bpm}  
.br
    %{bitrate}  
.br
    %{codec}  
.br
    %{codec_profile} 
.br
    %{rg_track_gain} 
.br
    %{rg_track_peak} 
.br
    %{rg_album_gain} 
.br
    %{rg_album_peak} 
.br
    %{arranger}  
.br
    %{composer}  
.br
    %{conductor} 
.br
    %{lyricist}  
.br
    %{performer} 
.br
    %{remixer}  
.br
    %{label}  
.br
    %{publisher} 
.br
    %{work}  
.br
    %{opus}  
.br
    %{partnumber} 
.br
    %{part}  
.br
    %{subtitle}  
.br
    %{media}  
.br
%!
.RS
متن پیشین اهمیت کمتری دارد و در صورت نیاز ممکن است کوتاه شود (حداکثر یک بار استفاده شود)
.RE
%=
.RS
شروع تراز راست (حداکثر یک بار استفاده شود)
.RE
%%
.RS
علامت واقعی \fB%\fR
.RE
%?
.RS
علامت واقعی \fB?\fR
.RE
.RE

می‌توانید از قالب‌بندی سبک printf (عرض، تراز، فاصله‌گذاری) استفاده کنید. به‌عنوان یک توسعه، عرض می‌تواند دارای پسوند %\- باشد تا درصدی از عرض پایانه را مشخص کند.
.br
برای مشاهده مقدار جاری یک گزینه عبارت \fB:set option=<TAB>\fR را تایپ کنید.

نکته: در مورد %{bitrate}، باید خودتان واحد را اضافه کنید، همان‌طور که در مثال زیر ذکر شده است.

می‌توانید از عملگر شرطی \fB%{?CONDITION?A[?B]}\fR استفاده کنید. بخش CONDITION ساختاری مشابه با \fIفیلترها\fR دارد، به‌جز عبارات کوتاه و ساده پشتیبانی‌نشده و مقایسه کلیدهای پشتیبانی‌شده (مانند artist=albumartist). کلیدهای آن عبارتند از:
.RS
کلیدهای ویژه رشته‌های قالب
.br
گزینه‌های پیکربندی
.br
کلیدواژه \fBstream\fR [بولی] (اگر قطعه یک استریم باشد true برمی‌گرداند)
.br
کلیدواژه \fBva\fR [بولی] (اگر آلبوم قطعه گردآوری باشد true برمی‌گرداند)
.RE
بخش Else می‌تواند حذف شود. متغیرهای A و B می‌توانند شامل رشته‌های متنی درون \fB"\fR یا \fB'\fR باشند. متغیرهای A و B می‌توانند خالی باشند.

مثال‌ها:

.RS
.nf
:set format_trackwin= %02n. %t %{?y?(%y)}%= %d
:set format_current= %n. %\-30t %40F (%y)%= %d
:set format_current= %a \- %l%! \- %02n. %t%= %{bitrate}Kbps %g %y
:set format_playlist= %f%= %6{rg_track_gain} dB  %8{rg_track_peak}
:set format_playlist= %\-25%a %\-15%l %3n. %t%= %y %d
.fi
.RE
.SS کلیدهای مرتب‌سازی (Sort Keys)
مقدار گزینه مرتب‌سازی (lib_sort, pl_sort) فهرستی از کلیدهای مرتب‌سازی زیر است که با فاصله جدا شده‌اند:

.RS
artist, album, title, tracknumber, play_count, discnumber, date, originaldate, genre, comment, albumartist, filename, filemtime, bpm, bitrate, codec, media, codec_profile, rg_track_gain, rg_track_peak, rg_album_gain, rg_album_peak
.RE

نکته: افزودن یک '\-' پیش از کلید، ترتیب مرتب‌سازی را معکوس می‌کند.
.SH "گزینه‌های افزونه (PLUGIN OPTIONS)"
dsp.alsa.device
.RS
دستگاه PCM برای افزونه ALSA، معمولاً "default".
.RE

mixer.alsa.channel
.RS
کانال میکسر برای افزونه ALSA، معمولاً "pcm"، "master" یا "headphone". برای مشاهده تمام مقادیر ممکن دستور "alsamixer" یا "amixer" را اجرا کنید.
.RE

mixer.alsa.device
.RS
دستگاه میکسر برای افزونه ALSA، معمولاً "default".
.RE

mixer.pulse.restore_volume
.RS
بازیابی بلندی صدا در زمان راه‌اندازی با استفاده از PulseAudio. در غیر این صورت، cmus صدا را روی ۱۰۰٪ تنظیم می‌کند، که با ویژگی «flat volumes» در PulseAudio سازگار نیست. پیش‌فرض "1" است؛ برای خاموش کردن روی "0" تنظیم کنید.
.RE

dsp.ao.buffer_size
.RS
اندازه بافر صوتی؛ پیش‌فرض ۱۶ کیلوبایت است، اما در صورت مواجهه با کمبود بافر (buffer under\-runs) می‌توانید مقادیر بزرگتری را امتحان کنید.
.RE

dsp.ao.device_interface
.RS
رابط دستگاه برای افزونه libao جهت درخواست یک دستگاه پخش/سینک/خروجی مشخص. این نام در قالبی خواهد بود که توسط backend درایور مشخص تعیین می‌شود.
.RE

dsp.ao.driver
.RS
درایور خروجی برای افزونه libao. مقادیر نمونه: "alsa09"، "esd"، "irix"، "oss"، "sun"، "aixs"، "wav".
.RE

.RS
نکته: از درایورهای خروجی فایل تنها "wav" پشتیبانی می‌شود.
.RE

dsp.ao.wav_counter
.RS
شمارنده مورد استفاده برای نام‌گذاری فایل. تنها زمانی استفاده می‌شود که \fBdsp.ao.driver\fR برابر با "wav" باشد. برای نمونه اگر این مقدار ۱ باشد و \fBdsp.ao.wav_dir\fR برابر با "/home/user" باشد، داده‌های PCM در "/home/user/01.wav" خروجی داده می‌شوند. این شمارنده با هر بار توقف پخش افزایش می‌یابد.
.RE

.RS
نکته: احتمالاً می‌خواهید \fBcontinue\fR را روی \fBfalse\fR تنظیم کنید (کلید \fBC\fR را فشار دهید)، در غیر این صورت پخش بین قطعات متوقف نشده و تمام داده‌های PCM در یک فایل wav خروجی داده می‌شوند (اگر بخواهید فایل‌ها را به هم پیوند دهید مفید است). همچنین لغو تنظیم حالت‌های shuffle و repeat ممکن است ایده خوبی باشد.
.RE

dsp.ao.wav_dir
.RS
پوشه خروجی برای افزونه libao؛ پیش‌فرض پوشه خانگی است. تنها زمانی استفاده می‌شود که \fBdsp.ao.driver\fR برابر با "wav" باشد.
.RE

dsp.coreaudio.device
.RS
دستگاه برای خروجی Core Audio. برای حالت پیش‌فرض خالی بگذارید.
.RE

dsp.coreaudio.enable_hog_mode
.RS
تنظیم حالت انحصاری (hog mode) برای دستگاه. مقدار پیش‌فرض false است.
.RE

dsp.coreaudio.sync_sample_rate
.RS
همگام‌سازی نرخ نمونه‌برداری دستگاه با پخش‌کننده، به‌طوری که هیچ درونیابی روی جریان اعمال نشود.
.RE

dsp.jack.server_name
.RS
اتصال به jackd با این نام. برای حالت پیش‌فرض خالی بگذارید.
.RE

dsp.jack.resampling_quality
.RS
کیفیت نمونه‌برداری مجدد. ۰ کیفیت پایین اما سریع، ۱ کیفیت متوسط، ۲ (پیش‌فرض) کیفیت بالا اما با مصرف بیشتر پردازنده است. این گزینه تنها در صورتی در دسترس است که cmus با پشتیبانی از libsamplerate کامپایل شده باشد.
.RE

dsp.aaudio.performance_mode (power_saving) [power_saving, none]
.RS
تنظیم حالت عملکرد درخواستی. اگر "power_saving" باشد، طول عمر باتری بر تاخیر کم اولویت دارد. اگر "none" باشد، طول عمر باتری با تاخیر کم متعادل می‌شود.
.RE

.RS
این گزینه نیاز به راه‌اندازی مجدد cmus دارد.
.RE

dsp.aaudio.allowed_capture (all) [all, system, none]
.RS
مشخص می‌کند که آیا صدا می‌تواند توسط برنامه‌های دیگر یا سیستم ضبط شود یا خیر.
.RE

.RS
این گزینه تنها در Android 10+ (API 29) پشتیبانی می‌شود و نیاز به راه‌اندازی مجدد cmus دارد.
.RE

dsp.aaudio.sharing_mode (shared) [shared, exclusive]
.RS
درخواست یک حالت برای اشتراک دستگاه. این کار بر مبنای بهترین تلاش انجام می‌شود و حالت درخواستی ممکن است در دسترس نباشد.
.RE

.RS
این گزینه نیاز به راه‌اندازی مجدد cmus دارد.
.RE

dsp.aaudio.disable_spatialization (false)
.RS
در صورت درست بودن، فضاسازی صوتی درون‌ساخت اندروید را حتی اگر برای خروجی صدای جاری فعال باشد غیرفعال می‌کند. توجه داشته باشید که فضاسازی تنها برای صدایی با حداقل ۴ کانال اعمال می‌شود. برای جزئیات بیشتر به <https://developer.android.com/media/grow/spatial\-audio> مراجعه کنید.
.RE

.RS
این گزینه تنها در Android 12L+ (API 32) پشتیبانی می‌شود و نیاز به راه‌اندازی مجدد cmus دارد.
.RE

input.cdio.cddb_url
.RS
نشانی وب CDDB (پیش‌فرض: freedb.freedb.org:8880). اگر با "http://" پیشوندگذاری شود از HTTP استفاده می‌کند (مانند: <http://freedb.musicbrainz.org:80/~cddb/cddb.cgi>). برای غیرفعال کردن کامل جستجوی CDDB آن را روی یک رشته خالی تنظیم کنید.
.RE

input.*.priority
.RS
تنظیم اولویت افزونه ورودی. اگر چندین افزونه بتوانند فایلی را پخش کنند، افزونه با اولویت بالاتر انتخاب می‌شود. اگر اولویت ۰ باشد، افزونه غیرفعال است.
.RE

dsp.oss.device
.RS
دستگاه PCM برای افزونه OSS، معمولاً /dev/dsp.
.RE

mixer.oss.channel
.RS
کانال میکسر برای افزونه OSS، مقدار "pcm" یا "master".
.RE

mixer.oss.device
.RS
دستگاه میکسر برای افزونه OSS، معمولاً /dev/mixer.
.RE

dsp.roar.server
.RS
نشانی کارساز RoarAudio. پیش‌فرض به مقادیر پیش‌فرض داخلی است. می‌تواند نشانی UNIX، TCP/IP یا DECnet باشد.
.RE

dsp.roar.role [music, background_music, ...]
.RS
نقش برای استریم. ممکن است توسط سرور برای اعمال پیش‌فرض‌های اضافی استفاده شود.
.RE

dsp.sun.device
.RS
دستگاه PCM برای افزونه Sun، معمولاً /dev/audio.
.RE

mixer.sun.channel
.RS
کانال میکسر برای افزونه Sun، معمولاً "master".
.RE

mixer.sun.device
.RS
دستگاه میکسر برای افزونه Sun، معمولاً /dev/mixer.
.RE
.SH "پخش دیسک‌های صوتی (PLAYING AUDIO DISCS)"
اگر افزونه ورودی \fBcdio\fR فعال باشد، می‌توان دیسک‌های صوتی CD و ایمیج‌های CD را با تنظیم گزینه \fBdevice\fR به یک فایل دستگاه (مانند /dev/cdrom) یا یک فایل ایمیج (مانند ~/cd.cue) پخش کرد. سپس، با استفاده از طرحواره نشانی اینترنتی CDDA قطعه جدیدی اضافه کنید:

.RS
:add cdda://2
.RE

برای افزودن کل دیسک، از cdda:// (بدون شماره قطعه) استفاده کنید. این حالت تنها برای دیسک‌های صوتی کار می‌کند، نه فایل‌های ایمیج. افزودن محدوده‌ای از قطعات نیز ممکن است (cdda://1\-3).

برای افزودن فایل‌های ایمیج بدون تغییر گزینه device، مسیر فایل ایمیج را در نشانی اینترنتی بگنجانید:

.RS
:add cdda:///path/to/cd.cue/2\-5
.RE

متاداده‌ها از CD\-Text خوانده می‌شوند، و اگر موجود نباشند، از یک سرور CDDB جستجو خواهند شد (گزینه \fBinput.cdio.cddb_url\fR را ببینید).
.SH "فیلترها (FILTERS)"
فیلترها عمدتاً برای فیلتر کردن محتویات نماهای کتابخانه (۱ و ۲) به کار می‌روند. فیلترها محتوای واقعی کتابخانه را تغییر نمی‌دهند؛ یعنی دستور \fB:save\fR همچنان تمام قطعات را چه قابل مشاهده باشند یا خیر در فایل لیست پخش ذخیره خواهد کرد.
.SS انواع
سه نوع عبارت فیلتر وجود دارد که هر یک قابلیت بیان بیشتری ارائه می‌دهند:
.RS
.TP
\fBsimple\fR
\fIبرای نمونه:\fR beatles
.TP
\fBshort\fR
\fIبرای نمونه:\fR ~a beatles (!~y1960\-1965 | ~d>600)
.TP
\fBlong\fR
\fIبرای نمونه:\fR artist="*beatles*"&album="R*"
.RE

عبارات ساده تنها با استفاده از \fBlive\-filter\fR در دسترس هستند. برای سایر دستورات فیلتر، نوع عبارت به‌طور خودکار تشخیص داده می‌شود، بنابراین هر دو عبارت کوتاه و طولانی می‌توانند استفاده شوند.

عبارات طولانی فهرستی از فیلترهای درون‌ساخت یا فیلترهای تعریف‌شده توسط کاربر هستند که با \fB&\fR (و) یا \fB|\fR (یا) از هم جدا شده‌اند. از پرانتزها می‌توان برای گروه‌بندی زیرعبارت‌ها استفاده کرد و علامت \fB!\fR نتیجه عبارت پس از خود را نقیض می‌کند. همین امر برای عبارات کوتاه نیز صادق است، اما آن‌ها تنها می‌توانند شامل فیلترهای درون‌ساخت باشند. همچنین گروه‌بندی (و) به‌صورت ضمنی انجام می‌شود.
.SS رشته‌ها
.TP
long (طولانی)
\fBfilename\fR, \fBartist\fR, \fBalbumartist\fR, \fBalbum\fR, \fBtitle\fR, \fBgenre\fR, \fBcomment\fR, \fBcodec\fR, \fBcodec_profile\fR, \fBmedia\fR
.br
عملگرهای مقایسه: \fB=\fR و \fB!=\fR (نامساوی)
.TP
short (کوتاه)
\fB~f\fR, \fB~a\fR, \fB~A\fR, \fB~l\fR, \fB~t\fR, \fB~g\fR, \fB~c\fR
.br
عملگرهای مقایسه: ندارد
.SS اعداد صحیح
.TP
long (طولانی)
\fBdiscnumber\fR, \fBtracknumber\fR, \fBdate\fR (سال), \fBoriginaldate\fR (سال), \fBduration\fR (ثانیه), \fBbitrate\fR
.br
عملگرهای مقایسه: \fB<\fR, \fB<=\fR, \fB=\fR, \fB>=\fR, \fB>\fR, \fB!=\fR
.TP
short (کوتاه)
\fB~D\fR, \fB~n\fR, \fB~y\fR, \fB~d\fR
.br
عملگرهای مقایسه: \fB<\fR, \fB>\fR
.br
محدوده‌ها: \fBa\-b\fR (>=a&<=b), \fB\-b\fR (<=b), \fBa\-\fR (>=a)
.SS مقادیر بولی
\fBtag\fR (اگر قطعه دارای برچسب باشد true است), \fBstream\fR (اگر قطعه یک استریم باشد true است)
.br
برای عبارات کوتاه: \fB~T\fR و \fB~s\fR
.SS تعریف فیلترها
فیلترها را می‌توان با دستور \fBfset\fR تعریف کرد. فیلترهای تعریف‌شده توسط کاربر در نمای فیلترها (۶) ظاهر می‌شوند.

ایجاد یک فیلتر جدید با نام \fBogg\fR و مقدار \fBfilename="*.ogg"\fR:
.RS
:fset ogg=filename="*.ogg"
.RE

فیلتر کردن فایل‌های ogg و mp3 از دهه ۹۰. به استفاده از فیلتر تعریف‌شده توسط کاربر \fBogg\fR توجه کنید:
.RS
:fset 90s\-ogg\-mp3=date>=1990&date<2000&(ogg|filename="*.mp3")
.RE
.SS فعال‌سازی فیلترها
دستور \fBfactivate\fR محتویات قابل مشاهده کتابخانه (نماهای ۱-۲) را تغییر می‌دهد.

فعال‌سازی فیلترهای تعریف‌شده توسط کاربر \fBogg\fR و \fBmissing\-tags\fR:
.RS
:factivate ogg missing\-tags
.RE

مشابه بالا اما نقیض کردن مقدار فیلتر \fBogg\fR:
.RS
:factivate !ogg missing\-tags
.RE

به‌عنوان روش جایگزین، می‌توانید فیلترها را با فشردن \fBspace\fR در نمای ۶ مشخص کرده و سپس با فشردن \fBenter\fR آن‌ها را فعال نمایید.
.SS فیلترهای یک‌بارمصرف
دستورات \fBlive\-filter\fR و \fBfilter\fR زمانی مفید هستند که بخواهید بدون ذخیره کردن از یک فیلتر استفاده کنید. این دستور محتویات قابل مشاهده کتابخانه (نماهای ۱-۲) را تغییر می‌دهد. دستور \fBfilter\fR تمام فیلترهای موجود در نمای فیلترها را غیرفعال می‌کند، در حالی که \fBlive\-filter\fR علاوه بر تمام فیلترهای فعال جاری اعمال می‌شود. این فیلتر حتی پس از خروج از حالت فرمان نیز باقی می‌ماند.

فیلتر کردن تمام موسیقی‌های راک (هر موردی با عبارت \fBrock\fR در برچسب سبک) از دهه ۸۰ به بعد:
.RS
:filter date>=1980&genre="*rock*"
.br
:filter ~y1980\-~grock
.RE

فیلتر کردن تمام هنرمندان/آلبوم‌ها/عناوینی که شامل "sleepwalking" هستند:
.RS
:live\-filter sleepwalking
.RE
.SS انتخاب قطعات مطابق با یک فیلتر
علامت‌گذاری (انتخاب) تمام قطعات با مدت‌زمان کمتر از ۲ دقیقه:
.RS
:mark duration<120
.RE

علامت‌گذاری (انتخاب) تمام قطعاتی که حداقل یک‌بار پخش شده‌اند:
.RS
:mark play_count>=1
.RE

این دستورات در نماهای ۲ تا ۴ کار می‌کنند.
.SH "فایل‌ها (FILES)"
برنامه cmus پیکربندی خود را از ۳ مکان مختلف به ترتیب زیر می‌خواند:

\fI$XDG_CONFIG_HOME/cmus/autosave\fR
.RS
این فایل به‌طور خودکار هنگام خروج توسط cmus ایجاد و بازنویسی می‌شود، بنابراین نباید با دست ویرایش گردد.
.RE

\fI/usr/share/cmus/rc\fR
.RS
این فایل حاوی پیکربندی پیش‌فرض است.
.RE

.RS
اگر فایل autosave وجود نداشته باشد، این فایل خوانده می‌شود.
.RE

\fI$XDG_CONFIG_HOME/cmus/rc\fR
.RS
این فایل، فایل پیکربندی ایستا است.
.RE

.RS
این فایل بلافاصله پس از فایل autosave خوانده می‌شود و هرگز توسط cmus تغییر داده نمی‌شود. می‌توانید تنظیمات ذخیره‌شده خودکار را در این فایل لغو کنید. این فایل تنها به گزینه‌ها محدود نمی‌شود؛ می‌تواند شامل دستورات دیگر نیز باشد.
.RE
.SS طرح‌های رنگ
طرح‌های رنگ (*.theme) در \fI/usr/share/cmus\fR یا \fI$XDG_CONFIG_HOME/cmus\fR قرار دارند. می‌توانید با استفاده از دستور \fB:colorscheme\fR همراه با نام پایه فایل تم میان آن‌ها جابه‌جا شوید.

نکته: رنگ‌ها هنگام تغییر فایل تم به‌طور خودکار به‌روزرسانی نمی‌شوند، زیرا در فایل autosave ذخیره شده‌اند.
.SS مثال‌ها
اسکریپت‌های نمونه نمایش وضعیت (گزینه \fBstatus_display_program\fR را ببینید) را می‌توان در \fI/usr/share/doc/cmus/examples\fR یافت.
.SH "محیط (ENVIRONMENT)"
CMUS_CHARSET
.RS
لغو مجموعه نویسه‌های مورد استفاده توسط cmus (پیش‌فرض: `locale charmap`).
.RE

CMUS_HOME
.RS
لغو پوشه پیکربندی (پیش‌فرض: $XDG_CONFIG_HOME/cmus).
.RE

CMUS_SOCKET
.RS
لغو مسیر سوکت (پیش‌فرض: $XDG_RUNTIME_DIR/cmus\-socket).
.RE

HOME
.RS
مسیر کامل پوشه خانگی کاربر.
.RE

http_proxy
.RS
شناسه URI پیشکار (پروکسی) مورد استفاده برای درخواست‌های HTTP.
.RE

USER
.RS
نام کاربری که cmus را اجرا می‌کند.
.RE

USERNAME
.RS
حالت جایگزین برای \fBUSER\fR.
.RE
.SS متغیرهای محیطی کتابخانه
برنامه cmus از استفاده از متغیرهای محیطی برای امکان جابه‌جایی یا همگام‌سازی کتابخانه، حافظه نهان و لیست‌های پخش پشتیبانی می‌کند. متغیرهای محیطی مورد استفاده با گزینه پیکربندی \fIpl_env_vars\fR مشخص می‌شوند که در هنگام خروج از cmus اعمال می‌گردد.

یک نقطه شروع مناسب \fI:set pl_env_vars=HOME\fR است. این کار به پوشه \fI.cmus\fR امکان می‌دهد میان دستگاه‌ها یا کاربران به اشتراک گذاشته شود. متغیرهای محیطی بیشتر را می‌توان (با کاما جدا شده) به \fIpl_env_vars\fR پیوست کرد تا مسیرهای خاصی بازهدایت شوند. متغیرهای محیطی باید حاوی مسیرهای مطلق باشند تا استفاده شوند. آخرین پیشوند پوشه منطبق استفاده خواهد شد.

اگر فایلی وجود نداشته باشد، مانند فایل‌های ناموجود عادی با آن برخورد می‌شود. اگر فایل در کش باشد، حفظ خواهد شد و در هنگام پخش خطا نمایش داده می‌شود. اگر فایل در کش نباشد، از لیست‌های پخش و کتابخانه حذف خواهد شد. یک استثنای ویژه وجود دارد: اگر فایلی به دلیل نامعتبر/خالی/تنظیم نبودن متغیر محیطی مفقود باشد، اما همچنان در کش موجود باشد، همانند معمول در کتابخانه حفظ شده و در کش نیز دست‌نخورده باقی می‌ماند.

هنگام استفاده از \fI:save\fR/\fI:load\fR و در کتابخانه/کش/لیست‌های پخش روی دیسک، مسیرها با متغیر محیطی که با نویسه \fI\\x1F\fR (جداکننده واحد اسکی نامرئی) جدا شده است ذخیره می‌شوند.

همچنین می‌توان از این ویژگی برای انتقال سریع یک کتابخانه به مکانی دیگر همراه با حفظ تمام متاداده‌ها، لیست‌های پخش و تعداد دفعات پخش استفاده کرد. برای این کار، یک متغیر محیطی برای هر مسیر پایه‌ای که می‌خواهید تغییر دهید تنظیم کنید، \fIpl_env_vars\fR را روی فهرست متغیرهای محیطی تنظیم کنید، cmus را راه‌اندازی مجدد کنید، متغیرهای محیطی را تغییر دهید، cmus را راه‌اندازی مجدد کنید، \fIpl_env_vars\fR را لغو کنید و سپس مجدداً cmus را راه‌اندازی مجدد نمایید.

اگر کتابخانه‌ای که از \fIpl_env_vars\fR استفاده می‌کند با نسخه‌ای از cmus باز شود که از آن پشتیبانی نمی‌کند، قطعاتی که با متغیرهای محیطی ارجاع داده شده‌اند فراموش خواهند شد. برای بازگرداندن فایل‌های روی دیسک به حالت سازگار با نسخه‌های قدیمی‌تر cmus، کافی است \fIpl_env_vars\fR را لغو کرده و cmus را راه‌اندازی مجدد کنید. این کار مسیرهای تمام متغیرهای محیطی تعریف‌شده را به مسیر واقعی آن‌ها بازمی‌گرداند.

تغییر \fIpl_env_vars\fR از خارج از cmus ایمن است، زیرا این متغیر هنگام خروج cmus اعمال می‌شود.
.SH "رابط D\-Bus (MPRIS)"
برنامه cmus یک رابط D\-Bus مطابق با مشخصات واسط راه‌دور پخش‌کننده چندرسانه‌ای (MPRIS) نسخه ۲ ارائه می‌دهد:
.RS
https://www.freedesktop.org/wiki/Specifications/mpris\-spec
.RE

این رابط مسیر شیء \fI/org/mpris/MediaPlayer2\fR را همراه با رابط‌های \fIorg.mpris.MediaPlayer2\fR و \fIorg.mpris.MediaPlayer2.Player\fR در معرض دسترسی قرار می‌دهد. نام منحصر‌به‌فرد گذرگاه \fIorg.mpris.MediaPlayer2.cmus\fR است.

فیلدهای متاداده از قرارداد نام‌گذاری مشخصات پیروی می‌کنند:
.RS
https://www.freedesktop.org/wiki/Specifications/mpris\-spec/metadata
.RE
علاوه بر این، فیلد \fIcmus:stream_title\fR در صورت لزوم ارائه می‌شود.
.SH "اشکالات (BUGS)"
فایل اشکال‌زدایی تنها در صورتی وجود دارد که cmus را با حداکثر سطح اشکال‌زدایی پیکربندی کرده باشید (\fB./configure DEBUG=2\fR).

پس از بروز یک خرابی ناگهانی (crash)، خطوط پایانی فایل \fI~/cmus\-debug.txt\fR ممکن است حاوی اطلاعات مفیدی باشند.

درخواست‌های قابلیت جدید و گزارش‌های اشکال باید به سامانه پیگیری اشکالات در گیت‌هاب ارسال شوند:
.RS
https://github.com/cmus/cmus/issues
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcmus\-tutorial\fR(7), \fBcmus\-remote\fR(1)
.SH "نویسندگان (AUTHORS)"
برنامه cmus عمدتاً توسط Timo Hirvonen <tihirvon@gmail.com> نوشته شده است. سایر مشارکت‌کنندگان در فایل \fIAUTHORS\fR فهرست شده‌اند.

این صفحه راهنما توسط Frank Terbeck <ft@bewatermyfriend.org>، Timo Hirvonen <tihirvon@gmail.com>، Clay Barnes <clay.barnes@gmail.com> و Patrick Gaskin <patrick@pgaskin.net> نگاشته شده است.