نام (NAME)

cmus - پخش‌کننده موسیقی متنی و سبک (C* Music Player)

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

cmus [گزینه‌ها]

توضیحات (DESCRIPTION)

دستور cmus یک پخش‌کننده موسیقی متنی و سبک مبتنی بر ncurses است. این برنامه با استفاده از افزونه‌های خروجی بارگذاری‌پذیر پویا از روش‌های مختلف خروجی صدا پشتیبانی می‌کند. برنامه cmus دارای کلیدهای میانبر قابل پیکربندی است و می‌تواند از بیرون با استفاده از cmus-remote(1) کنترل شود.

گزینه‌ها (OPTIONS)

--listen ADDR

--plugins

--show-cursor

--help

--version

نماها (VIEWS)

در cmus هفت نما وجود دارد. برای جابه‌جایی میان نماهای فعال، کلیدهای 1 تا 7 را فشار دهید.

نمای کتابخانه (1)

نمای مرتب‌شده کتابخانه (2)

نمای لیست پخش (3)

نمای صف پخش (4)

مرورگر فایل (5)

نمای فیلترها (6)

نمای تنظیمات (7)

خط فرمان (COMMAND LINE)

تمام قابلیت‌ها در cmus به‌صورت دستوراتی پیاده‌سازی شده‌اند که می‌توان آن‌ها را در خط فرمان تایپ کرد یا به یک کلید نسبت داد. برای ورود به حالت فرمان، نویسه : را تایپ کنید. برای اجرای یک دستور کلید ENTER و برای لغو آن ESC یا CTRL-C را فشار دهید. از کلیدهای جهت‌نمای بالا/پایین برای مرور تاریخچه دستورات استفاده کنید. از کلید TAB برای تکمیل خودکار دستورات و پارامترها بهره بگیرید. اگر نام دستور ابهامی نداشته باشد (هیچ دستور دیگری با همان حروف آغاز نشود)، نیازی به تایپ کامل نام دستور ندارید.

مثال‌ها:

# افزودن فایل‌ها، مخفف ':add ~/music'
:a ~/music
# تغییر افزونه خروجی
:set output_plugin=oss
# آغاز پخش
# همچنین می‌توانید کلید 'x' را فشار دهید که کلید
# میانبر پیش‌فرض این دستور است
:player-play
# پاک‌سازی نمای جاری (کتابخانه، لیست پخش یا صف پخش)
:clear

جستجو (SEARCHING)

حالت جستجو مانند حالت فرمان کار می‌کند. برای ورود به حالت جستجو، کلید / را فشار داده و عبارت جستجو را تایپ کنید، سپس ENTER را بزنید. کلید n را برای رفتن به نتیجه بعدی یا N را برای رفتن به نتیجه قبلی فشار دهید. برای جستجو به سمت عقب، ? را تایپ کنید.

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

قابلیت جستجو در نماهای ۵ تا ۷ نیز کار می‌کند.

ویرایش لیست پخش (PLAYLIST EDITING)

خط وضعیت (STATUS LINE)

سمت راست خط وضعیت (سطر دوم از پایین، متن سیاه روی پس‌زمینه خاکستری) شامل بخش‌های زیر است:

aaa_mode & play_sorted & play_library | volume | continue follow repeat shuffle

نکته: گزینه‌های aaa_mode و play_sorted تنها در صورتی نمایش داده می‌شوند که play_library برابر با true باشد، زیرا این گزینه‌ها هنگام پخش لیست‌های پخش (نمای ۳) بی‌معنی هستند.

فشردن کلیدهای m، o، M، C، r و s به درک بهتر معنای این بخش‌ها کمک می‌کند.

برای اطلاعات بیشتر درباره این گزینه‌ها، بخش گزینه‌های پیکربندی (CONFIGURATION OPTIONS) را ببینید.

کلیدهای میانبر (KEYBINDINGS)

فهرست کلیدهای میانبر پیش‌فرض در ادامه آمده است. برای تغییر آن‌ها، دستورات unbind و bind را در بخش دستورات (COMMANDS) ببینید.

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%

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

q                       quit -i
^C                      echo Type :quit<enter> to exit cmus.
I                       echo {}
!                       push shell<space>

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

