نام (NAME)

ncmpcpp - یک کلاینت ncurses برای دیمن پخش موسیقی (MPD).

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

ncmpcpp [گزینه‌ها]

توضیحات (DESCRIPTION)

‏ncmpcpp یک کلاینت ncurses برای MPD (Music Player Daemon) است که از ncmpc الهام گرفته شده است.

درباره MPD بیشتر در http://www.musicpd.org بخوانید

گزینه‌ها (OPTIONS)

آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.

-h, --host=HOST: اتصال به سرور در میزبان [localhost]
-p, --port=PORT: اتصال به سرور در درگاه [6600]
--current-song[=FORMAT]: چاپ آهنگ فعلی با استفاده از قالب داده‌شده و خروج
-c, --config=FILE: مشخص کردن فایل(های) پیکربندی
--ignore-config-errors: نادیده گرفتن گزینه‌های ناشناخته و نامعتبر در فایل‌های پیکربندی
-b, --bindings=FILE: مشخص کردن فایل(های) کلیدهای میانبر (bindings)
-s, --screen <name>: مشخص کردن صفحه آغازین (<name> می‌تواند یکی از موارد زیر باشد: help، playlist، browser، search_engine، media_library، playlist_editor، tag_editor، outputs، visualizer، clock)
-S, --slave-screen <name>: مشخص کردن صفحه وابسته (slave) آغازین (<name> می‌تواند یکی از موارد زیر باشد: help، playlist، browser، search_engine، media_library، playlist_editor، tag_editor، outputs، visualizer، clock)
-q, --quiet: جلوگیری از نمایش گزارش‌ها و خروجی‌های اضافی
-?, --help: نمایش راهنما.
-v, --version: نمایش اطلاعات نسخه.

پیکربندی (CONFIGURATION)

هنگامی که ncmpcpp شروع به کار می‌کند، تلاش می‌کند تا تنظیمات را از فایل‌های $XDG_CONFIG_HOME/ncmpcpp/config و $HOME/.ncmpcpp/config بخواند. اگر هیچ پیکربندی‌ای یافت نشود، ncmpcpp از پیکربندی پیش‌فرض خود استفاده می‌کند. یک نمونه فایل پیکربندی حاوی تمام مقادیر پیش‌فرض همراه با ncmpcpp ارائه شده است و معمولاً می‌توان آن را در /usr/share/doc/ncmpcpp یافت (مکان دقیق آن ممکن است به سیستم‌عامل یا پیشوند configure شما بستگی داشته باشد).

نکته: مقادیر گزینه‌های پیکربندی می‌توانند درون علامت نقل‌قول قرار گیرند یا خیر.
- اگر در علامت نقل‌قول قرار گیرند، چپ‌ترین و راست‌ترین علامت‌های نقل‌قول به عنوان جداکننده در نظر گرفته می‌شوند، بنابراین نیازی به گریزدهی (escape) علامت‌های نقل‌قولی که درون خود مقدار استفاده می‌کنید نیست.
- اگر در علامت نقل‌قول قرار نگیرند، هرگونه نویسه فاصله بین = و اولین نویسه قابل چاپِ مقدار، و همچنین نویسه‌های فاصله پس از آخرین نویسه قابل چاپِ مقدار، حذف (trim) می‌شوند.

بنابراین قاعده کلی این است: اگر به فاصله‌های خالی در ابتدا یا انتهای مقدار نیاز دارید، آن را درون علامت نقل‌قول قرار دهید؛ در غیر این صورت، نیازی نیست.

نکته: COLOR باید نام (نه شماره) یکی از رنگ‌های ۱ تا ۸ از بخش SONG FORMAT باشد.

گزینه‌های پیکربندی پشتیبانی‌شده:

