You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

617 lines
17 KiB

2 years ago
  1. ##############################################################
  2. ## This is an example configuration file. Copy it to ##
  3. ## $XDG_CONFIG_HOME/ncmpcpp/config or $HOME/.ncmpcpp/config ##
  4. ## and set up your preferences. ##
  5. ##############################################################
  6. #
  7. ##### directories ######
  8. ##
  9. ## Directory for storing ncmpcpp related files. Changing it is useful if you
  10. ## want to store everything somewhere else and provide command line setting for
  11. ## alternative location to config file which defines that while launching
  12. ## ncmpcpp.
  13. ##
  14. #
  15. ncmpcpp_directory = ~/.config/ncmpcpp
  16. #
  17. ##
  18. ## Directory for storing downloaded lyrics. It defaults to ~/.lyrics since other
  19. ## MPD clients (eg. ncmpc) also use that location.
  20. ##
  21. #
  22. #lyrics_directory = ~/.lyrics
  23. #
  24. ##### connection settings #####
  25. #
  26. #mpd_host = localhost
  27. #
  28. #mpd_port = 6600
  29. #
  30. #mpd_password = ""
  31. #
  32. #mpd_connection_timeout = 5
  33. #
  34. ## Needed for tag editor and file operations to work.
  35. ##
  36. mpd_music_dir = ~/Music
  37. #
  38. #mpd_crossfade_time = 5
  39. #
  40. # Exclude pattern for random song action
  41. # http://www.boost.org/doc/libs/1_46_1/libs/regex/doc/html/boost_regex/syntax/perl_syntax.html
  42. #random_exclude_pattern = "^(temp|midi_songs).*"
  43. #
  44. ##### music visualizer #####
  45. ##
  46. ## In order to make music visualizer work with MPD you need to use the fifo
  47. ## output. Its format parameter has to be set to 44100:16:1 for mono
  48. ## visualization or 44100:16:2 for stereo visualization. As an example here is
  49. ## the relevant section for mpd.conf:
  50. ##
  51. ## audio_output {
  52. ## type "fifo"
  53. ## name "Visualizer feed"
  54. ## path "/tmp/mpd.fifo"
  55. ## format "44100:16:2"
  56. ## }
  57. ##
  58. ## If the visualization on occasion diverges from the audio output, please set
  59. ## 'buffer_time' parameter of your audio output in mpd.conf to '100000' (100ms)
  60. ## or less to prevent that from happening.
  61. ##
  62. ## Note: If you're using Mopidy, an address of a udpsink gstreamer's output is
  63. ## also accepted. For example, the following section in mopidy.conf:
  64. ##
  65. ## [audio]
  66. ## output = tee name=t ! queue ! autoaudiosink t.
  67. ## ! queue ! audio/x-raw,rate=44100,channels=2,format=S16LE
  68. ## ! udpsink host=localhost port=5555
  69. ##
  70. ## will make localhost:5555 available as a source of data for the stereo
  71. ## visualizer.
  72. ##
  73. #
  74. visualizer_data_source = /tmp/mpd.fifo
  75. #
  76. ##
  77. ## Note: Below parameter is needed for ncmpcpp to determine which output
  78. ## provides data for visualizer and reset it at the beginning of visualization
  79. ## to synchronize with audio.
  80. ##
  81. #
  82. visualizer_output_name = Visualizer feed
  83. #
  84. ##
  85. ## If you set format to 44100:16:2, make it 'yes'.
  86. ##
  87. #visualizer_in_stereo = yes
  88. #
  89. ##
  90. ## Note: set below to >=10 only if you have synchronization issues with
  91. ## visualization and audio.
  92. ##
  93. #
  94. #visualizer_sync_interval = 0
  95. #
  96. ##
  97. ## Note: To enable spectrum frequency visualization you need to compile ncmpcpp
  98. ## with fftw3 support.
  99. ##
  100. #
  101. ## Available values: spectrum, wave, wave_filled, ellipse.
  102. ##
  103. #visualizer_type = spectrum
  104. #
  105. #visualizer_fps = 60
  106. #
  107. #visualizer_autoscale = no
  108. #
  109. #visualizer_look = ●▮
  110. #
  111. #visualizer_color = blue, cyan, green, yellow, magenta, red
  112. #
  113. ## Alternative subset of 256 colors for terminals that support it.
  114. ##
  115. #visualizer_color = 47, 83, 119, 155, 191, 227, 221, 215, 209, 203, 197, 161
  116. #
  117. ##
  118. ## Note: The next few visualization options apply to the spectrum visualizer.
  119. ##
  120. #
  121. ## Use unicode block characters for a smoother, more continuous look.
  122. ## This will override the visualizer_look option. With transparent terminals
  123. ## and visualizer_in_stereo set, artifacts may be visible on the bottom half of
  124. ## the visualization.
  125. #
  126. #visualizer_spectrum_smooth_look = yes
  127. #
  128. ## A value between 1 and 5 inclusive. Specifying a larger value makes the
  129. ## visualizer look at a larger slice of time, which results in less jumpy
  130. ## visualizer output.
  131. #
  132. #visualizer_spectrum_dft_size = 2
  133. #
  134. #visualizer_spectrum_gain = 10
  135. #
  136. ## Left-most frequency of visualizer in Hz, must be less than HZ MAX
  137. #
  138. #visualizer_spectrum_hz_min = 20
  139. #
  140. ## Right-most frequency of visualizer in Hz, must be greater than HZ MIN
  141. #
  142. #visualizer_spectrum_hz_max = 20000
  143. #
  144. ##### system encoding #####
  145. ##
  146. ## ncmpcpp should detect your charset encoding but if it failed to do so, you
  147. ## can specify charset encoding you are using here.
  148. ##
  149. ## Note: You can see whether your ncmpcpp build supports charset detection by
  150. ## checking output of `ncmpcpp --version`.
  151. ##
  152. ## Note: Since MPD uses UTF-8 by default, setting this option makes sense only
  153. ## if your encoding is different.
  154. ##
  155. #
  156. #system_encoding = ""
  157. #
  158. ##### delays #####
  159. #
  160. ## Time of inactivity (in seconds) after playlist highlighting will be disabled
  161. ## (0 = always on).
  162. ##
  163. #playlist_disable_highlight_delay = 5
  164. #
  165. ## Defines how long messages are supposed to be visible.
  166. ##
  167. #message_delay_time = 5
  168. #
  169. ##### song format #####
  170. ##
  171. ## For a song format you can use:
  172. ##
  173. ## %l - length
  174. ## %f - filename
  175. ## %D - directory
  176. ## %a - artist
  177. ## %A - album artist
  178. ## %t - title
  179. ## %b - album
  180. ## %y - date
  181. ## %n - track number (01/12 -> 01)
  182. ## %N - full track info (01/12 -> 01/12)
  183. ## %g - genre
  184. ## %c - composer
  185. ## %p - performer
  186. ## %d - disc
  187. ## %C - comment
  188. ## %P - priority
  189. ## $R - begin right alignment
  190. ##
  191. ## If you want to make sure that a part of the format is displayed only when
  192. ## certain tags are present, you can archieve it by grouping them with brackets,
  193. ## e.g. '{%a - %t}' will be evaluated to 'ARTIST - TITLE' if both tags are
  194. ## present or '' otherwise. It is also possible to define a list of
  195. ## alternatives by providing several groups and separating them with '|',
  196. ## e.g. '{%t}|{%f}' will be evaluated to 'TITLE' or 'FILENAME' if the former is
  197. ## not present.
  198. ##
  199. ## Note: If you want to set limit on maximal length of a tag, just put the
  200. ## appropriate number between % and character that defines tag type, e.g. to
  201. ## make album take max. 20 terminal cells, use '%20b'.
  202. ##
  203. ## In addition, formats support markers used for text attributes. They are
  204. ## followed by character '$'. After that you can put:
  205. ##
  206. ## - 0 - default window color (discards all other colors)
  207. ## - 1 - black
  208. ## - 2 - red
  209. ## - 3 - green
  210. ## - 4 - yellow
  211. ## - 5 - blue
  212. ## - 6 - magenta
  213. ## - 7 - cyan
  214. ## - 8 - white
  215. ## - 9 - end of current color
  216. ## - b - bold text
  217. ## - u - underline text
  218. ## - i - italic text
  219. ## - r - reverse colors
  220. ## - a - use alternative character set
  221. ##
  222. ## If you don't want to use a non-color attribute anymore, just put it again,
  223. ## but this time insert character '/' between '$' and attribute character,
  224. ## e.g. {$b%t$/b}|{$r%f$/r} will display bolded title tag or filename with
  225. ## reversed colors.
  226. ##
  227. ## If you want to use 256 colors and/or background colors in formats (the naming
  228. ## scheme is described below in section about color definitions), it can be done
  229. ## with the syntax $(COLOR), e.g. to set the artist tag to one of the
  230. ## non-standard colors and make it have yellow background, you need to write
  231. ## $(197_yellow)%a$(end). Note that for standard colors this is interchangable
  232. ## with attributes listed above.
  233. ##
  234. ## Note: colors can be nested.
  235. ##
  236. #
  237. #song_list_format = {%a - }{%t}|{$8%f$9}$R{$3%l$9}
  238. #
  239. #song_status_format = {{%a{ "%b"{ (%y)}} - }{%t}}|{%f}
  240. #
  241. #song_library_format = {%n - }{%t}|{%f}
  242. #
  243. #alternative_header_first_line_format = $b$1$aqqu$/a$9 {%t}|{%f} $1$atqq$/a$9$/b
  244. #
  245. #alternative_header_second_line_format = {{$4$b%a$/b$9}{ - $7%b$9}{ ($4%y$9)}}|{%D}
  246. #
  247. #current_item_prefix = $(yellow)$r
  248. #
  249. #current_item_suffix = $/r$(end)
  250. #
  251. #current_item_inactive_column_prefix = $(white)$r
  252. #
  253. #current_item_inactive_column_suffix = $/r$(end)
  254. #
  255. #now_playing_prefix = $b
  256. #
  257. #now_playing_suffix = $/b
  258. #
  259. #browser_playlist_prefix = "$2playlist$9 "
  260. #
  261. #selected_item_prefix = $6
  262. #
  263. #selected_item_suffix = $9
  264. #
  265. #modified_item_prefix = $3> $9
  266. #
  267. ##
  268. ## Note: attributes are not supported for the following variables.
  269. ##
  270. #song_window_title_format = {%a - }{%t}|{%f}
  271. ##
  272. ## Note: Below variables are used for sorting songs in browser. The sort mode
  273. ## determines how songs are sorted, and can be used in combination with a sort
  274. ## format to specify a custom sorting format. Available values for
  275. ## browser_sort_mode are "type", "name", "mtime", "format" and "none".
  276. ##
  277. #
  278. #browser_sort_mode = type
  279. #
  280. #browser_sort_format = {%a - }{%t}|{%f} {%l}
  281. #
  282. ##### columns settings #####
  283. ##
  284. ## syntax of song columns list format is "column column etc."
  285. ##
  286. ## - syntax for each column is:
  287. ##
  288. ## (width of the column)[color of the column]{displayed tag}
  289. ##
  290. ## Note: Width is by default in %, if you want a column to have fixed size, add
  291. ## 'f' after the value, e.g. (10)[white]{a} will be the column that take 10% of
  292. ## screen (so the real width will depend on actual screen size), whereas
  293. ## (10f)[white]{a} will take 10 terminal cells, no matter how wide the screen
  294. ## is.
  295. ##
  296. ## - color is optional (if you want the default one, leave the field empty).
  297. ##
  298. ## Note: You can give a column additional attributes by putting appropriate
  299. ## character after displayed tag character. Available attributes are:
  300. ##
  301. ## - r - column will be right aligned
  302. ## - E - if tag is empty, empty tag marker won't be displayed
  303. ##
  304. ## You can also:
  305. ##
  306. ## - give a column custom name by putting it after attributes, separated with
  307. ## character ':', e.g. {lr:Length} gives you right aligned column of lengths
  308. ## named "Length".
  309. ##
  310. ## - define sequence of tags, that have to be displayed in case predecessor is
  311. ## empty in a way similar to the one in classic song format, i.e. using '|'
  312. ## character, e.g. {a|c|p:Owner} creates column named "Owner" that tries to
  313. ## display artist tag and then composer and performer if previous ones are not
  314. ## available.
  315. ##
  316. #
  317. #song_columns_list_format = (20)[]{a} (6f)[green]{NE} (50)[white]{t|f:Title} (20)[cyan]{b} (7f)[magenta]{l}
  318. #
  319. ##### various settings #####
  320. #
  321. ##
  322. ## Note: Custom command that will be executed each time song changes. Useful for
  323. ## notifications etc.
  324. ##
  325. #execute_on_song_change = ""
  326. #
  327. ##
  328. ## Note: Custom command that will be executed each time player state
  329. ## changes. The environment variable MPD_PLAYER_STATE is set to the current
  330. ## state (either unknown, play, pause, or stop) for its duration.
  331. ##
  332. #
  333. #execute_on_player_state_change = ""
  334. #
  335. #playlist_show_mpd_host = no
  336. #
  337. #playlist_show_remaining_time = no
  338. #
  339. #playlist_shorten_total_times = no
  340. #
  341. #playlist_separate_albums = no
  342. #
  343. ##
  344. ## Note: Possible display modes: classic, columns.
  345. ##
  346. #playlist_display_mode = columns
  347. #
  348. #browser_display_mode = classic
  349. #
  350. #search_engine_display_mode = classic
  351. #
  352. #playlist_editor_display_mode = classic
  353. #
  354. #discard_colors_if_item_is_selected = yes
  355. #
  356. #show_duplicate_tags = yes
  357. #
  358. #incremental_seeking = yes
  359. #
  360. #seek_time = 1
  361. #
  362. #volume_change_step = 2
  363. #
  364. #autocenter_mode = no
  365. #
  366. #centered_cursor = no
  367. #
  368. ##
  369. ## Note: You can specify third character which will be used to build 'empty'
  370. ## part of progressbar.
  371. ##
  372. #progressbar_look = =>
  373. #
  374. ## Available values: database, playlist.
  375. ##
  376. #default_place_to_search_in = database
  377. #
  378. ## Available values: classic, alternative.
  379. ##
  380. #user_interface = classic
  381. #
  382. #data_fetching_delay = yes
  383. #
  384. ## Available values: artist, album_artist, date, genre, composer, performer.
  385. ##
  386. #media_library_primary_tag = artist
  387. #
  388. #media_library_albums_split_by_date = yes
  389. #
  390. #media_library_hide_album_dates = no
  391. #
  392. ## Available values: wrapped, normal.
  393. ##
  394. #default_find_mode = wrapped
  395. #
  396. #default_tag_editor_pattern = %n - %t
  397. #
  398. #header_visibility = yes
  399. #
  400. #statusbar_visibility = yes
  401. #
  402. ## Show the "Connected to ..." message on startup
  403. #connected_message_on_startup = yes
  404. #
  405. #titles_visibility = yes
  406. #
  407. #header_text_scrolling = yes
  408. #
  409. #cyclic_scrolling = no
  410. #
  411. #lyrics_fetchers = azlyrics, genius, musixmatch, sing365, metrolyrics, justsomelyrics, jahlyrics, plyrics, tekstowo, zeneszoveg, internet
  412. #
  413. #follow_now_playing_lyrics = no
  414. #
  415. #fetch_lyrics_for_current_song_in_background = no
  416. #
  417. #store_lyrics_in_song_dir = no
  418. #
  419. #generate_win32_compatible_filenames = yes
  420. #
  421. #allow_for_physical_item_deletion = no
  422. #
  423. ##
  424. ## Note: If you set this variable, ncmpcpp will try to get info from last.fm in
  425. ## language you set and if it fails, it will fall back to english. Otherwise it
  426. ## will use english the first time.
  427. ##
  428. ## Note: Language has to be expressed as an ISO 639 alpha-2 code.
  429. ##
  430. #lastfm_preferred_language = en
  431. #
  432. #space_add_mode = add_remove
  433. #
  434. #show_hidden_files_in_local_browser = no
  435. #
  436. ##
  437. ## How shall screen switcher work?
  438. ##
  439. ## - "previous" - switch between the current and previous screen.
  440. ## - "screen1,...,screenN" - switch between given sequence of screens.
  441. ##
  442. ## Screens available for use: help, playlist, browser, search_engine,
  443. ## media_library, playlist_editor, tag_editor, outputs, visualizer, clock,
  444. ## lyrics, last_fm.
  445. ##
  446. #screen_switcher_mode = playlist, browser
  447. #
  448. ##
  449. ## Note: You can define startup screen by choosing screen from the list above.
  450. ##
  451. #startup_screen = playlist
  452. #
  453. ##
  454. ## Note: You can define startup slave screen by choosing screen from the list
  455. ## above or an empty value for no slave screen.
  456. ##
  457. #startup_slave_screen = ""
  458. #
  459. #startup_slave_screen_focus = no
  460. #
  461. ##
  462. ## Default width of locked screen (in %). Acceptable values are from 20 to 80.
  463. ##
  464. #
  465. #locked_screen_width_part = 50
  466. #
  467. #ask_for_locked_screen_width_part = yes
  468. #
  469. ##
  470. ## Width of media_library screen columns
  471. ##
  472. #
  473. #media_library_column_width_ratio_two = 1:1
  474. #
  475. #media_library_column_width_ratio_three = 1:1:1
  476. #
  477. ##
  478. ## Width of playlist_editor screen columns
  479. ##
  480. #
  481. #playlist_editor_column_width_ratio = 1:2
  482. #
  483. #jump_to_now_playing_song_at_start = yes
  484. #
  485. #ask_before_clearing_playlists = yes
  486. #
  487. #clock_display_seconds = no
  488. #
  489. #display_volume_level = yes
  490. #
  491. #display_bitrate = no
  492. #
  493. #display_remaining_time = no
  494. #
  495. ## Available values: none, basic, extended, perl.
  496. ##
  497. #regular_expressions = perl
  498. #
  499. ##
  500. ## Note: if below is enabled, ncmpcpp will ignore leading "The" word while
  501. ## sorting items in browser, tags in media library, etc.
  502. ##
  503. #ignore_leading_the = no
  504. #
  505. ##
  506. ## Note: if below is enabled, ncmpcpp will ignore diacritics while searching and
  507. ## filtering lists. This takes an effect only if boost was compiled with ICU
  508. ## support.
  509. ##
  510. #ignore_diacritics = no
  511. #
  512. #block_search_constraints_change_if_items_found = yes
  513. #
  514. #mouse_support = yes
  515. #
  516. #mouse_list_scroll_whole_page = no
  517. #
  518. #lines_scrolled = 5
  519. #
  520. #empty_tag_marker = <empty>
  521. #
  522. #tags_separator = " | "
  523. #
  524. #tag_editor_extended_numeration = no
  525. #
  526. #media_library_sort_by_mtime = no
  527. #
  528. #enable_window_title = yes
  529. #
  530. ##
  531. ## Note: You can choose default search mode for search engine. Available modes
  532. ## are:
  533. ##
  534. ## - 1 - use mpd built-in searching (no regexes, pattern matching)
  535. ##
  536. ## - 2 - use ncmpcpp searching (pattern matching with support for regexes, but
  537. ## if your mpd is on a remote machine, downloading big database to process
  538. ## it can take a while
  539. ##
  540. ## - 3 - match only exact values (this mode uses mpd function for searching in
  541. ## database and local one for searching in current playlist)
  542. ##
  543. #
  544. #search_engine_default_search_mode = 1
  545. #
  546. #external_editor = nano
  547. #
  548. ## Note: set to yes if external editor is a console application.
  549. ##
  550. #use_console_editor = yes
  551. #
  552. ##### colors definitions #####
  553. ##
  554. ## It is possible to set a background color by setting a color value
  555. ## "<foreground>_<background>", e.g. red_black will set foregound color to red
  556. ## and background color to black.
  557. ##
  558. ## In addition, for terminals that support 256 colors it is possible to set one
  559. ## of them by using a number in range [1, 256] instead of color name,
  560. ## e.g. numerical value corresponding to red_black is 2_1. To find out if the
  561. ## terminal supports 256 colors, run ncmpcpp and check out the bottom of the
  562. ## help screen for list of available colors and their numerical values.
  563. ##
  564. ## What is more, there are two special values for the background color:
  565. ## "transparent" and "current". The first one explicitly sets the background to
  566. ## be transparent, while the second one allows you to preserve current
  567. ## background color and change only the foreground one. It's used implicitly
  568. ## when background color is not specified.
  569. ##
  570. ## Moreover, it is possible to attach format information to selected color
  571. ## variables by appending to their end a colon followed by one or more format
  572. ## flags, e.g. black:b or red:ur. The following variables support this syntax:
  573. ## visualizer_color, color1, color2, empty_tag_color, volume_color,
  574. ## state_line_color, state_flags_color, progressbar_color,
  575. ## progressbar_elapsed_color, player_state_color, statusbar_time_color,
  576. ## alternative_ui_separator_color.
  577. ##
  578. ## Note: due to technical limitations of older ncurses version, if 256 colors
  579. ## are used there is a possibility that you'll be able to use only colors with
  580. ## transparent background.
  581. #
  582. #colors_enabled = yes
  583. #
  584. #empty_tag_color = cyan
  585. #
  586. #header_window_color = default
  587. #
  588. #volume_color = default
  589. #
  590. #state_line_color = default
  591. #
  592. #state_flags_color = default:b
  593. #
  594. #main_window_color = yellow
  595. #
  596. #color1 = white
  597. #
  598. #color2 = green
  599. #
  600. #progressbar_color = black:b
  601. #
  602. #progressbar_elapsed_color = green:b
  603. #
  604. #statusbar_color = default
  605. #
  606. #statusbar_time_color = default:b
  607. #
  608. #player_state_color = default:b
  609. #
  610. #alternative_ui_separator_color = black:b
  611. #
  612. #window_border_color = green
  613. #
  614. #active_window_border = red
  615. #