# =================================================================== # == 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 # 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 false # 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 always # 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 # 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 true # 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 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 false # 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 false # Abbreviate $HOME with ~ in the titlebar (first line) of ranger? set tilde_in_titlebar true # 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 false # 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 true # 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 true # 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 # =================================================================== # == Define keys for the browser # =================================================================== map f console scout%space-eflst%space map tab_new map quit