ncmpcpp_directory = PATH: دایرکتوری ذخیره‌سازی فایل‌های مرتبط با ncmpcpp. تغییر دادن آن زمانی مفید است که بخواهید همه چیز را در جای دیگری ذخیره کنید و هنگام راه‌اندازی ncmpcpp، تنظیمات خط فرمانی را برای مکان جایگزین فایل پیکربندی که آن را تعریف می‌کند ارائه دهید.
lyrics_directory = PATH: دایرکتوری ذخیره‌سازی متن آهنگ‌های (lyrics) دانلودشده. مقدار پیش‌فرض آن ~/.lyrics است زیرا کلاینت‌های دیگر MPD (مانند ncmpc) نیز از این مکان استفاده می‌کنند.
mpd_host = HOST: اتصال به MPD در حال اجرا روی میزبان/سوکت یونیکس مشخص‌شده. هنگامی که HOST با '/' شروع شود، یک سوکت یونیکس در نظر گرفته می‌شود. نکته: متغیر محیطی MPD_HOST این تنظیم را بازنویسی می‌کند.
mpd_port = PORT: اتصال به MPD روی درگاه مشخص‌شده. نکته: متغیر محیطی MPD_PORT این تنظیم را بازنویسی می‌کند.
mpd_password = PASSWORD: استفاده از PASSWORD برای احراز هویت در MPD.
mpd_music_dir = PATH: جستجوی فایل‌ها در دایرکتوری مشخص‌شده. این گزینه برای کارکرد ویرایشگر برچسب (tag editor) مورد نیاز است.
mpd_connection_timeout = SECONDS: تنظیم مهلت زمانی اتصال به MPD روی مقدار داده‌شده به ثانیه.
mpd_crossfade_time = SECONDS: تعداد ثانیه‌های پیش‌فرض برای crossfade، در صورتی که توسط ncmpcpp فعال شده باشد.
visualizer_data_source = LOCATION: منبع داده برای بصری‌ساز (visualizer). برای MPD خروجی fifo و برای Mopidy خروجی udpsink خواهد بود (برای جزئیات بیشتر به نمونه فایل پیکربندی مراجعه کنید).
visualizer_output_name = NAME: نام خروجی ارائه‌دهنده داده برای بصری‌ساز. برای همگام نگه داشتن صدا و بصری‌سازی مورد نیاز است.
visualizer_in_stereo = yes/no: اگر قالب خروجی fifo روی 44100:16:2 تنظیم شده باشد، باید روی 'yes' تنظیم شود.
visualizer_type = spectrum/wave/wave_filled/ellipse: نوع پیش‌فرض بصری‌ساز را مشخص می‌کند (spectrum تنها در صورتی در دسترس است که ncmpcpp با پشتیبانی از fftw کامپایل شده باشد).
visualizer_look = STRING: ظاهر بصری‌ساز را مشخص می‌کند (طول رشته باید دقیقاً ۲ نویسه باشد: نویسه اول برای wave و دوم برای طیف فرکانس [spectrum]).
visualizer_color = COLORS: فهرستی جداشده با کاما از رنگ‌های مورد استفاده در بصری‌سازی موسیقی.
visualizer_fps = FPS: تعداد فریم بر ثانیه برای بصری‌ساز.
visualizer_autoscale = yes/no: مقیاس‌بندی خودکار اندازه بصری‌ساز.
visualizer_spectrum_smooth_look = yes/no: برای بصری‌ساز spectrum، استفاده از نویسه‌های بلوکی یونیکد برای ظاهری روان‌تر و پیوسته‌تر. این گزینه بر گزینه visualizer_look اولویت خواهد داشت. با پایانه‌های شفاف و فعال بودن visualizer_in_stereo، ممکن است اعوجاج‌هایی در نیمه پایینی بصری‌سازی دیده شود.
visualizer_spectrum_smooth_look_legacy_chars = yes/no: استفاده از نویسه‌های بلوکی یونیکد از «symbols for legacy computing». این کار با استفاده از نویسه‌های خاص یونیکد به‌جای معکوس کردن رنگ پس‌زمینه و پیش‌زمینه در لبه پایینی طیف، ظاهر روان در پایانه‌های شفاف را بهبود می‌بخشد. اگر این کار منجر به خروجی به‌هم‌ریخته در لبه پایینی طیف شد، می‌توانید قلم را تغییر دهید یا این گزینه را غیرفعال کنید.
visualizer_spectrum_dft_size = NUMBER: برای بصری‌ساز spectrum، مقداری بین ۱ تا ۵ (شامل خود آن‌ها). تعیین مقدار بزرگ‌تر باعث می‌شود بصری‌ساز بازه زمانی بزرگ‌تری را در نظر بگیرد، که منجر به خروجی با پرش کمتر در بصری‌ساز می‌شود.
visualizer_spectrum_gain = dB: بهره (Gain) برای بصری‌ساز spectrum بر حسب دسی‌بل (dB)؛ مقادیر بزرگ‌تر/کوچک‌تر نوارها را به بالا/پایین جابه‌جا می‌کنند.
visualizer_spectrum_hz_min = Hz: برای بصری‌ساز spectrum، چپ‌ترین فرکانس بصری‌ساز، باید کمتر از HZ MAX باشد.
visualizer_spectrum_hz_max = Hz: برای بصری‌ساز spectrum، راست‌ترین فرکانس بصری‌ساز، باید بیشتر از HZ MIN باشد.
system_encoding = ENCODING: اگر از کدگذاری دیگری غیر از utf8 استفاده می‌کنید، آن را تنظیم کنید تا رشته‌های کدگذاری‌شده با utf8 به درستی پردازش شوند.
playlist_disable_highlight_delay = SECONDS: تأخیر در برجسته‌سازی فهرست پخش پس از فشردن آخرین کلید. در صورت تنظیم روی 0، برجسته‌سازی هرگز محو نمی‌شود.
message_delay_time = SECONDS: مدت زمان تأخیر برای باقی ماندن پیام‌های نمایش‌داده‌شده.
song_list_format: قالب نمایش آهنگ برای فهرست‌های آهنگ‌ها.
song_status_format: قالب نمایش آهنگ برای نوار وضعیت.
song_library_format: قالب نمایش آهنگ برای کتابخانه چندرسانه‌ای.
alternative_header_first_line_format = TEXT: قالب آهنگ در حال پخش برای خط اول در پنجره سربرگ رابط کاربری جایگزین.
alternative_header_second_line_format = TEXT: قالب آهنگ در حال پخش برای خط دوم در پنجره سربرگ رابط کاربری جایگزین.
current_item_prefix = TEXT: پیشوند برای موردِ در حال حاضر انتخاب‌شده.
current_item_suffix = TEXT: پسوند برای موردِ در حال حاضر انتخاب‌شده.
current_item_inactive_column_prefix = TEXT: پیشوند برای موردِ در حال حاضر انتخاب‌شده در ستون غیرفعال.
current_item_inactive_column_suffix = TEXT: پسوند برای موردِ در حال حاضر انتخاب‌شده در ستون غیرفعال.
now_playing_prefix = TEXT: پیشوند برای آهنگ در حال پخش.
now_playing_suffix = TEXT: پسوند برای آهنگ در حال پخش.
browser_playlist_prefix = TEXT: پیشوند برای فهرست‌های پخش در مرورگر (Browser).
selected_item_prefix = TEXT: پیشوند برای موارد انتخاب‌شده..TP selected_item_suffix = TEXT پسوند برای موارد انتخاب‌شده.
modified_item_prefix = TEXT: پیشوند برای مورد ویرایش‌شده (ویرایشگر برچسب).
browser_sort_mode: حالت مرتب‌سازی را برای مرورگر تعیین می‌کند. مقادیر ممکن عبارتند از "type"،‏ "name"،‏ "mtime"،‏ "format" و "none".
browser_sort_format: قالب مورد استفاده برای مرتب‌سازی آهنگ‌ها در مرورگر. برای مؤثر بودن این گزینه، browser_sort_mode باید روی "format" تنظیم شده باشد.
song_window_title_format: قالب آهنگ برای عنوان پنجره.
song_columns_list_format: قالب فهرست آهنگ‌های نمایش‌یافته در ستون‌ها.
execute_on_song_change = COMMAND: دستور پوسته برای اجرا هنگام تغییر آهنگ.
execute_on_player_state_change = COMMAND: دستور پوسته برای اجرا هنگام تغییر وضعیت پخش‌کننده. متغیر محیطی MPD_PLAYER_STATE در طول اجرای آن روی وضعیت کنونی (یکی از موارد unknown،‏ play،‏ pause یا stop) تنظیم می‌شود.
playlist_show_mpd_host = yes/no: در صورت فعال بودن، میزبان کنونی MPD در فهرست پخش نمایش داده خواهد شد.
playlist_show_remaining_time = yes/no: در صورت فعال بودن، زمان باقی‌مانده تا پایان فهرست پخش، پس از آمار فهرست پخش نمایش داده می‌شود.
playlist_shorten_total_times = yes/no: در صورت فعال بودن، زمان کل/باقی‌مانده فهرست پخش که در نوار وضعیت نمایش داده می‌شود، با استفاده از نام‌های کوتاه‌شده یکاها نشان داده خواهد شد (d:h:m:s به جای days:hours:minutes:seconds).
playlist_separate_albums = yes/no: در صورت فعال بودن، جداکننده‌ها بین آلبوم‌ها قرار خواهند گرفت.
playlist_display_mode = classic/columns: حالت نمایش پیش‌فرض برای فهرست پخش (Playlist).
browser_display_mode = classic/columns: حالت نمایش پیش‌فرض برای مرورگر (Browser).
search_engine_display_mode = classic/columns: حالت نمایش پیش‌فرض برای موتور جستجو (Search engine).
playlist_editor_display_mode = classic/columns: حالت نمایش پیش‌فرض برای ویرایشگر فهرست پخش (Playlist editor).
discard_colors_if_item_is_selected = yes/no: مشخص می‌کند که آیا در صورت انتخاب شدن یک مورد، رنگ‌های سفارشی برچسب‌ها باید نادیده گرفته شوند یا خیر.
show_duplicate_tags = yes/no: مشخص می‌کند که آیا ncmpcpp باید برچسب‌های چندگانه را همان‌گونه که هست نمایش دهد یا موارد تکراری را حذف کند.
incremental_seeking = yes/no: در صورت فعال بودن، زمان پیمایش به ازای هر ثانیه پیمایش، یک واحد افزایش می‌یابد.
seek_time = SECONDS: زمان پایه پیمایش برای شروع.
volume_change_step = NUMBER: درصدی از صدا که باید در volume_up/volume_down افزایش یا کاهش یابد.
autocenter_mode = yes/no: وضعیت پیش‌فرض برای حالت مرکزنشینی خودکار (autocenter) در هنگام شروع.
centered_cursor = yes/no: در صورت فعال بودن، موقعیت برجسته‌شده کنونی در فهرست، همیشه در مرکز قرار خواهد گرفت.
progressbar_look = TEXT: این متغیر ظاهر نوار پیشرفت (progressbar) را مشخص می‌کند. توجه داشته باشید که طول آن باید دقیقاً دو یا سه نویسه باشد.
default_place_to_search_in = database/playlist: اگر روی "playlist" تنظیم شود، موتور جستجو به جای پایگاه‌داده موسیقی، جستجو را در فهرست پخش کنونی MPD انجام می‌دهد.
user_interface = classic/alternative: رابط کاربری پیش‌فرض مورد استفاده توسط ncmpcpp در هنگام شروع.
data_fetching_delay = yes/no: در صورت فعال بودن، تأخیری ۲۵۰ میلی‌ثانیه‌ای بین تازه‌سازی موقعیت در کتابخانه چندرسانه‌ای یا ویرایشگر فهرست پخش و واکشی داده‌های مربوطه از MPD وجود خواهد داشت. این کار داده‌های دریافت‌شده از کارساز را محدود می‌کند و به‌ویژه زمانی که ncmpcpp به یک میزبان دوردست متصل است بسیار مفید است.
media_library_primary_tag = artist/album_artist/date/genre/composer/performer: نوع برچسب پیش‌فرض برای ستون سمت چپ در کتابخانه چندرسانه‌ای.
media_library_albums_split_by_date = yes/no: مشخص می‌کند که آیا آلبوم‌ها در کتابخانه چندرسانه‌ای باید بر اساس تاریخ تفکیک شوند یا خیر.
media_library_hide_album_dates = yes/no: مشخص می‌کند که آیا تاریخ آلبوم‌ها در کتابخانه چندرسانه‌ای باید پنهان شود یا خیر.
default_find_mode = wrapped/normal: اگر روی "wrapped" تنظیم شود، رفتن از آخرین موقعیت یافت‌شده به بعدی، شما را به اولین موقعیت می‌برد (و بالعکس برای رفتن از اولین موقعیت به قبلی)، در غیر این صورت هیچ عملی انجام نخواهد شد.
default_tag_editor_pattern = TEXT: الگوی پیش‌فرض مورد استفاده توسط تجزیه‌کنندهٔ ویرایشگر برچسب (Tag editor).
header_visibility = yes/no: در صورت فعال بودن، پنجره سربرگ نمایش داده می‌شود، در غیر این صورت پنهان خواهد شد.
statusbar_visibility = yes/no: در صورت فعال بودن، نوار وضعیت نمایش داده می‌شود، در غیر این صورت پنهان خواهد شد.
connected_message_on_startup = yes/no: نمایش پیام "... Connected to" در هنگام راه‌اندازی.
titles_visibility = yes/no: در صورت فعال بودن، عنوان ستون‌ها نمایش داده می‌شود، در غیر این صورت پنهان خواهد شد.
header_text_scrolling = yes/no: در صورت فعال بودن، اگر طول متن در پنجره سربرگ بیشتر از عرض واقعی صفحه باشد پیمایش می‌شود، در غیر این صورت پیمایش نخواهد شد.
cyclic_scrolling = yes/no: در صورت فعال بودن، از پیمایش چرخشی استفاده می‌شود (برای نمونه اگر در انتهای فهرست کلید جهت‌نمای رو به پایین را فشار دهید، شما را به ابتدا می‌برد).
lyrics_fetchers = FETCHERS: فهرستی از واکِشنده‌های متن ترانه که با کاما از هم جدا شده‌اند.
follow_now_playing_lyrics = yes/no: در صورت فعال بودن، هنگام تغییر آهنگ، متن ترانه به آهنگ در حال پخش تغییر می‌یابد (توجه: این قابلیت تنها زمانی کار می‌کند که در حال مشاهده متن ترانه موردی از فهرست پخش باشید).
fetch_lyrics_for_current_song_in_background = yes/no: در صورت فعال بودن، با هر بار تغییر آهنگ، واکِشنده متن ترانه به‌طور خودکار در پس‌زمینه اجرا می‌شود تا متن ترانه را برای آهنگ در حال پخش بارگیری کند.
store_lyrics_in_song_dir = yes/no: در صورت فعال بودن، متن ترانه در دایرکتوری آهنگ ذخیره خواهد شد، در غیر این صورت در ‎~/.lyrics‎ ذخیره می‌شود. توجه داشته باشید که این گزینه به تنظیم صحیح mpd_music_dir نیاز دارد.
generate_win32_compatible_filenames = yes/no: اگر روی yes تنظیم شود، نام‌فایل‌های ایجادشده توسط ncmpcpp (توسط ویرایشگر برچسب، برای متن ترانه‌ها، هنرمندان و غیره) شامل این نویسه‌ها نخواهند بود: \?*:|
allow_for_physical_item_deletion = yes/no: اگر روی yes تنظیم شود، حذف فیزیکی فایل‌ها و دایرکتوری‌ها از روی دیسک در مرورگر امکان‌پذیر خواهد بود.
lastfm_preferred_language = ISO 639 alpha-2 language code: در صورت تنظیم، ncmpcpp تلاش می‌کند اطلاعات را از last.fm به زبان تعیین‌شده دریافت کند و در صورت ناموفق بودن، به انگلیسی بازمی‌گردد. در غیر این صورت از همان ابتدا از زبان انگلیسی استفاده خواهد کرد.
space_add_mode = add_remove/always_add: اگر روی add_remove تنظیم شود، تلاش برای افزودن فایل‌هایی که از قبل در فهرست پخش موجودند، آن‌ها را حذف خواهد کرد. در غیر این صورت می‌توان آن‌ها را چندین بار اضافه کرد.
show_hidden_files_in_local_browser = yes/no: کلید تغییر وضعیت برای نمایش فایل‌ها و دایرکتوری‌هایی که با '.' شروع می‌شوند در مرورگر محلی.
screen_switcher_mode = SWITCHER_MODE: اگر روی "previous" تنظیم شود، کلید key_screen_switcher بین صفحه کنونی و آخرین صفحه استفاده‌شده جابه‌جا خواهد شد. اگر روی "screen1,...screenN" (فهرستی از صفحه‌ها) تنظیم شود، به‌صورت متوالی بین آن‌ها جابه‌جا می‌شود. توضیحات دقیق‌تر ساختار نحو را می‌توانید در فایل پیکربندی نمونه پیدا کنید.
startup_screen = SCREEN_NAME: صفحه‌ای که باید در هنگام شروع نمایش داده شود (به طور پیش‌فرض playlist).
startup_slave_screen = SCREEN_NAME: صفحه فرعی (slave) که باید در هنگام شروع نمایش داده شود (به طور پیش‌فرض هیچ‌چیز).
startup_slave_screen_focus = yes/no: اگر روی yes تنظیم شود، صفحه فرعی پس از راه‌اندازی صفحه فعال خواهد بود. در غیر این صورت صفحه اصلی (master) فعال خواهد بود.
locked_screen_width_part = 20-80: اگر بخواهید صفحه‌ای را قفل کنید، ncmpcpp پیش از آن درصد عرض صفحه قفل‌شده را برای رزرو درخواست می‌کند و یک مقدار پیش‌فرض ارائه می‌دهد که همان مقداری است که می‌توانید در اینجا تعیین کنید.
ask_for_locked_screen_width_part = yes/no: در صورت فعال بودن، ncmpcpp هر بار که بخواهید صفحه‌ای را قفل کنید، درصد عرض صفحه قفل‌شده را می‌پرسد. اگر آن را غیرفعال کنید، بدون پرسش تلاش می‌کند از مقدار پیش‌فرض استفاده کند.
media_library_column_width_ratio_two = a:b: نسبت عرض ستون‌ها در کتابخانه چندرسانه‌ای، هنگامی که دو ستون وجود دارد.
media_library_column_width_ratio_three = a:b:c: نسبت عرض ستون‌ها در کتابخانه چندرسانه‌ای، هنگامی که سه ستون وجود دارد.
playlist_editor_column_width_ratio = a:b: نسبت عرض ستون‌ها در ویرایشگر فهرست پخش.
jump_to_now_playing_song_at_start = yes/no: در صورت فعال بودن، اگر mpd در حال پخش یا متوقف موقت (pause) باشد، ncmpcpp در هنگام شروع به آهنگ در حال پخش پرش خواهد کرد.
ask_before_clearing_playlists = yes/no: در صورت فعال بودن، پس از فشردن کلید مربوط به پاکسازی، از کاربر پرسیده می‌شود که آیا واقعاً می‌خواهد فهرست پخش را پاک کند یا خیر.
clock_display_seconds = yes/no: در صورت فعال بودن، ساعت زمان را در قالب hh:mm:ss نمایش می‌دهد، در غیر این صورت hh:mm.
display_volume_level = yes/no: در صورت فعال بودن، سطح صدا در نوار وضعیت نمایش داده خواهد شد، در غیر این صورت خیر..TP display_bitrate = yes/no در صورت فعال بودن، بیت‌ریت (bitrate) آهنگ در حال پخش در نوار وضعیت نمایش داده خواهد شد.
display_remaining_time = yes/no: در صورت فعال بودن، زمان باقی‌مانده از آهنگ در حال پخش به جای زمان سپری‌شده در نوار وضعیت نمایش داده خواهد شد.
regular_expressions = none/basic/extended/perl: نوع عبارت‌های باقاعده (regular expressions) مورد استفاده.
ignore_leading_the = yes/no: در صورت فعال بودن، واژه «the» در ابتدای برچسب‌ها، نام فایل‌ها و قالب‌های مرتب‌سازی هنگام مرتب کردن موارد نادیده گرفته خواهد شد.
ignore_diacritics = yes/no: در صورت فعال بودن، نشانه‌های تفکیک‌کننده و اعراب (diacritics) در رشته‌ها هنگام جست‌وجو و پالایش فهرست‌ها نادیده گرفته می‌شوند.
block_search_constraints_change_if_items_found = yes/no: در صورت فعال بودن، فیلدهای موجود در موتور جست‌وجو در بالای دکمه «Reset» پس از جست‌وجوی موفق قفل می‌شوند؛ در غیر این صورت قفل نخواهند شد.
mouse_support = yes/no: اگر بر روی yes تنظیم شود، پشتیبانی از موشواره فعال خواهد شد.
mouse_list_scroll_whole_page = yes/no: در صورت فعال بودن، چرخ موشواره در هر بار تمام صفحهٔ فهرست موارد را پیمایش می‌کند؛ در غیر این صورت تعداد خطوط مشخص‌شده توسط متغیر lines_scrolled پیمایش می‌شود.
lines_scrolled = NUMBER: تعداد خطوطی که با چرخ موشواره پیمایش می‌شوند.
empty_tag_marker = TEXT: متنی که در صورت تنظیم نبودن برچسبِ درخواستی نمایش داده خواهد شد.
tags_separator = TEXT: جداکننده‌ای که میان برچسب‌ها قرار می‌گیرد. همچنین توسط ویرایشگر برچسب خوانده شده و برای تقسیم رشتهٔ ورودی به برچسب‌های مجزا استفاده می‌شود.
tag_editor_extended_numeration = yes/no: در صورت فعال بودن، ویرایشگر برچسب، قطعه‌ها را با استفاده از قالب xx/yy (که در آن xx قطعهٔ کنونی و yy تعداد کل قطعه‌های شماره‌گذاری‌شده است) شماره‌گذاری می‌کند، نه فقط xx ساده.
media_library_sort_by_mtime = yes/no: در صورت فعال بودن، کتابخانه چندرسانه‌ای بر اساس زمان تغییر مرتب خواهد شد؛ در غیر این صورت مرتب‌سازی الفبایی استفاده می‌شود.
enable_window_title = yes/no: در صورت فعال بودن، ncmpcpp عنوان پنجرهٔ فعلی را بازنویسی کرده و عنوان خود را جایگزین آن می‌کند.
search_engine_default_search_mode = MODE_NUMBER: شمارهٔ حالت پیش‌فرضی که در موتور جست‌وجو استفاده می‌شود.
external_editor = PATH: مسیر ویرایشگر خارجی مورد استفاده برای ویرایش متن آهنگ.
use_console_editor = yes/no: اگر ویرایشگر خارجی شما یک برنامهٔ کنسولی (ترمینالی) است، باید این گزینه را فعال کنید.
colors_enabled = yes/no: نیازی به توضیح ندارد، نه؟
empty_tag_color = COLOR: رنگ نشانگر برچسب خالی.
header_window_color = COLOR: رنگ پنجرهٔ سربرگ (header).
volume_color = COLOR: رنگ وضعیت بلندی صدا.
state_line_color = COLOR: رنگ خطوط جداکننده سربرگ و نوار وضعیت از پنجره اصلی.
state_flags_color = COLOR: رنگ پرچم‌های وضعیت MPD.
main_window_color = COLOR: رنگ پنجرهٔ اصلی.
color1 = COLOR: یکی از رنگ‌های مورد استفاده در Song info، Tiny tag editor و موتور جست‌وجو.
color2 = COLOR: یکی از رنگ‌های مورد استفاده در Song info، Tiny tag editor و موتور جست‌وجو.
progressbar_color = COLOR: رنگ نوار پیشرفت (progressbar).
progressbar_elapsed_color = COLOR: رنگ بخشی از نوار پیشرفت که زمان سپری‌شده را نمایش می‌دهد.
statusbar_color = COLOR: رنگ نوار وضعیت (statusbar).
statusbar_time_color = COLOR: رنگ زمان قطعهٔ جاری که در نوار وضعیت نمایش داده می‌شود.
player_state_color = COLOR: رنگ وضعیت پخش‌کننده که در نوار وضعیت نمایش داده می‌شود.
alternative_ui_separator_color = COLOR: رنگ جداکننده‌های مورد استفاده در رابط کاربری جایگزین.
window_border_color = BORDER: رنگ کادر پنجره‌های بالاپران (pop-up). اگر روی 'none' تنظیم شود، هیچ کادری نمایش داده نخواهد شد.
active_window_border = COLOR: رنگ کادر پنجرهٔ فعال. هنگامی که ncmpcpp شروع به کار می‌کند، تلاش می‌کند کلیدهای میانبر را از فایل‌های $XDG_CONFIG_HOME/ncmpcpp/bindings و ~/.ncmpcpp/bindings بخواند. اگر هیچ فایل میانبری یافت نشود، ncmpcpp از مقادیر پیش‌فرض استفاده می‌کند. یک فایل نمونهٔ کلیدهای میانبر با مقادیر پیش‌فرض معمولاً در دایرکتوری /usr/share/doc/ncmpcpp موجود است (مکان دقیق ممکن است به سیستم‌عامل شما یا پیشوند پیکربندی configure بستگی داشته باشد).
می‌توانید با فشردن F1 کلیدهای میانبر فعلی را مشاهده کنید.

