# =================================================================== # This file contains the default startup commands for ranger. # To change them, it is recommended to create either /etc/ranger/rc.conf # (system-wide) or ~/.config/ranger/rc.conf (per user) and add your custom # commands there. # # If you copy this whole file there, you may want to set the environment # variable RANGER_LOAD_DEFAULT_RC to FALSE to avoid loading it twice. # # The purpose of this file is mainly to define keybindings and settings. # For running more complex python code, please create a plugin in "plugins/" or # a command in "commands.py". # # Each line is a command that will be run before the user interface # is initialized. As a result, you can not use commands which rely # on the UI such as :delete or :mark. # =================================================================== # =================================================================== # == Options # =================================================================== # Which viewmode should be used? Possible values are: # miller: Use miller columns which show multiple levels of the hierarchy # multipane: Midnight-commander like multipane view showing all tabs next # to each other set viewmode miller #set viewmode multipane # How many columns are there, and what are their relative widths? set column_ratios 1,3,4 # Which files should be hidden? (regular expression) set hidden_filter ^\.|\.(?:pyc|pyo|bak|swp)$|^lost\+found$|^__(py)?cache__$ # Show hidden files? You can toggle this by typing 'zh' set show_hidden true # Ask for a confirmation when running the "delete" command? # Valid values are "always", "never", "multiple" (default) # With "multiple", ranger will ask only if you delete multiple files at once. set confirm_on_delete multiple # Use non-default path for file preview script? # ranger ships with scope.sh, a script that calls external programs (see # README.md for dependencies) to preview images, archives, etc. #set preview_script ~/.config/ranger/scope.sh # Use the external preview script or display simple plain text or image previews? set use_preview_script true # Automatically count files in the directory, even before entering them? set automatically_count_files true # Open all images in this directory when running certain image viewers # like feh or sxiv? You can still open selected files by marking them. set open_all_images true # Be aware of version control systems and display information. set vcs_aware false # State of the four backends git, hg, bzr, svn. The possible states are # disabled, local (only show local info), enabled (show local and remote # information). set vcs_backend_git enabled set vcs_backend_hg disabled set vcs_backend_bzr disabled set vcs_backend_svn disabled # Use one of the supported image preview protocols set preview_images true # Set the preview image method. Supported methods: # # * w3m (default): # Preview images in full color with the external command "w3mimgpreview"? # This requires the console web browser "w3m" and a supported terminal. # It has been successfully tested with "xterm" and "urxvt" without tmux. # # * iterm2: # Preview images in full color using iTerm2 image previews # (http://iterm2.com/images.html). This requires using iTerm2 compiled # with image preview support. # # This feature relies on the dimensions of the terminal's font. By default, a # width of 8 and height of 11 are used. To use other values, set the options # iterm2_font_width and iterm2_font_height to the desired values. # # * terminology: # Previews images in full color in the terminology terminal emulator. # Supports a wide variety of formats, even vector graphics like svg. # # * urxvt: # Preview images in full color using urxvt image backgrounds. This # requires using urxvt compiled with pixbuf support. # # * urxvt-full: # The same as urxvt but utilizing not only the preview pane but the # whole terminal window. # # * kitty: # Preview images in full color using kitty image protocol. # Requires python PIL or pillow library. # If ranger does not share the local filesystem with kitty # the transfer method is changed to encode the whole image; # while slower, this allows remote previews, # for example during an ssh session. # Tmux is unsupported. set preview_images_method w3m # Delay in seconds before displaying an image with the w3m method. # Increase it in case of experiencing display corruption. set w3m_delay 0.02 # Default iTerm2 font size (see: preview_images_method: iterm2) set iterm2_font_width 8 set iterm2_font_height 11 # Use a unicode "..." character to mark cut-off filenames? set unicode_ellipsis false # BIDI support - try to properly display file names in RTL languages (Hebrew, Arabic). # Requires the python-bidi pip package set bidi_support false # Show dotfiles in the bookmark preview box? set show_hidden_bookmarks true # Which colorscheme to use? These colorschemes are available by default: # default, jungle, snow, solarized set colorscheme default # Preview files on the rightmost column? # And collapse (shrink) the last column if there is nothing to preview? set preview_files true set preview_directories true set collapse_preview true # Save the console history on exit? set save_console_history true # Draw the status bar on top of the browser window (default: bottom) set status_bar_on_top false # Draw a progress bar in the status bar which displays the average state of all # currently running tasks which support progress bars? set draw_progress_bar_in_status_bar true # Draw borders around columns? (separators, outline, both, or none) # Separators are vertical lines between columns. # Outline draws a box around all the columns. # Both combines the two. set draw_borders both # Display the directory name in tabs? set dirname_in_tabs false # Enable the mouse support? set mouse_enabled false # Display the file size in the main column or status bar? set display_size_in_main_column true set display_size_in_status_bar true # Display the free disk space in the status bar? set display_free_space_in_status_bar true # Display files tags in all columns or only in main column? set display_tags_in_all_columns true # Set a title for the window? set update_title false # Set the title to "ranger" in the tmux program? set update_tmux_title true # Shorten the title if it gets long? The number defines how many # directories are displayed at once, 0 turns off this feature. set shorten_title 3 # Show hostname in titlebar? set hostname_in_titlebar true # Abbreviate $HOME with ~ in the titlebar (first line) of ranger? set tilde_in_titlebar false # How many directory-changes or console-commands should be kept in history? set max_history_size 20 set max_console_history_size 50 # Try to keep so much space between the top/bottom border when scrolling: set scroll_offset 8 # Flush the input after each key hit? (Noticeable when ranger lags) set flushinput true # Padding on the right when there's no preview? # This allows you to click into the space to run the file. set padding_right true # Save bookmarks (used with mX and `X) instantly? # This helps to synchronize bookmarks between multiple ranger # instances but leads to *slight* performance loss. # When false, bookmarks are saved when ranger is exited. set autosave_bookmarks true # Save the "`" bookmark to disk. This can be used to switch to the last # directory by typing "``". set save_backtick_bookmark true # You can display the "real" cumulative size of directories by using the # command :get_cumulative_size or typing "dc". The size is expensive to # calculate and will not be updated automatically. You can choose # to update it automatically though by turning on this option: set autoupdate_cumulative_size false # Turning this on makes sense for screen readers: set show_cursor false # One of: size, natural, basename, atime, ctime, mtime, type, random set sort natural # Additional sorting options set sort_reverse false set sort_case_insensitive true set sort_directories_first true set sort_unicode false # Enable this if key combinations with the Alt Key don't work for you. # (Especially on xterm) set xterm_alt_key false # Whether to include bookmarks in cd command set cd_bookmarks true # Changes case sensitivity for the cd command tab completion set cd_tab_case sensitive # Use fuzzy tab completion with the "cd" command. For example, # ":cd /u/lo/b" expands to ":cd /usr/local/bin". set cd_tab_fuzzy false # Avoid previewing files larger than this size, in bytes. Use a value of 0 to # disable this feature. set preview_max_size 0 # The key hint lists up to this size have their sublists expanded. # Otherwise the submaps are replaced with "...". set hint_collapse_threshold 10 # Add the highlighted file to the path in the titlebar set show_selection_in_titlebar true # The delay that ranger idly waits for user input, in milliseconds, with a # resolution of 100ms. Lower delay reduces lag between directory updates but # increases CPU load. set idle_delay 2000 # When the metadata manager module looks for metadata, should it only look for # a ".metadata.json" file in the current directory, or do a deep search and # check all directories above the current one as well? set metadata_deep_search false # Clear all existing filters when leaving a directory set clear_filters_on_dir_change false # Disable displaying line numbers in main column. # Possible values: false, absolute, relative. set line_numbers false # When line_numbers=relative show the absolute line number in the # current line. set relative_current_zero false # Start line numbers from 1 instead of 0 set one_indexed false # Save tabs on exit set save_tabs_on_exit false # Enable scroll wrapping - moving down while on the last item will wrap around to # the top and vice versa. set wrap_scroll false # Set the global_inode_type_filter to nothing. Possible options: d, f and l for # directories, files and symlinks respectively. set global_inode_type_filter # This setting allows to freeze the list of files to save I/O bandwidth. It # should be 'false' during start-up, but you can toggle it by pressing F. set freeze_files false # =================================================================== # == Local Options # =================================================================== # You can set local options that only affect a single directory. # Examples: # setlocal path=~/downloads sort mtime # =================================================================== # == Command Aliases in the Console # =================================================================== alias e edit alias q quit alias q! quit! alias qa quitall alias qa! quitall! alias qall quitall alias qall! quitall! alias setl setlocal alias filter scout -prts alias find scout -aets alias mark scout -mr alias unmark scout -Mr alias search scout -rs alias search_inc scout -rts alias travel scout -aefklst # =================================================================== # == Define keys for the browser # =================================================================== # Basic map Q quitall map q quit copymap q ZZ ZQ map R reload_cwd map F set freeze_files! map reset map redraw_window map abort map change_mode normal map ~ set viewmode! map i display_file map ? help map W display_log map w taskview_open map S shell $SHELL map : console map ; console map ! console shell%space map @ console -p6 shell %%s map # console shell -p%space map s console shell%space map r chain draw_possible_programs; console open_with%%space map f console find%space map cd console cd%space map chain console; eval fm.ui.console.history_move(-1) # Change the line mode map Mf linemode filename map Mi linemode fileinfo map Mm linemode mtime map Mp linemode permissions map Ms linemode sizemtime map Mt linemode metatitle # Tagging / Marking map t tag_toggle map ut tag_remove map " tag_toggle tag=%any map mark_files toggle=True map v mark_files all=True toggle=True map uv mark_files all=True val=False map V toggle_visual_mode map uV toggle_visual_mode reverse=True # For the nostalgics: Midnight Commander bindings map help map rename_append map display_file map edit map copy map cut map console mkdir%space map console delete map exit # In case you work on a keyboard with dvorak layout map move up=1 map move down=1 map move left=1 map move right=1 map move to=0 map move to=-1 map move down=1 pages=True map move up=1 pages=True map move right=1 #map console delete map console touch%space # VIM-like copymap k copymap j copymap h copymap l copymap gg copymap G copymap copymap map J move down=0.5 pages=True map K move up=0.5 pages=True copymap J copymap K # Jumping around map H history_go -1 map L history_go 1 map ] move_parent 1 map [ move_parent -1 map } traverse map { traverse_backwards map ) jump_non map gh cd ~ map ge cd /etc map gu cd /usr map gd cd /dev map gl cd -r . map gL cd -r %f map go cd /opt map gv cd /var map gm cd /media map gi eval fm.cd('/run/media/' + os.getenv('USER')) map gM cd /mnt map gs cd /srv map gp cd /tmp map gr cd / map gR eval fm.cd(ranger.RANGERDIR) map g/ cd / map g? cd /usr/share/doc/ranger # External Programs map E edit map du shell -p du --max-depth=1 -h --apparent-size map dU shell -p du --max-depth=1 -h --apparent-size | sort -rh map yp yank path map yd yank dir map yn yank name map y. yank name_without_extension # Filesystem Operations map = chmod map cw console rename%space map a rename_append map A eval fm.open_console('rename ' + fm.thisfile.relative_path.replace("%", "%%")) map I eval fm.open_console('rename ' + fm.thisfile.relative_path.replace("%", "%%"), position=7) map pp paste map po paste overwrite=True map pP paste append=True map pO paste overwrite=True append=True map pl paste_symlink relative=False map pL paste_symlink relative=True map phl paste_hardlink map pht paste_hardlinked_subtree map dD console delete map dd cut map ud uncut map da cut mode=add map dr cut mode=remove map dt cut mode=toggle map yy copy map uy uncut map ya copy mode=add map yr copy mode=remove map yt copy mode=toggle # Temporary workarounds map dgg eval fm.cut(dirarg=dict(to=0), narg=quantifier) map dG eval fm.cut(dirarg=dict(to=-1), narg=quantifier) map dj eval fm.cut(dirarg=dict(down=1), narg=quantifier) map dk eval fm.cut(dirarg=dict(up=1), narg=quantifier) map ygg eval fm.copy(dirarg=dict(to=0), narg=quantifier) map yG eval fm.copy(dirarg=dict(to=-1), narg=quantifier) map yj eval fm.copy(dirarg=dict(down=1), narg=quantifier) map yk eval fm.copy(dirarg=dict(up=1), narg=quantifier) # Searching map / console search%space map n search_next map N search_next forward=False map ct search_next order=tag map cs search_next order=size map ci search_next order=mimetype map cc search_next order=ctime map cm search_next order=mtime map ca search_next order=atime # Tabs map tab_new map tab_close map tab_move 1 map tab_move -1 map tab_move 1 map tab_move -1 map gt tab_move 1 map gT tab_move -1 map gn tab_new map gc tab_close map uq tab_restore map tab_open 1 map tab_open 2 map tab_open 3 map tab_open 4 map tab_open 5 map tab_open 6 map tab_open 7 map tab_open 8 map tab_open 9 map tab_shift 1 map tab_shift -1 # Sorting map or set sort_reverse! map oz set sort=random map os chain set sort=size; set sort_reverse=False map ob chain set sort=basename; set sort_reverse=False map on chain set sort=natural; set sort_reverse=False map om chain set sort=mtime; set sort_reverse=False map oc chain set sort=ctime; set sort_reverse=False map oa chain set sort=atime; set sort_reverse=False map ot chain set sort=type; set sort_reverse=False map oe chain set sort=extension; set sort_reverse=False map oS chain set sort=size; set sort_reverse=True map oB chain set sort=basename; set sort_reverse=True map oN chain set sort=natural; set sort_reverse=True map oM chain set sort=mtime; set sort_reverse=True map oC chain set sort=ctime; set sort_reverse=True map oA chain set sort=atime; set sort_reverse=True map oT chain set sort=type; set sort_reverse=True map oE chain set sort=extension; set sort_reverse=True map dc get_cumulative_size # Settings map zc set collapse_preview! map zd set sort_directories_first! map zh set show_hidden! map set show_hidden! copymap copymap map zI set flushinput! map zi set preview_images! map zm set mouse_enabled! map zp set preview_files! map zP set preview_directories! map zs set sort_case_insensitive! map zu set autoupdate_cumulative_size! map zv set use_preview_script! map zf console filter%space copymap zf zz # Filter stack map .n console filter_stack add name%space map .m console filter_stack add mime%space map .d filter_stack add type d map .f filter_stack add type f map .l filter_stack add type l map .| filter_stack add or map .& filter_stack add and map .! filter_stack add not map .r console filter_stack rotate map .c filter_stack clear map .* filter_stack decompose map .p filter_stack pop map .. filter_stack show # Bookmarks map ` enter_bookmark %any map ' enter_bookmark %any map m set_bookmark %any map um unset_bookmark %any map m draw_bookmarks copymap m um ` ' # Generate all the chmod bindings with some python help: eval for arg in "rwxXst": cmd("map +u{0} shell -f chmod u+{0} %s".format(arg)) eval for arg in "rwxXst": cmd("map +g{0} shell -f chmod g+{0} %s".format(arg)) eval for arg in "rwxXst": cmd("map +o{0} shell -f chmod o+{0} %s".format(arg)) eval for arg in "rwxXst": cmd("map +a{0} shell -f chmod a+{0} %s".format(arg)) eval for arg in "rwxXst": cmd("map +{0} shell -f chmod u+{0} %s".format(arg)) eval for arg in "rwxXst": cmd("map -u{0} shell -f chmod u-{0} %s".format(arg)) eval for arg in "rwxXst": cmd("map -g{0} shell -f chmod g-{0} %s".format(arg)) eval for arg in "rwxXst": cmd("map -o{0} shell -f chmod o-{0} %s".format(arg)) eval for arg in "rwxXst": cmd("map -a{0} shell -f chmod a-{0} %s".format(arg)) eval for arg in "rwxXst": cmd("map -{0} shell -f chmod u-{0} %s".format(arg)) # =================================================================== # == Define keys for the console # =================================================================== # Note: Unmapped keys are passed directly to the console. # Basic cmap eval fm.ui.console.tab() cmap eval fm.ui.console.tab(-1) cmap eval fm.ui.console.close() cmap eval fm.ui.console.execute() cmap redraw_window copycmap copycmap # Move around cmap eval fm.ui.console.history_move(-1) cmap eval fm.ui.console.history_move(1) cmap eval fm.ui.console.move(left=1) cmap eval fm.ui.console.move(right=1) cmap eval fm.ui.console.move(right=0, absolute=True) cmap eval fm.ui.console.move(right=-1, absolute=True) cmap eval fm.ui.console.move_word(left=1) cmap eval fm.ui.console.move_word(right=1) copycmap copycmap # Line Editing cmap eval fm.ui.console.delete(-1) cmap eval fm.ui.console.delete(0) cmap eval fm.ui.console.delete_word() cmap eval fm.ui.console.delete_word(backward=False) cmap eval fm.ui.console.delete_rest(1) cmap eval fm.ui.console.delete_rest(-1) cmap eval fm.ui.console.paste() # And of course the emacs way copycmap copycmap copycmap copycmap copycmap copycmap copycmap copycmap copycmap # Note: There are multiple ways to express backspaces. (code 263) # and (code 127). To be sure, use both. copycmap # This special expression allows typing in numerals: cmap false # =================================================================== # == Pager Keybindings # =================================================================== # Movement pmap pager_move down=1 pmap pager_move up=1 pmap pager_move left=4 pmap pager_move right=4 pmap pager_move to=0 pmap pager_move to=-1 pmap pager_move down=1.0 pages=True pmap pager_move up=1.0 pages=True pmap pager_move down=0.5 pages=True pmap pager_move up=0.5 pages=True copypmap k copypmap j copypmap h copypmap l copypmap g copypmap G copypmap d copypmap u copypmap n f copypmap p b # Basic pmap redraw_window pmap pager_close copypmap q Q i pmap E edit_file # =================================================================== # == Taskview Keybindings # =================================================================== # Movement tmap taskview_move up=1 tmap taskview_move down=1 tmap taskview_move to=0 tmap taskview_move to=-1 tmap taskview_move down=1.0 pages=True tmap taskview_move up=1.0 pages=True tmap taskview_move down=0.5 pages=True tmap taskview_move up=0.5 pages=True copytmap k copytmap j copytmap g copytmap G copytmap u copytmap n f copytmap p b # Changing priority and deleting tasks tmap J eval -q fm.ui.taskview.task_move(-1) tmap K eval -q fm.ui.taskview.task_move(0) tmap dd eval -q fm.ui.taskview.task_remove() tmap eval -q fm.ui.taskview.task_move(-1) tmap eval -q fm.ui.taskview.task_move(0) tmap eval -q fm.ui.taskview.task_remove() # Basic tmap redraw_window tmap taskview_close copytmap q Q w