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