.TH "ncmpcpp" "1"
.SH "نام (NAME)"
ncmpcpp \- یک کلاینت ncurses برای دیمن پخش موسیقی (MPD).
.SH "خلاصه دستور (SYNOPSIS)"
.B ncmpcpp
[گزینه‌ها]
.SH "توضیحات (DESCRIPTION)"
‏ncmpcpp یک کلاینت ncurses برای MPD (Music Player Daemon) است که از ncmpc الهام گرفته شده است.

درباره MPD بیشتر در http://www.musicpd.org بخوانید
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-h\fR, \fB\-\-host\fR=\fIHOST\fR
اتصال به سرور در میزبان [localhost]
.TP
\fB\-p\fR, \fB\-\-port\fR=\fIPORT\fR
اتصال به سرور در درگاه [6600]
.TP
\fB\-\-current-song\fR[=\fIFORMAT\fR]
چاپ آهنگ فعلی با استفاده از قالب داده‌شده و خروج
.TP
\fB\-c\fR, \fB\-\-config\fR=\fIFILE\fR
مشخص کردن فایل(های) پیکربندی
.TP
\fB\-\-ignore-config-errors\fR
نادیده گرفتن گزینه‌های ناشناخته و نامعتبر در فایل‌های پیکربندی
.TP
\fB\-b\fR, \fB\-\-bindings\fR=\fIFILE\fR
مشخص کردن فایل(های) کلیدهای میانبر (bindings)
.TP
\fB\-s\fR, \fB\-\-screen <name>\fR
مشخص کردن صفحه آغازین (<name> می‌تواند یکی از موارد زیر باشد: help، playlist، browser، search_engine، media_library، playlist_editor، tag_editor، outputs، visualizer، clock)
.TP
\fB\-S\fR, \fB\-\-slave-screen <name>\fR
مشخص کردن صفحه وابسته (slave) آغازین (<name> می‌تواند یکی از موارد زیر باشد: help، playlist، browser، search_engine، media_library، playlist_editor، tag_editor، outputs، visualizer، clock)
.TP
\fB\-q\fR, \fB\-\-quiet\fR
جلوگیری از نمایش گزارش‌ها و خروجی‌های اضافی
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش راهنما.
.TP
\fB\-v\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه.

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

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

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

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

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

می‌توانید با فشردن F1 کلیدهای میانبر فعلی را مشاهده کنید.
.SH "قالب آهنگ (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} بررسی می‌کند که آیا برچسب‌های هنرمند و عنوان موجود هستند یا خیر، و اگر موجود باشند آن‌ها را نمایش می‌دهد، در غیر این صورت نام فایل را نمایش خواهد داد.

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

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

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

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

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

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

.SH "گزارش باگ‌ها (BUGS)"
باگ‌ها را در https://github.com/arybczak/ncmpcpp/issues گزارش کنید.
.SH "نکته (NOTE)"
از آنجا که MPD از UTF\-8 استفاده می‌کند، ncmpcpp نیاز دارد نویسه‌ها را به مجموعه نویسه‌های مورد استفاده در سیستم محلی تبدیل کند. اگر در حین اجرای ncmpcpp با خطاهای تبدیل نویسه مواجه شدید، احتمالاً باید محلی‌سازی (locale) خود را تنظیم کنید. این کار با مقداردهی متغیرهای محیطی LANG و LC_ALL/LC_CTYPE انجام می‌شود (LC_CTYPE تنها بر مدیریت نویسه‌ها تأثیر می‌گذارد).
.SH "صفحه خانگی (HOMEPAGE)"
\-> http://rybczak.net/ncmpcpp

.SH "همچنین ببینید (SEE ALSO)"
mpc(1), mpd(1)