^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

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

/                       search-start
?                       search-b-start
n                       search-next
N                       search-prev
F                       push filter<space>
L                       push live-filter<space>

space                   win-activate
backspace               browser-up
i                       toggle show_hidden
u                       win-update

مرتب‌سازی نمای کتابخانه (LIBRARY VIEW SORTING)

نمای کتابخانه (نمای درختی؛ نه نمای مرتب‌شده کتابخانه که با lib_sort پیکربندی می‌شود - بخش CONFIGURATION OPTIONS را ببینید)، به‌طور خودکار با استفاده از برچسب‌های متاداده فایل‌های صوتی مرتب می‌شود.

نکته: آلبوم‌هایی که شامل چندین هنرمند هستند (مانند گلچین‌ها یا آلبوم‌های گردآوری‌شده) به‌صورت ویژه مدیریت می‌شوند. اگر برچسب هنرمند آلبوم (album artist) یا فریم ID3v2 با نام TPE2 تنظیم شده باشد، به‌جای نام هنرمند واقعی از آن استفاده می‌شود. در غیر این صورت، cmus بررسی می‌کند که آیا آلبوم گردآوری‌شده است یا خیر (اگر albumartist یا artist برابر با Various Artists، Various، VA یا V/A باشد؛ یا اگر compilation یا partofacompilation مقداری معادل درست (truthy) داشته باشد؛ یا فریم ID3v2 با نام TCMP تنظیم شده باشد). در این حالت، هنرمند با عنوان <Various Artists> نام‌گذاری می‌شود.

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

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

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

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

در نهایت، هر آلبوم بر اساس شماره دیسک قطعه (discnumber)، شماره قطعه (tracknumber) و سپس نام فایل (نه نام قطعه) مرتب می‌شود.

دستورات (COMMANDS)

این بخش دستورات cmus را شرح می‌دهد که می‌توان آن‌ها را به کلیدها و رویدادهای ماوس مقید کرد، در فایل‌های پیکربندی قرار داد، در حالت فرمان اجرا نمود یا به cmus-remote ارسال کرد.

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

add [-l] [-p] [-q] [-Q] <file|dir|url|playlist>

bind [-f] <context> <key> <command>

browser-up (backspace)

cd [directory]

clear [-l] [-p] [-q]

colorscheme <name>

echo <arg>...

factivate <user-defined-filter>...

filter <filter-expression>

fset <name>=<filter-expression>

help

invert

live-filter <simple-filter-expression|short-filter-expression>

load [-l] <playlist>

lqueue [NUM]

mark <filter-expression>

mute

pl-create <name>

pl-delete [-a] <name>

pl-export <filename>

pl-import [filename]

pl-rename <name>

player-next (b)

player-next-album (B)

player-pause (c)

player-pause-playback

player-play [filename] (x)

player-prev (z)

player-prev-album (Z)

player-stop (v)

prev-view

left-view [-n]

right-view [-n]

push [text]

pwd

quit [-i] (q, :wq)

raise-vte

rand

refresh (^L)

reshuffle

run <command>

save [-e] [-l] [-L] [-p] [-q] [file] (:w)

search-b-start

search-next (n)

search-prev (N)

search-start

seek [+-](<num>[mh] | [HH:]MM:SS)

set <option>=<value>

set <option>

shell <command>

showbind <context> <key>

source <filename>

toggle <option>

tqueue [NUM]

unbind [-f] <context> <key>

unmark

update-cache [-f]

version

view <name or 1-7>

vol [+-]NUM[%] [[+-]NUM[%]]

w

win-activate (enter)

win-add-l [-n] (a)

win-add-p [-n] (y)

win-add-Q [-n] (E)

win-add-q [-n] (e)

win-bottom (G, end)

win-down [NUM] (j, down)

win-half-page-down (^D)

win-half-page-up (^U)

win-mv-after (p)

win-mv-before (P)

win-next (tab)

win-page-bottom

win-page-down (^F, page_down)

win-page-middle

win-page-top

win-page-up (^B, page_up)

win-remove (D, delete)

win-scroll-down (^E)

win-scroll-up (^Y)

win-sel-cur (i)

win-toggle (space)

win-top (g, home)

win-up [NUM] (k, up)