قالب آهنگ (SONG FORMAT)

برای قالب‌بندی آهنگ می‌توانید از موارد زیر استفاده کنید:

%l - مدت زمان
%f - نام فایل
%F - مسیر کامل فایل
%D - دایرکتوری
%a - هنرمند
%A - هنرمند آلبوم
%t - عنوان
%b - آلبوم
%y - تاریخ
%n - شماره قطعه (01/12 -> 01)
%N - اطلاعات کامل قطعه (01/12 -> 01/12)
%g - سبک
%c - آهنگساز
%p - اجراکننده
%d - دیسک
%C - یادداشت
%P - اولویت
$R - شروع تراز راست (راست‌چین)

همچنین می‌توانید آن‌ها را درون { } قرار دهید؛ در این صورت تنها زمانی نمایش داده می‌شوند که همهٔ مقادیر درخواستی در دسترس باشند، و/یا مقداری جایگزین را با { }|{ } تعریف کنید؛ برای مثال {%a - %t}|{%f} بررسی می‌کند که آیا برچسب‌های هنرمند و عنوان موجود هستند یا خیر، و اگر موجود باشند آن‌ها را نمایش می‌دهد، در غیر این صورت نام فایل را نمایش خواهد داد.

نکته: اگر می‌خواهید محدودیتی برای حداکثر طول یک برچسب تعیین کنید، کافی است عدد مورد نظر را بین % و نویسه‌ای که نوع برچسب را مشخص می‌کند قرار دهید؛ برای مثال، برای اینکه نام آلبوم حداکثر ۲۰ ستون ترمینال را اشغال کند، از '%20b' استفاده کنید.

