# Copyright (C) 2009, 2010 Roman Zimbelmann # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see . """ This is the default key configuration file of ranger. Syntax for binding keys: map(*keys, fnc) keys are one or more key-combinations which are either: * a string * an integer which represents an ascii code * a tuple of integers fnc is a function which is called with the CommandArgument object. The CommandArgument object has these attributes: arg.fm: the file manager instance arg.wdg: the widget or ui instance arg.n: the number typed before the key combination (if allowed) arg.keys: the string representation of the used key combination arg.keybuffer: the keybuffer instance Check ranger.keyapi for more information """ # NOTE: The "map" object used below is a callable CommandList # object and NOT the builtin python map function! from ranger.api.keys import * def _vimlike_aliases(map): alias = map.alias # the key 'k' will always do the same as KEY_UP, etc. alias(KEY_UP, 'k') alias(KEY_DOWN, 'j') alias(KEY_LEFT, 'h') alias(KEY_RIGHT, 'l') alias(KEY_NPAGE, ctrl('f')) alias(KEY_PPAGE, ctrl('b')) alias(KEY_HOME, 'gg') alias(KEY_END, 'G') def initialize_commands(map): """Initialize the commands for the main user interface""" # -------------------------------------------------------- movement _vimlike_aliases(map) map.alias(KEY_LEFT, KEY_BACKSPACE, DEL) map(KEY_DOWN, fm.move_pointer(relative=1)) map(KEY_UP, fm.move_pointer(relative=-1)) map(KEY_RIGHT, KEY_ENTER, ctrl('j'), fm.move_right()) map(KEY_LEFT, KEY_BACKSPACE, DEL, fm.move_left(1)) map(KEY_HOME, fm.move_pointer(absolute=0)) map(KEY_END, fm.move_pointer(absolute=-1)) map(KEY_HOME, fm.move_pointer(absolute=0)) map(KEY_END, fm.move_pointer(absolute=-1)) map('%', fm.move_pointer_by_percentage(absolute=50)) map(KEY_NPAGE, fm.move_pointer_by_pages(1)) map(KEY_PPAGE, fm.move_pointer_by_pages(-1)) map(ctrl('d'), fm.move_pointer_by_pages(0.5)) map(ctrl('u'), fm.move_pointer_by_pages(-0.5)) map(']', fm.traverse()) map('[', fm.history_go(-1)) # --------------------------------------------------------- history map('H', fm.history_go(-1)) map('L', fm.history_go(1)) # ----------------------------------------------- tagging / marking map('t', fm.tag_toggle()) map('T', fm.tag_remove()) map(' ', fm.mark(toggle=True)) map('v', fm.mark(all=True, toggle=True)) map('V', fm.mark(all=True, val=False)) # ------------------------------------------ file system operations map('yy', fm.copy()) map('dd', fm.cut()) map('pp', fm.paste()) map('po', fm.paste(overwrite=True)) map('pl', fm.paste_symlink()) map('p', hint='press //p// once again to confirm pasting' \ ', or //l// to create symlinks') # ---------------------------------------------------- run programs map('s', fm.execute_command(os.environ['SHELL'])) map('E', fm.edit_file()) map(',term', fm.execute_command('x-terminal-emulator', flags='d')) map('du', fm.execute_command('du --max-depth=1 -h | less')) # -------------------------------------------------- toggle options map('b', hint="bind_//h//idden //p//review_files //d//irectories_first " \ "//c//ollapse_preview flush//i//nput") map('bh', fm.toggle_boolean_option('show_hidden')) map('bp', fm.toggle_boolean_option('preview_files')) map('bi', fm.toggle_boolean_option('flushinput')) map('bd', fm.toggle_boolean_option('directories_first')) map('bc', fm.toggle_boolean_option('collapse_preview')) # ------------------------------------------------------------ sort map('o', 'O', hint="//s//ize //b//ase//n//ame //m//time //t//ype //r//everse") sort_dict = { 's': 'size', 'b': 'basename', 'n': 'basename', 'm': 'mtime', 't': 'type', } for key, val in sort_dict.items(): for key, is_capital in ((key, False), (key.upper(), True)): # reverse if any of the two letters is capital map('o' + key, fm.sort(func=val, reverse=is_capital)) map('O' + key, fm.sort(func=val, reverse=True)) map('or', 'Or', 'oR', 'OR', lambda arg: \ arg.fm.sort(reverse=not arg.fm.settings.reverse)) # ----------------------------------------------- console shortcuts @map("A") def append_to_filename(arg): command = 'rename ' + arg.fm.env.cf.basename arg.fm.open_console(cmode.COMMAND, command) map('cw', fm.open_console(cmode.COMMAND, 'rename ')) map('cd', fm.open_console(cmode.COMMAND, 'cd ')) map('f', fm.open_console(cmode.COMMAND_QUICK, 'find ')) map('tf', fm.open_console(cmode.COMMAND, 'filter ')) map('d', hint='d//u// (disk usage) d//d// (cut)') # --------------------------------------------- jump to directories map('gh', fm.cd('~')) map('ge', fm.cd('/etc')) map('gu', fm.cd('/usr')) map('gd', fm.cd('/dev')) map('gl', fm.cd('/lib')) map('go', fm.cd('/opt')) map('gv', fm.cd('/var')) map('gr', 'g/', fm.cd('/')) map('gm', fm.cd('/media')) map('gn', fm.cd('/mnt')) map('gt', fm.cd('/tmp')) map('gs', fm.cd('/srv')) map('gR', fm.cd(RANGERDIR)) # ------------------------------------------------------- searching map('/', fm.open_console(cmode.SEARCH)) map('n', fm.search()) map('N', fm.search(forward=False)) map(TAB, fm.search(order='tag')) map('cc', fm.search(order='ctime')) map('cm', fm.search(order='mimetype')) map('cs', fm.search(order='size')) map('c', hint='//c//time //m//imetype //s//ize') # ------------------------------------------------------- bookmarks for key in ALLOWED_BOOKMARK_KEYS: map("`" + key, "'" + key, fm.enter_bookmark(key)) map("m" + key, fm.set_bookmark(key)) map("um" + key, fm.unset_bookmark(key)) map("`", "'", "m", draw_bookmarks=True) # ---------------------------------------------------- change views map('i', fm.display_file()) map(ctrl('p'), fm.display_log()) map('?', KEY_F1, fm.display_help()) map('w', lambda arg: arg.fm.ui.open_taskview()) # ------------------------------------------------ system functions _system_functions(map) map('ZZ', fm.exit()) map(ctrl('R'), fm.reset()) map('R', fm.reload_cwd()) map(ctrl('C'), fm.exit()) map(':', ';', fm.open_console(cmode.COMMAND)) map('>', fm.open_console(cmode.COMMAND_QUICK)) map('!', fm.open_console(cmode.OPEN)) map('r', fm.open_console(cmode.OPEN_QUICK)) map.rebuild_paths() def initialize_console_commands(map): """Initialize the commands for the console widget only""" # -------------------------------------------------------- movement map(KEY_UP, wdg.history_move(-1)) map(KEY_DOWN, wdg.history_move(1)) map(ctrl('b'), KEY_LEFT, wdg.move(relative = -1)) map(ctrl('f'), KEY_RIGHT, wdg.move(relative = 1)) map(ctrl('a'), KEY_HOME, wdg.move(absolute = 0)) map(ctrl('e'), KEY_END, wdg.move(absolute = -1)) # ----------------------------------------- deleting / pasting text map(ctrl('d'), KEY_DC, wdg.delete(0)) map(ctrl('h'), KEY_BACKSPACE, DEL, wdg.delete(-1)) map(ctrl('w'), wdg.delete_word()) map(ctrl('k'), wdg.delete_rest(1)) map(ctrl('u'), wdg.delete_rest(-1)) map(ctrl('y'), wdg.paste()) # ----------------------------------------------------- typing keys def type_key(arg): arg.wdg.type_key(arg.keys) for i in range(ord(' '), ord('~')+1): map(i, type_key) # ------------------------------------------------ system functions _system_functions(map) map(KEY_F1, lambda arg: arg.fm.display_command_help(arg.wdg)) map(ctrl('c'), ESC, wdg.close()) map(ctrl('j'), KEY_ENTER, wdg.execute()) map(TAB, wdg.tab()) map(KEY_BTAB, wdg.tab(-1)) map.rebuild_paths() def initialize_taskview_commands(map): """Initialize the commands for the TaskView widget""" _basic_movement(map) _vimlike_aliases(map) _system_functions(map) # -------------------------------------------------- (re)move tasks map('K', wdg.task_move(0)) map('J', wdg.task_move(-1)) map('dd', wdg.task_remove()) # ------------------------------------------------ system functions map('?', fm.display_help()) map('w', 'q', ESC, ctrl('d'), ctrl('c'), lambda arg: arg.fm.ui.close_taskview()) map.rebuild_paths() def initialize_pager_commands(map): _base_pager_commands(map) map('q', 'i', ESC, KEY_F1, lambda arg: arg.fm.ui.close_pager()) map.rebuild_paths() def initialize_embedded_pager_commands(map): _base_pager_commands(map) map('q', 'i', ESC, lambda arg: arg.fm.ui.close_embedded_pager()) map.rebuild_paths() def _base_pager_commands(map): _basic_movement(map) _vimlike_aliases(map) _system_functions(map) # -------------------------------------------------------- movement map(KEY_LEFT, wdg.move_horizontal(relative=-4)) map(KEY_RIGHT, wdg.move_horizontal(relative=4)) map(KEY_NPAGE, wdg.move(relative=1, pages=True)) map(KEY_PPAGE, wdg.move(relative=-1, pages=True)) map(ctrl('d'), wdg.move(relative=0.5, pages=True)) map(ctrl('u'), wdg.move(relative=-0.5, pages=True)) # ---------------------------------------------------------- others map('E', fm.edit_file()) map('?', fm.display_help()) # --------------------------------------------- less-like shortcuts map.alias(KEY_NPAGE, 'd') map.alias(KEY_PPAGE, 'u') def _system_functions(map): # Each commandlist should have this bindings map(KEY_RESIZE, fm.resize()) map(KEY_MOUSE, fm.handle_mouse()) map('Q', fm.exit()) map(ctrl('L'), fm.redraw_window()) def _basic_movement(map): map(KEY_DOWN, wdg.move(relative=1)) map(KEY_UP, wdg.move(relative=-1)) map(KEY_HOME, wdg.move(absolute=0)) map(KEY_END, wdg.move(absolute=-1))