win-update (u)

win-update-cache [-f]

wq

گزینه‌های پیکربندی (CONFIGURATION OPTIONS)

این بخش گزینه‌های پیکربندی مورد استفاده در cmus را شرح می‌دهد.

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

auto_expand_albums_follow, auto_expand_albums_search, auto_expand_albums_selcur (true)

auto_hide_playlists_panel (false)

auto_reshuffle (true)

aaa_mode (all) [all, artist, album]

altformat_current [Format String]

altformat_playlist [Format String]

altformat_title [Format String]

altformat_trackwin [Format String]

block_key_paste (true)

buffer_seconds (10) [1-300]

color_cmdline_bg (default) [Color]

color_cmdline_fg (default) [Color]

color_cmdline_attr (default) [Attributes]

color_error (lightred) [Color]

color_info (lightyellow) [Color]

color_separator (blue) [Color]

color_statusline_bg (gray) [Color]

color_statusline_fg (black) [Color]

color_statusline_attr (default) [Attributes]

color_statusline_progress_bg (blue) [Color]

color_statusline_progress_fg (white) [Color]

color_statusline_progress_attr (default) [Attributes]

color_titleline_bg (blue) [Color]

color_titleline_fg (white) [Color]

color_titleline_attr (default) [Attributes]

color_win_bg (default) [Color]

color_win_cur (lightyellow) [Color]

color_win_cur_attr (default) [Attributes]

color_win_cur_sel_bg (blue) [Color]

color_win_cur_sel_fg (lightyellow) [Color]

color_win_cur_sel_attr (default) [Attributes]

color_win_dir (lightblue) [Color]

color_win_fg (default) [Color]

color_win_attr (default) [Attributes]

color_win_inactive_cur_sel_bg (gray) [Color]

color_win_inactive_cur_sel_fg (lightyellow) [Color]

color_win_inactive_cur_sel_attr (default) [Attributes]

color_win_inactive_sel_bg (gray) [Color]

color_win_inactive_sel_fg (black) [Color]

color_win_inactive_sel_attr (default) [Attributes]

color_win_sel_bg (blue) [Color]

color_win_sel_fg (white) [Color]

color_win_sel_attr (default) [Attributes]

color_win_title_bg (blue) [Color]

color_win_title_fg (white) [Color]

color_win_title_attr (default) [Attributes]

color_trackwin_album_bg (default) [Color]

color_trackwin_album_fg (default) [Color]

color_trackwin_album_attr (bold) [Attributes]

confirm_run (true)

continue (true)

continue_album (true)

device (/dev/cdrom)

display_artist_sort_name (false)

follow (false)

format_clipped_text [Plain String]

format_current [Format String]

format_heading_album [Format String]

format_heading_artist [Format String]

format_heading_playlist [Format String]

format_playlist [Format String]

format_playlist_va [Format String]

format_statusline [Format String]

format_title [Format String]

format_trackwin [Format String]

format_trackwin_album [Format String]

format_trackwin_va [Format String]

format_treewin [Format String]

format_treewin_artist [Format String]

smart_artist_sort (true)

sort_albums_by_name (false)

id3_default_charset (ISO-8859-1)

icecast_default_charset (ISO-8859-1)

ignore_duplicates (false)

lib_add_filter [Filter]

lib_sort (artist album discnumber tracknumber title filename) [Sort Keys]

mouse (false)

mpris (true)

output_plugin [roar, pulse, alsa, arts, oss, sndio, sun, coreaudio, aaudio]

passwd [password]

pause_on_output_change (false)

pl_env_vars

pl_sort () [Sort Keys]

play_library (true)

play_sorted (false)

progress_bar (line) [disabled, line, shuttle, color, color_shuttle]

repeat (false)

repeat_current (false)

replaygain (disabled) [track, album, track-preferred, album-preferred, smart]

replaygain_limit (true)

replaygain_preamp (0.0)

resume (false)

rewind_offset (5) [-1-9999]

scroll_offset (2) [0-9999]

search_resets_position (true)

show_all_tracks (true)

show_hidden (false)

show_current_bitrate (false)

show_playback_position (true)

show_remaining_time (false)

shuffle (off) [off, tracks, albums]

