# =================================================================== # 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 true # 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 local set vcs_backend_hg disabled set vcs_backend_bzr disabled set vcs_backend_svn disabled # Truncate the long commit messages to this length when shown in the statusbar. set vcs_msg_length 50 # 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. # # * ueberzug: # Preview images in full color with the external command "ueberzug". # Images are shown by using a child window. # Only for users who run X11 in GNU/Linux. set preview_images_method ueberzug # Delay in seconds before displaying an image with the w3m method. # Increase it in case of experiencing display corruption. set w3m_delay 0.02 # Manually adjust the w3mimg offset when using a terminal which needs this set w3m_offset 0 # 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 # Wrap long lines in plain text previews? set wrap_plaintext_previews false # 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 none # Display the directory name in tabs? set dirname_in_tabs false # Enable the mouse support? set mouse_enabled true # 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? Updates both `WM_NAME` and `WM_ICON_NAME` set update_title false # Set the tmux/screen window-name to "ranger"? 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 # Print file sizes in bytes instead of the default human-readable format. set size_in_bytes false # Warn at startup if RANGER_LEVEL env var is greater than 0, in other words # give a warning when you nest ranger in a subshell started by ranger. # Special value "error" makes the warning more visible. set nested_ranger_warning true # =================================================================== # == 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 scroll_preview 1 map scroll_preview -1 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 Mh linemode humanreadablemtime map Mp linemode permissions map Ms linemode sizemtime map MH linemode sizehumanreadablemtime 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 console trash 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 pd console paste dest= map p` paste dest=%any_path map p' paste dest=%any_path map dD console delete map dT console trash 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 .d filter_stack add type d map .f filter_stack add type f map .l filter_stack add type l map .m console filter_stack add mime%space map .n console filter_stack add name%space map .# console filter_stack add hash%space map ." filter_stack add duplicate map .' filter_stack add unique map .| filter_stack add or map .& filter_stack add and map .! filter_stack add not map .r 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