نکته: قالبی که مشابه "%a - %t" باشد (یعنی بدون هیچ‌گونه آکولاد اضافی) معادل "{%a - %t}" در نظر گرفته می‌شود؛ بنابراین اگر یکی از برچسب‌ها موجود نباشد، هیچ‌چیز نمایش داده نخواهد شد.

متن می‌تواند رنگی متفاوت از پنجرهٔ اصلی داشته باشد؛ برای مثال اگر می‌خواهید مدت زمان به رنگ سبز نمایش داده شود، بنویسید: $3%l$9.

مقادیر موجود برای رنگ‌ها:

- 0 - رنگ پیش‌فرض پنجره (تمام رنگ‌های دیگر را لغو می‌کند)
- 1 - سیاه
- 2 - قرمز
- 3 - سبز
- 4 - زرد
- 5 - آبی
- 6 - ارغوانی
- 7 - فیروزه‌ای
- 8 - سفید
- 9 - پایان رنگ جاری

نکته: رنگ‌ها می‌توانند تودرتو باشند؛ بنابراین اگر عبارت $2some$5text$9 را بنویسید، تنها استفاده از رنگ آبی لغو می‌شود و رنگ قرمز رنگ جاری باقی خواهد ماند.

گزارش باگ‌ها (BUGS)

باگ‌ها را در https://github.com/arybczak/ncmpcpp/issues گزارش کنید.

نکته (NOTE)

از آنجا که MPD از UTF-8 استفاده می‌کند، ncmpcpp نیاز دارد نویسه‌ها را به مجموعه نویسه‌های مورد استفاده در سیستم محلی تبدیل کند. اگر در حین اجرای ncmpcpp با خطاهای تبدیل نویسه مواجه شدید، احتمالاً باید محلی‌سازی (locale) خود را تنظیم کنید. این کار با مقداردهی متغیرهای محیطی LANG و LC_ALL/LC_CTYPE انجام می‌شود (LC_CTYPE تنها بر مدیریت نویسه‌ها تأثیر می‌گذارد).

صفحه خانگی (HOMEPAGE)

-> http://rybczak.net/ncmpcpp

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

mpc(1), mpd(1)