skip_track_info (false)

softvol (false)

softvol_state (100 100)

start_view (tree) [tree, sorted, playlist, queue, browser, filters, settings]

status_display_program () [command]

stop_after_queue (false)

time_show_leading_zero (true)

tree_width_percent (33) [1-100]

tree_width_max (0) [0-9999]

set tree_width_percent=100
set tree_width_max=60

set tree_width_percent=33
set tree_width_max=60

set tree_width_percent=33
set tree_width_max=0

wrap_search (true)

: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

گزینه‌های افزونه (PLUGIN OPTIONS)

dsp.alsa.device

mixer.alsa.channel

mixer.alsa.device

mixer.pulse.restore_volume

dsp.ao.buffer_size

dsp.ao.device_interface

dsp.ao.driver

dsp.ao.wav_counter

dsp.ao.wav_dir

dsp.coreaudio.device

dsp.coreaudio.enable_hog_mode

dsp.coreaudio.sync_sample_rate

dsp.jack.server_name

dsp.jack.resampling_quality

dsp.aaudio.performance_mode (power_saving) [power_saving, none]

dsp.aaudio.allowed_capture (all) [all, system, none]

dsp.aaudio.sharing_mode (shared) [shared, exclusive]

dsp.aaudio.disable_spatialization (false)

input.cdio.cddb_url

input.*.priority

dsp.oss.device

mixer.oss.channel

mixer.oss.device

dsp.roar.server

dsp.roar.role [music, background_music, ...]

dsp.sun.device

mixer.sun.channel

mixer.sun.device

پخش دیسک‌های صوتی (PLAYING AUDIO DISCS)

اگر افزونه ورودی cdio فعال باشد، می‌توان دیسک‌های صوتی CD و ایمیج‌های CD را با تنظیم گزینه device به یک فایل دستگاه (مانند /dev/cdrom) یا یک فایل ایمیج (مانند ~/cd.cue) پخش کرد. سپس، با استفاده از طرحواره نشانی اینترنتی CDDA قطعه جدیدی اضافه کنید:

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

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

متاداده‌ها از CD-Text خوانده می‌شوند، و اگر موجود نباشند، از یک سرور CDDB جستجو خواهند شد (گزینه input.cdio.cddb_url را ببینید).

فیلترها (FILTERS)

فیلترها عمدتاً برای فیلتر کردن محتویات نماهای کتابخانه (۱ و ۲) به کار می‌روند. فیلترها محتوای واقعی کتابخانه را تغییر نمی‌دهند؛ یعنی دستور :save همچنان تمام قطعات را چه قابل مشاهده باشند یا خیر در فایل لیست پخش ذخیره خواهد کرد.

فایل‌ها (FILES)

برنامه cmus پیکربندی خود را از ۳ مکان مختلف به ترتیب زیر می‌خواند:

$XDG_CONFIG_HOME/cmus/autosave

/usr/share/cmus/rc

$XDG_CONFIG_HOME/cmus/rc

محیط (ENVIRONMENT)

CMUS_CHARSET

CMUS_HOME

CMUS_SOCKET

HOME

http_proxy

USER

USERNAME

رابط D-Bus (MPRIS)

برنامه cmus یک رابط D-Bus مطابق با مشخصات واسط راه‌دور پخش‌کننده چندرسانه‌ای (MPRIS) نسخه ۲ ارائه می‌دهد:

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

فیلدهای متاداده از قرارداد نام‌گذاری مشخصات پیروی می‌کنند:

اشکالات (BUGS)

فایل اشکال‌زدایی تنها در صورتی وجود دارد که cmus را با حداکثر سطح اشکال‌زدایی پیکربندی کرده باشید (./configure DEBUG=2).

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

درخواست‌های قابلیت جدید و گزارش‌های اشکال باید به سامانه پیگیری اشکالات در گیت‌هاب ارسال شوند:

همچنین ببینید (SEE ALSO)

cmus-tutorial(7), cmus-remote(1)

نویسندگان (AUTHORS)

برنامه cmus عمدتاً توسط Timo Hirvonen <tihirvon@gmail.com> نوشته شده است. سایر مشارکت‌کنندگان در فایل AUTHORS فهرست شده‌اند.

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