1. ####################################################
  2. ## this is example configuration file, copy it to ##
  3. ## ~/.ncmpcpp/config and set up your preferences ##
  4. ####################################################
  5. #
  6. ##### directories ######
  7. ##
  8. ## Directory for storing ncmpcpp related files.
  9. ## Changing it is useful if you want to store
  10. ## everything somewhere else and provide command
  11. ## line setting for alternative location to config
  12. ## file which defines that while launching ncmpcpp.
  13. ##
  14. #
  15. #ncmpcpp_directory = "~/.ncmpcpp"
  16. #
  17. ##
  18. ## Directory for storing downloaded lyrics. It
  19. ## defaults to ~/.lyrics since other MPD clients
  20. ## (eg. ncmpc) also use that location.
  21. ##
  22. #
  23. #lyrics_directory = "~/.lyrics"
  24. #
  25. ##### connection settings #####
  26. #
  27. ## set it in order to make tag editor and renaming files work properly
  28. #
  29. #mpd_host = "localhost"
  30. mpd_host = "localhost"
  31. #
  32. #mpd_port = "6600"
  33. mpd_port = "6600"
  34. #
  35. #mpd_music_dir = ""
  36. mpd_music_dir = "/mnt/sda3/music"
  37. #
  38. #mpd_connection_timeout = "5"
  39. #
  40. #mpd_crossfade_time = "5"
  41. mpd_crossfade_time = "0"
  42. #
  43. #mpd_communication_mode = "notifications" (polling/notifications)
  44. #
  45. ##### music visualizer #####
  46. ##
  47. ## Note: In order to make music visualizer work you'll
  48. ## need to use mpd fifo output, whose format parameter
  49. ## has to be set to 44100:16:1 for mono visualization
  50. ## or 44100:16:2 for stereo visualization. Example
  51. ## configuration (it has to be put into mpd.conf):
  52. ##
  53. ## audio_output {
  54. ## type "fifo"
  55. ## name "My FIFO"
  56. ## path "/tmp/mpd.fifo"
  57. ## format "44100:16:2"
  58. ## }
  59. ##
  60. #
  61. ##
  62. ## If you set format to 44100:16:2, make it 'yes'.
  63. ##
  64. #
  65. #visualizer_in_stereo = "no"
  66. visualizer_in_stereo = "no"
  67. #
  68. #visualizer_fifo_path = ""
  69. visualizer_fifo_path = "/tmp/mpd.fifo"
  70. #
  71. ##
  72. ## Note: Below parameter is needed for ncmpcpp
  73. ## to determine which output provides data for
  74. ## visualizer and thus allow syncing between
  75. ## visualization and sound as currently there
  76. ## are some problems with it.
  77. ##
  78. #
  79. #visualizer_output_name = ""
  80. visualizer_output_name = "my_fifo"
  81. #
  82. ##
  83. ## Note: Below parameter defines how often ncmpcpp
  84. ## has to "synchronize" visualizer and audio outputs.
  85. ## 30 seconds is optimal value, but if you experience
  86. ## synchronization problems, set it to lower value.
  87. ## Keep in mind that sane values start with >=10.
  88. ##
  89. #
  90. #visualizer_sync_interval = "30"
  91. #
  92. ##
  93. ## Note: To enable spectrum frequency visualization
  94. ## you need to compile ncmpcpp with fftw3 support.
  95. ##
  96. #
  97. #visualizer_type = "wave" (spectrum/wave)
  98. visualizer_type = "spectrum"
  99. #
  100. #visualizer_look = "◆│"
  101. visualizer_look = "■■"
  102. #
  103. ##### system encoding #####
  104. ##
  105. ## ncmpcpp should detect your charset encoding
  106. ## but if it failed to do so, you can specify
  107. ## charset encoding you are using here.
  108. ##
  109. ## Note: You can see whether your ncmpcpp build
  110. ## supports charset detection by checking output
  111. ## of `ncmpcpp --version`.
  112. ##
  113. ## Note: Since MPD uses utf8 by default, setting
  114. ## this option makes sense only if your encoding
  115. ## is different.
  116. ##
  117. #
  118. #system_encoding = ""
  119. #
  120. ##### delays #####
  121. #
  122. ## delay after playlist highlighting will be disabled (0 = don't disable)
  123. #
  124. #playlist_disable_highlight_delay = "5"
  125. playlist_disable_highlight_delay = "1"
  126. #
  127. ## defines how long various messages are supposed to be visible
  128. #
  129. #message_delay_time = "4"
  130. message_delay_time = "1"
  131. #
  132. ##### song format #####
  133. ##
  134. ## for song format you can use:
  135. ##
  136. ## %l - length
  137. ## %f - filename
  138. ## %D - directory
  139. ## %a - artist
  140. ## %A - album artist
  141. ## %t - title
  142. ## %b - album
  143. ## %y - date
  144. ## %n - track number (01/12 -> 01)
  145. ## %N - full track info (01/12 -> 01/12)
  146. ## %g - genre
  147. ## %c - composer
  148. ## %p - performer
  149. ## %d - disc
  150. ## %C - comment
  151. ## %P - priority
  152. ## $R - begin right alignment
  153. ##
  154. ## you can also put them in { } and then it will be displayed
  155. ## only if all requested values are available and/or define alternate
  156. ## value with { }|{ } eg. {%a - %t}|{%f}
  157. ##
  158. ## Note: If you want to set limit on maximal length of a tag, just
  159. ## put the appropriate number between % and character that defines
  160. ## tag type, e.g. to make album take max. 20 terminal cells, use '%20b'.
  161. ##
  162. ## Note: Format that is similar to "%a - %t" (i.e. without any additional
  163. ## braces) is equal to "{%a - %t}", so if one of the tags is missing,
  164. ## you'll get nothing.
  165. ##
  166. ## text can also have different color than the main window has,
  167. ## eg. if you want length to be green, write $3%l$9
  168. ##
  169. ## available values:
  170. ##
  171. ## - 0 - default window color (discards all other colors)
  172. ## - 1 - black
  173. ## - 2 - red
  174. ## - 3 - green
  175. ## - 4 - yellow
  176. ## - 5 - blue
  177. ## - 6 - magenta
  178. ## - 7 - cyan
  179. ## - 8 - white
  180. ## - 9 - end of current color
  181. ##
  182. ## Note: colors can be nested.
  183. ##
  184. #
  185. #song_list_format = "{%a - }{%t}|{$8%f$9}$R{$3(%l)$9}"
  186. song_list_format = "{%t}|{%f}{$R%l}"
  187. #
  188. #song_status_format = "{{%a{ \"%b\"{ (%y)}} - }{%t}}|{%f}"
  189. song_status_format = "{{%A{ \"%b\"{ (%y)}} - }{%t}}|{%f}"
  190. #
  191. #song_library_format = "{%n - }{%t}|{%f}"
  192. song_library_format = "{%n - }{%t}|{%f}"
  193. #
  194. #tag_editor_album_format = "{(%y) }%b"
  195. tag_editor_album_format = "{(%y) }%b"
  196. #
  197. ##
  198. ## Note: Below variables are used for sorting songs in browser.
  199. ## The sort mode determines how songs are sorted, and can be used
  200. ## in combination with a sort format to specify a custom sorting format.
  201. ## Possible values for browser_sort_mode are "name", "mtime" and "format".
  202. ##
  203. #
  204. #browser_sort_mode = "name"
  205. #
  206. #browser_sort_format = "{%a - }{%t}|{%f} {(%l)}"
  207. #
  208. ##
  209. ## Note: Below variables are for alternative version of user's interface.
  210. ## Their syntax supports all tags and colors listed above plus some extra
  211. ## markers used for text attributes. They are followed by character '$'.
  212. ## After that you can put:
  213. ##
  214. ## - b - bold text
  215. ## - u - underline text
  216. ## - r - reverse colors
  217. ## - a - use alternative character set
  218. ##
  219. ## If you don't want to use an attribute anymore, just put it again, but
  220. ## this time insert character '/' between '$' and attribute character,
  221. ## e.g. {$b%t$/b}|{$r%f$/r} will display bolded title tag or filename
  222. ## with reversed colors.
  223. ##
  224. #
  225. #alternative_header_first_line_format = "$b$1$aqqu$/a$9 {%t}|{%f} $1$atqq$/a$9$/b"
  226. alternative_header_first_line_format = "$b$8{%t}|{%f}$9$/b"
  227. #
  228. #alternative_header_second_line_format = "{{$4$b%a$/b$9}{ - $7%b$9}{ ($4%y$9)}}|{%D}"
  229. alternative_header_second_line_format = "$5{%A}{ - %b}$9"
  230. #
  231. ##
  232. ## Note: Below variables also supports
  233. ## text attributes listed above.
  234. ##
  235. #
  236. #now_playing_prefix = "$b"
  237. now_playing_prefix = "$b"
  238. #
  239. #now_playing_suffix = "$/b"
  240. now_playing_suffix = "$/b"
  241. #
  242. #browser_playlist_prefix = "$2playlist$9 "
  243. browser_playlist_prefix = "$2playlist$9 "
  244. #
  245. #selected_item_prefix = "$6"
  246. selected_item_prefix = "$6"
  247. #
  248. #selected_item_suffix = "$9"
  249. selected_item_suffix = "$9"
  250. #
  251. #modified_item_prefix = "$3> $9"
  252. #
  253. ## colors are not supported for below variable
  254. #
  255. #song_window_title_format = "{%a - }{%t}|{%f}"
  256. song_window_title_format = "{%A - }{%t}|{%f}"
  257. #
  258. ##### columns settings #####
  259. ##
  260. ## syntax of song columns list format is "column column etc."
  261. ##
  262. ## - syntax for each column is:
  263. ##
  264. ## (width of column)[column's color]{displayed tag}
  265. ##
  266. ## Note: Width is by default in %, if you want a column to
  267. ## have fixed size, add 'f' after the value, e.g. (10)[white]{a}
  268. ## will be the column that take 10% of screen (so the real column's
  269. ## width will depend on actual screen size), whereas (10f)[white]{a}
  270. ## will take 10 terminal cells, no matter how wide the screen is.
  271. ##
  272. ## - color is optional (if you want the default one, type [])
  273. ##
  274. ## Note: You can give a column additional attributes by putting appropriate
  275. ## character after displayed tag character. Available attributes are:
  276. ##
  277. ## - r - column will be right aligned
  278. ## - E - if tag is empty, empty tag marker won't be displayed
  279. ##
  280. ## You can also:
  281. ##
  282. ## - give a column custom name by putting it after attributes,
  283. ## separated with character ':', e.g. {lr:Length} gives you
  284. ## right aligned column of lengths named "Length".
  285. ##
  286. ## - define sequence of tags, that have to be displayed in case
  287. ## predecessor is empty in a way similar to the one in classic
  288. ## song format, i.e. using '|' character, e.g. {a|c|p:Owner}
  289. ## creates column named "Owner" that tries to display artist
  290. ## tag and then composer and performer if previous ones are
  291. ## not available.
  292. ##
  293. #
  294. #song_columns_list_format = "(7f)[green]{l} (25)[cyan]{a} (40)[]{t|f} (30)[red]{b}"
  295. #song_columns_list_format = "(3f)[blue]{nrE} (40)[cyan]{t|f} (15)[blue]{aE} (45)[cyan]{bE} (5f)[blue]{lr}"
  296. song_columns_list_format = "(3f)[white]{nrE} (40)[blue]{t|f} (15)[white]{aE} (45)[blue]{bE} (5f)[white]{lr}"
  297. #
  298. ##### various settings #####
  299. #
  300. ##
  301. ## Note: Custom command that will be executed each
  302. ## time song changes. Useful for notifications etc.
  303. ##
  304. ## Attention: It doesn't support song format anymore.
  305. ## Use `ncmpcpp --now-playing SONG_FORMAT` instead.
  306. ##
  307. #execute_on_song_change = ""
  308. #
  309. #
  310. #playlist_shorten_total_times = "no"
  311. playlist_shorten_total_times = "yes"
  312. #
  313. #playlist_separate_albums = "no"
  314. playlist_separate_albums = "no"
  315. #
  316. #playlist_display_mode = "classic" (classic/columns)
  317. playlist_display_mode = "columns"
  318. #
  319. #browser_display_mode = "classic" (classic/columns)
  320. browser_display_mode = "columns"
  321. #
  322. #search_engine_display_mode = "classic" (classic/columns)
  323. search_engine_display_mode = "columns"
  324. #
  325. #playlist_editor_display_mode = "classic" (classic/columns)
  326. playlist_editor_display_mode = "columns"
  327. #
  328. #discard_colors_if_item_is_selected = "yes"
  329. #
  330. #incremental_seeking = "yes"
  331. #
  332. #seek_time = "1"
  333. #
  334. #autocenter_mode = "no"
  335. #
  336. #centered_cursor = "no"
  337. #
  338. ##
  339. ## Note: You can specify third character which will
  340. ## be used to build 'empty' part of progressbar.
  341. ##
  342. #progressbar_look = "=>"
  343. #progressbar_look = "██░"
  344. #progressbar_look = "━╋━"
  345. #progressbar_look = "─┼─"
  346. progressbar_look = "❱❱❭"
  347. #
  348. progressbar_boldness = "no"
  349. #
  350. #default_place_to_search_in = "database" (database/playlist)
  351. #
  352. #user_interface = "classic" (classic/alternative)
  353. user_interface = "classic"
  354. #
  355. media_library_left_column = "A" (possible values: a,y,g,c,p, legend above)
  356. #
  357. #default_find_mode = "wrapped" (wrapped/normal)
  358. #
  359. #default_space_mode = "add" (add/select)
  360. #
  361. #default_tag_editor_pattern = "%n - %t"
  362. #
  363. #header_visibility = "yes"
  364. header_visibility = "yes"
  365. #
  366. #statusbar_visibility = "yes"
  367. statusbar_visibility = "no"
  368. #
  369. #titles_visibility = "yes"
  370. titles_visibility = "no"
  371. #
  372. #header_text_scrolling = "yes"
  373. #
  374. #fancy_scrolling = "yes"
  375. #
  376. #cyclic_scrolling = "no"
  377. cyclic_scrolling = "yes"
  378. #
  379. #lines_scrolled = "2"
  380. lines_scrolled = "2"
  381. #
  382. #follow_now_playing_lyrics = "no"
  383. #
  384. #fetch_lyrics_for_current_song_in_background = "no"
  385. #
  386. #store_lyrics_in_song_dir = "no"
  387. #
  388. #generate_win32_compatible_filenames = "yes"
  389. #
  390. ##
  391. ## Note: If you set this variable, ncmpcpp will try to
  392. ## get info from last.fm in language you set and if it
  393. ## fails, it will fall back to english. Otherwise it will
  394. ## use english the first time.
  395. ##
  396. ## Note: Language has to be expressed as an ISO 639 alpha-2 code.
  397. ##
  398. #lastfm_preferred_language = ""
  399. #
  400. #ncmpc_like_songs_adding = "no" (enabled - add/remove, disabled - always add)
  401. #
  402. #show_hidden_files_in_local_browser = "no"
  403. #
  404. #display_screens_numbers_on_start = "yes"
  405. #
  406. ##
  407. ## How shall key_screen_switcher work?
  408. ##
  409. ## - "previous" - switch between current and last used screen
  410. ## - "sequence: 2 -> 9 -> 5" - switch between given sequence of screens.
  411. ##
  412. ## Screen numbers you can use after 'sequence' keyword are:
  413. ##
  414. ## - 1 - help
  415. ## - 2 - playlist
  416. ## - 3 - browser
  417. ## - 4 - search engine
  418. ## - 5 - media library
  419. ## - 6 - playlist editor
  420. ## - 7 - tag editor
  421. ## - 8 - outputs
  422. ## - 9 - visualizer
  423. ## - 10 - clock
  424. ##
  425. ## As you can see, above example will switch between
  426. ## playlist, visualizer and media library screens.
  427. ##
  428. #screen_switcher_mode = "sequence: 2 -> 3"
  429. #
  430. ##
  431. ## Default width of locked screen (in %).
  432. ## Acceptable values are from 20 to 80.
  433. ##
  434. #
  435. #locked_screen_width_part = "50"
  436. locked_screen_width_part = "20"
  437. #
  438. #ask_for_locked_screen_width_part = "yes"
  439. ask_for_locked_screen_width_part = "no"
  440. #
  441. ##
  442. ## Note: You can define startup screen for ncmpcpp
  443. ## by choosing screen number from the list above.
  444. ##
  445. #startup_screen = "2"
  446. startup_screen = "2"
  447. #
  448. #jump_to_now_playing_song_at_start = "yes"
  449. #
  450. #ask_before_clearing_main_playlist = "no"
  451. #
  452. #clock_display_seconds = "no"
  453. clock_display_seconds = "yes"
  454. #
  455. display_volume_level = "yes"
  456. #
  457. #display_bitrate = "no"
  458. display_bitrate = "yes"
  459. #
  460. #display_remaining_time = "no"
  461. #
  462. #regular_expressions = "basic" (basic/extended)
  463. #
  464. ##
  465. ## Note: If below is enabled, ncmpcpp will ignore leading
  466. ## "The" word while sorting items in browser, tags in
  467. ## media library, etc.
  468. ##
  469. #ignore_leading_the = "no"
  470. #
  471. #block_search_constraints_change_if_items_found = "yes"
  472. #
  473. #mouse_support = "yes"
  474. mouse_support = "yes"
  475. #
  476. #mouse_list_scroll_whole_page = "yes"
  477. mouse_list_scroll_whole_page = "no"
  478. #
  479. #empty_tag_marker = "<empty>"
  480. empty_tag_marker = "***"
  481. #
  482. #tags_separator = " | "
  483. #
  484. #tag_editor_extended_numeration = "no"
  485. #
  486. #media_library_sort_by_mtime = "no"
  487. #
  488. #enable_window_title = "yes"
  489. #
  490. ##
  491. ## Note: You can choose default search mode for search
  492. ## engine. Available modes are:
  493. ##
  494. ## - 1 - use mpd built-in searching (no regexes, pattern matching)
  495. ## - 2 - use ncmpcpp searching (pattern matching with support for regexes,
  496. ## but if your mpd is on a remote machine, downloading big database
  497. ## to process it can take a while
  498. ## - 3 - match only exact values (this mode uses mpd function for searching
  499. ## in database and local one for searching in current playlist)
  500. ##
  501. #
  502. #search_engine_default_search_mode = "1"
  503. #
  504. #external_editor = ""
  505. #
  506. #use_console_editor = "no" (set to yes, if your editor is console app)
  507. #
  508. ##### colors definitions #####
  509. #
  510. #colors_enabled = "yes"
  511. colors_enabled = "yes"
  512. #
  513. #empty_tag_color = "cyan"
  514. empty_tag_color = "red"
  515. #
  516. #header_window_color = "default"
  517. header_window_color = "white"
  518. #
  519. #volume_color = "default"
  520. volume_color = "black"
  521. #
  522. #state_line_color = "default"
  523. state_line_color = "black"
  524. #
  525. #state_flags_color = "default"
  526. state_flags_color = "default"
  527. #
  528. #main_window_color = "yellow"
  529. main_window_color = "white"
  530. #
  531. #color1 = "white"
  532. color1 = "green"
  533. #
  534. #color2 = "green"
  535. color2 = "green"
  536. #
  537. #main_window_highlight_color = "yellow"
  538. main_window_highlight_color = "blue"
  539. #
  540. #progressbar_color = "default"
  541. progressbar_color = "black"
  542. #
  543. #progressbar_elapsed_color = "default"
  544. progressbar_elapsed_color = "blue"
  545. #
  546. #statusbar_color = "default"
  547. statusbar_color = "default"
  548. #
  549. #alternative_ui_separator_color = "black"
  550. alternative_ui_separator_color = "black"
  551. #
  552. #active_column_color = "red"
  553. active_column_color = "yellow"
  554. #
  555. #visualizer_color = "yellow"
  556. visualizer_color = "blue"
  557. #
  558. #window_border_color = "green"
  559. window_border_color = "green"
  560. #
  561. #active_window_border = "red"
  562. active_window_border = "red"
  563. #