############################################################## ## This is the example bindings file. Copy it to ## ## ~/.ncmpcpp/bindings or $XDG_CONFIG_HOME/ncmpcpp/bindings ## ## and set up your preferences ## ############################################################## ## ##### General rules ##### ## ## 1) Because each action has runtime checks whether it's ## ok to run it, a few actions can be bound to one key. ## Actions will be bound in order given in configuration ## file. When a key is pressed, first action in order ## will test itself whether it's possible to run it. If ## test succeeds, action is executed and other actions ## bound to this key are ignored. If it doesn't, next ## action in order tests itself etc. ## ## 2) It's possible to bind more that one action at once ## to a key. It can be done using the following syntax: ## ## def_key "key" ## action1 ## action2 ## ... ## ## This creates a chain of actions. When such chain is ## executed, each action in chain is run until the end of ## chain is reached or one of its actions fails to execute ## due to its requirements not being met. If multiple actions ## and/or chains are bound to the same key, they will be ## consecutively run until one of them gets fully executed. ## ## 3) When ncmpcpp starts, bindings configuration file is ## parsed and then ncmpcpp provides "missing pieces" ## of default keybindings. If you want to disable some ## bindings, there is a special action called 'dummy' ## for that purpose. Eg. if you want to disable ability ## to crop playlists, you need to put the following ## into configuration file: ## ## def_key "C" ## dummy ## ## After that ncmpcpp will not bind any default action ## to this key. ## ## 4) To let you write simple macros, the following special ## actions are provided: ## ## - push_character "character" - pushes given special ## character into input queue, so it will be immediately ## picked by ncmpcpp upon next call to readKey function. ## Accepted values: mouse, up, down, page_up, page_down, ## home, end, space, enter, insert, delete, left, right, ## tab, ctrl-a, ctrl-b, ..., ctrl-z, ctrl-[, ctrl-\\, ## ctrl-], ctrl-^, ctrl-_, f1, f2, ..., f12, backspace. ## In addition, most of these names can be prefixed with ## alt-/ctrl-/shift- to be recognized with the appropriate ## modifier key(s). ## ## - push_characters "string" - pushes given string into ## input queue. ## ## - require_runnable "action" - checks whether given action ## is runnable and fails if it isn't. This is especially ## useful when mixed with previous two functions. Consider ## the following macro definition: ## ## def_key "key" ## push_characters "custom_filter" ## apply_filter ## ## If apply_filter can't be currently run, we end up with ## sequence of characters in input queue which will be ## treated just as we typed them. This may lead to unexpected ## results (in this case 'c' will most likely clear current ## playlist, 'u' will trigger database update, 's' will stop ## playback etc.). To prevent such thing from happening, we ## need to change above definition to this one: ## ## def_key "key" ## require_runnable "apply_filter" ## push_characters "custom_filter" ## apply_filter ## ## Here, first we test whether apply_filter can be actually run ## before we stuff characters into input queue, so if condition ## is not met, whole chain is aborted and we're fine. ## ## - require_screen "screen" - checks whether given screen is ## currently active. accepted values: browser, clock, help, ## media_library, outputs, playlist, playlist_editor, ## search_engine, tag_editor, visualizer, last_fm, lyrics, ## selected_items_adder, server_info, song_info, ## sort_playlist_dialog, tiny_tag_editor. ## ## - run_external_command "command" - runs given command using ## system() function. ## ## 5) In addition to binding to a key, you can also bind actions ## or chains of actions to a command. If it comes to commands, ## syntax is very similar to defining keys. Here goes example ## definition of a command: ## ## def_command "quit" [deferred] ## stop ## quit ## ## If you execute the above command (which can be done by ## invoking action execute_command, typing 'quit' and pressing ## enter), ncmpcpp will stop the player and then quit. Note the ## presence of word 'deferred' enclosed in square brackets. It ## tells ncmpcpp to wait for confirmation (ie. pressing enter) ## after you typed quit. Instead of 'deferred', 'immediate' ## could be used. Then ncmpcpp will not wait for confirmation ## (enter) and will execute the command the moment it sees it. ## ## Note: while command chains are executed, internal environment ## update (which includes current window refresh and mpd status ## update) is not performed for performance reasons. However, it ## may be desirable to do so in some situration. Therefore it's ## possible to invoke by hand by performing 'update enviroment' ## action. ## ## Note: There is a difference between: ## ## def_key "key" ## action1 ## ## def_key "key" ## action2 ## ## and ## ## def_key "key" ## action1 ## action2 ## ## First one binds two single actions to the same key whilst ## second one defines a chain of actions. The behavior of ## these two is different and is described in (1) and (2). ## ## Note: Function def_key accepts non-ascii characters. ## ##### List of unbound actions ##### ## ## The following actions are not bound to any key/command: ## ## - set_volume ## # #def_key "mouse" # mouse_event # #def_key "up" # scroll_up # #def_key "shift-up" # select_item # scroll_up # #def_key "down" # scroll_down # #def_key "shift-down" # select_item # scroll_down # #def_key "[" # scroll_up_album # #def_key "]" # scroll_down_album # #def_key "{" # scroll_up_artist # #def_key "}" # scroll_down_artist # #def_key "page_up" # page_up # #def_key "page_down" # page_down # #def_key "home" # move_home # #def_key "end" # move_end # #def_key "insert" # select_item # #def_key "enter" # enter_directory # #def_key "enter" # toggle_output # #def_key "enter" # run_action # #def_key "enter" # play_item # #def_key "space" # add_item_to_playlist # #def_key "space" # toggle_lyrics_update_on_song_change # #def_key "space" # toggle_visualization_type # #def_key "delete" # delete_playlist_items # #def_key "delete" # delete_browser_items # #def_key "delete" # delete_stored_playlist # #def_key "right" # next_column # #def_key "right" # slave_screen # #def_key "right" # volume_up # #def_key "+" # volume_up # #def_key "left" # previous_column # #def_key "left" # master_screen # #def_key "left" # volume_down # #def_key "-" # volume_down # #def_key ":" # execute_command # #def_key "tab" # next_screen # #def_key "shift-tab" # previous_screen # #def_key "f1" # show_help # #def_key "1" # show_playlist # #def_key "2" # show_browser # #def_key "2" # change_browse_mode # #def_key "3" # show_search_engine # #def_key "3" # reset_search_engine # #def_key "4" # show_media_library # #def_key "4" # toggle_media_library_columns_mode # #def_key "5" # show_playlist_editor # #def_key "6" # show_tag_editor # #def_key "7" # show_outputs # #def_key "8" # show_visualizer # #def_key "=" # show_clock # #def_key "@" # show_server_info # #def_key "s" # stop # #def_key "p" # pause # #def_key ">" # next # #def_key "<" # previous # #def_key "ctrl-h" # jump_to_parent_directory # #def_key "ctrl-h" # replay_song # #def_key "backspace" # jump_to_parent_directory # #def_key "backspace" # replay_song # #def_key "f" # seek_forward # #def_key "b" # seek_backward # #def_key "r" # toggle_repeat # #def_key "z" # toggle_random # #def_key "y" # save_tag_changes # #def_key "y" # start_searching # #def_key "y" # toggle_single # #def_key "R" # toggle_consume # #def_key "Y" # toggle_replay_gain_mode # #def_key "T" # toggle_add_mode # #def_key "|" # toggle_mouse # #def_key "#" # toggle_bitrate_visibility # #def_key "Z" # shuffle # #def_key "x" # toggle_crossfade # #def_key "X" # set_crossfade # #def_key "u" # update_database # #def_key "ctrl-s" # sort_playlist # #def_key "ctrl-s" # toggle_browser_sort_mode # #def_key "ctrl-s" # toggle_media_library_sort_mode # #def_key "ctrl-r" # reverse_playlist # #def_key "ctrl-f" # apply_filter # #def_key "ctrl-_" # select_found_items # #def_key "/" # find # #def_key "/" # find_item_forward # #def_key "?" # find # #def_key "?" # find_item_backward # #def_key "." # next_found_item # #def_key "," # previous_found_item # #def_key "w" # toggle_find_mode # #def_key "e" # edit_song # #def_key "e" # edit_library_tag # #def_key "e" # edit_library_album # #def_key "e" # edit_directory_name # #def_key "e" # edit_playlist_name # #def_key "e" # edit_lyrics # #def_key "i" # show_song_info # #def_key "I" # show_artist_info # #def_key "g" # jump_to_position_in_song # #def_key "l" # show_lyrics # #def_key "ctrl-v" # select_range # #def_key "v" # reverse_selection # #def_key "V" # remove_selection # #def_key "B" # select_album # #def_key "a" # add_selected_items # #def_key "c" # clear_playlist # #def_key "c" # clear_main_playlist # #def_key "C" # crop_playlist # #def_key "C" # crop_main_playlist # #def_key "m" # move_sort_order_up # #def_key "m" # move_selected_items_up # #def_key "n" # move_sort_order_down # #def_key "n" # move_selected_items_down # #def_key "M" # move_selected_items_to # #def_key "A" # add # #def_key "S" # save_playlist # #def_key "o" # jump_to_playing_song # #def_key "G" # jump_to_browser # #def_key "G" # jump_to_playlist_editor # #def_key "~" # jump_to_media_library # #def_key "E" # jump_to_tag_editor # #def_key "U" # toggle_playing_song_centering # #def_key "P" # toggle_display_mode # #def_key "\\" # toggle_interface # #def_key "!" # toggle_separators_between_albums # #def_key "L" # toggle_lyrics_fetcher # #def_key "F" # fetch_lyrics_in_background # #def_key "alt-l" # toggle_fetching_lyrics_in_background # #def_key "ctrl-l" # toggle_screen_lock # #def_key "`" # toggle_library_tag_type # #def_key "`" # refetch_lyrics # #def_key "`" # add_random_items # #def_key "ctrl-p" # set_selected_items_priority # #def_key "q" # quit # # #def_key "f" # find #def_key "f" # find_item_forward def_key "+" show_clock def_key "=" volume_up def_key "j" scroll_down def_key "k" scroll_up def_key "ctrl-u" page_up #push_characters "kkkkkkkkkkkkkkk" def_key "ctrl-d" page_down #push_characters "jjjjjjjjjjjjjjj" def_key "u" page_up #push_characters "kkkkkkkkkkkkkkk" def_key "d" page_down #push_characters "jjjjjjjjjjjjjjj" def_key "h" previous_column def_key "l" next_column def_key "." show_lyrics def_key "n" next_found_item def_key "N" previous_found_item # not used but bound def_key "space" select_item def_key "J" select_item move_selected_items_down def_key "K" select_item move_selected_items_up def_key "h" jump_to_parent_directory def_key "l" enter_directory def_key "l" run_action def_key "l" play_item def_key "m" show_media_library def_key "m" toggle_media_library_columns_mode def_key "t" show_tag_editor def_key "v" show_visualizer def_key "G" move_end def_key "g" move_home #jump_to_position_in_song def_key "U" update_database def_key "s" reset_search_engine def_key "s" show_search_engine def_key "f" show_browser def_key "f" change_browse_mode def_key "x" delete_playlist_items def_key "X" delete_browser_items def_key "P" show_playlist