ranger is a file manager with VI key bindings. It provides a minimalistic and nice curses interface with a view on the directory hierarchy. The secondary task of ranger is to psychically guess which program you want to use for opening particular files.
- Uses Python (2.6 or higher)
- Latest stable version: ranger 1.7.1 (2015-05-04)
- signature and public key (00FB5CDF) for verification
- git clone git://git.savannah.nongnu.org/ranger.git
If you wish to donate to the cause, you can use one of the following methods:
- Python (tested with version 2.7, 3.1, 3.2, 3.3, 3.4) with support for ncurses and (optionally) wide-unicode.
- A pager (less by default)
- w3m for previewing images in "true color".
- file for determining file types
- The python module chardet, in case of encoding detection problems
- "sudo" to use the "run as root"-feature
Optional, for enhanced file previews (with "scope.sh"):
- img2txt (from caca-utils) for previewing images in ASCII-art
- highlight for syntax highlighting of code
- atool for previews of archives
- lynx, w3m or elinks for previews of html pages
- pdftotext for pdf previews
- transmission-show for viewing bit-torrent information
- mediainfo or exiftool for viewing information about media files
Note: previewing images in "true color" is disabled by default. To enable it, first make sure you have w3m installed, then check that your terminal supports it. It was successfully tested with urxvt and xterm, while it did not work with gnome-terminal and st. Currently it does not work with tmux but with screen. Finally, add this line to your ~/.config/ranger/rc.conf and restart ranger:
Note: to use custom file previews, you need ranger 1.3.1 or later, and a script that creates previews. Use the default script by typing:
- UTF-8 Support
- Multi-column display
- Preview of the selected file/directory
- Common file operations (create/chmod/copy/delete/...)
- VIM-like console and hotkeys
- Automatically determine file types and run them with correct programs
- Change the directory of your shell after exiting ranger
- Tabs, Bookmarks, Mouse support
This log documents changes between stable versions. 2015-05-04: version 1.7.1 * Added doc/cheatsheet.svg * Added examples/rc_emacs.conf, a config file adding emacs-like key bindings * Added "env" keyword in rifle.conf * Fixed ":bulkrename" command in python3 * Fixed "S" key binding not working when SHELL=fish 2015-04-13: version 1.7.0 * The default editor is now "vim" instead of "nano" * Added automatic updates of tags when a file is renamed from within ranger * Added "preview_images_method" which can be set to "iterm2" to use native iTerm2 image previews * Added ":rename_append" command to rename files without the file extension * Added ":linemode" command to change the way the files are displayed Try this out by pressing M followed by one of the suggested keys. New linemodes can be added with ranger.api.register_linemode(). * Added ":filter_inode_type" command to only show directories, files or links * Added ":meta" command for managing custom file metadata * Added ":flat" command for displaying subdirectories * Added "solarized" colorscheme * Added generic ability to use scope.sh for image previews * Added video previews in scope.sh * Added option "sort_unicode" to sort according to unicode, not ASCII * ":mkdir" can now create multiple directory levels (like `mkdir -p`) * ":help" (key binding "?") is now interactive * ":find" (key binding "/") is now case insensitive by default * "ranger --copy-config=all" now copies a short sample commands.py rather than the full one, so that you can update ranger without having broken commands. The full commands.py is still copied to ~/.config/ranger/commands_full.py. * Fixed broken copying of symlinks 2013-05-24: Version 1.6.1 * Added support for version control systems, see: http://lists.nongnu.org/archive/html/ranger-users/2013-03/msg00007.html * Added :scout command as a unified backend to :find, :search, etc * Added "open_all_images" setting to remove the need for external scripts to handle opening of all images in a directory at once. * Now previewing with "i" uses the whole available width. 2013-02-22: Version 1.6.0 * Overhauled all config files. Please update them or use the --clean switch * Added "examples/" directory to source code which contains sample programs or plugins that can be used together with ranger * Added progress bars to copying, moving and directory loading processes * Added feature to draw images inside the console using w3mimgdisplay (you need to add "set preview_images true" in rc.conf) * Added a plugin system like in the program "anki", i.e. place any python file into ~/.config/ranger/plugins/ and it will be imported by ranger * Added a separate file launcher named "rifle" that is configured through rifle.conf and is installed as a standalone program. Using "ranger [filename]" from the shell for opening files is deprecated now, please use "rifle [filename]" instead. * Added "uq" keybinding to undo closed tabs * Added :setlocal command to change settings for specific directories only * Added :travel command to move more quickly to your destination * Added 256 color support for scope.sh * Added a real yes/no prompt for :delete command * Added settings: confirm_on_delete, draw_progress_bar_in_status_bar, preview_images, status_bar_on_top, update_tmux_title * Added commands: :mark_tag, :unmark_tag * Added BSD-friendly setsid implementation * Added as-you-type filtering for :filter command * Replaced "options.py" file by :set commands in rc.conf * Replaced "apps.py" file with rifle.conf * Improved "r" key to interface with rifle * Rewritten "scope.sh" in POSIX shell * Changed copying/moving code to work without GNU coreutils * Changed key to untag files from "T" to "ut" * Changed the flag "d" (for detached) to "f" (for fork) in program launcher * Changed appearance of keybinding-hints and bookmarks * Changed tabs with 4 spaces in the source code (see PEP 8) * Removed ranger.core.environment class * Removed settings: colorscheme_overlay, draw_bookmark_borders, init_function, load_default_rc * Fixed zombie process apocalypse * Fixed draw_borders=true in combination with padding_right=false 2012-08-10: Version 1.5.5 * Ensure that detached programs continue to run when ranger is killed 2012-05-03: Version 1.5.4 * Added exiftool to scope.sh by default * Fixed a crash when entering a directory with a unicode name * Speedup in ranger.ext.get_executables 2012-03-05: Version 1.5.3 * Added --selectfile option that selects a certain file on startup * Added --list-tagged-files option * Added --cmd option to run commands on startup * Added --profile option for additional debug information on exit * Added a visual mode (activate with "V", deactivate with Esc) * Added a reversed visual mode (activate with "uV") * Added $RANGER_LEVEL environment variable which ranger sets to "1" or higher so programs can know that they were spawned from ranger * Added run flag "r" for running with root privileges (needs sudo) * Added run flag "t" for running in a new terminal (as specified in $TERMCMD) * Added :relink command to change destinations of symlinks * Added "dc" binding for getting the cumulative size of a directory * Added "autoupdate_cumulative_size" option * Added "pht" binding to Paste Hardlinked subTrees (like cp -l) * Improved sorting speed of signals (noticable when caching many directories) * Improved drawing speed * Fixed unexpected behavior when displaying nonprintable characters * Fixed :bulkrename to work with files starting with a minus sign * Fixed RangerChooser example in man page * Fixed crash when opening images with sxiv/feh by running "ranger " 2011-10-23: Version 1.5.2 * Fixed graphical bug that appears in certian cases when drawing characters at the right edge. 2011-10-23: Version 1.5.1 * Added fm.select_file(path) * Added --choosefiles option (like --choosefile, but chooses multiple files) * Fixed --list-unused-keys * Fixed Zombie processes * Fixed handling of filenames with undecodable bytes (unicode surrogates) * Fixed crashes due to incomplete loading of directories * Fixed tab completion of the command "shell" * Fixed "ot" and "oT" keys in rc.conf * Fixed parsing of chained commands (like in the binding "om") 2011-10-11: Version 1.5.0 * Full python3.2 compatibility * Added new configuration file "rc.conf" which contains a list of commands that are executed on startup - mainly used for keybindings * Added --list-unused-keys * Added new program handlers to apps.py * Added pop-up window for keychains and bookmarks * Added load_default_rc option * Fixed all known unicode issues * Fixed crash when $TERM is unknown to the system * Fixed scrolling in colored preview * Changed the default column_ratios to 1/3/4 and sorting method to "natural" * Changed :rename so it doesn't overwrite existing files * Internal actions are now accessible as commands * Replaced unittests by doctests * Replaced integrated help with an extended man page and dynamic lists of keybindings, commands and settings. * Removed "keys.py" configuration file in favor of "rc.conf" * Removed "texas" colorscheme * apps.py: Now able to define programs that only run with Xorg * commands.py: Using parse(self.line) to parse the line is unnecessary now. parse(self.line).rest(n) is now written as self.rest(n). However, parse(self.line).chunk(n) has been renamed to self.arg(n). * commands.py: parse(self.line) + X is now self.firstpart + X * commands.py: New special attribute "resolve_macros" which decides whether strings like %f should be expanded to the name of the current file, etc. * commands.py: New special attribute "escape_macros_for_shell" to toggle whether or not macros should be escaped, so you can use them in other commands than :shell, for example :edit %f * Countless small fixes and improvements 2011-10-02: Version 1.4.4 * Added keys for chmod (like +ow for "chmod o+w", etc) * Added "c" flag for running files * Added various key bindings * Added wavpack and webm types to mime.types * Added option "display_tags_in_all_columns" * Added command.cancel method which is called when pressing ESC in console * Added sorting and cycling by ctime and atime * Added custom tags (press "x) * Added bittorrent preview * Fixed blocking when using interactive scripts in scope.sh * Fixed issues with ALT key * Fixed pager crash when trying to read non-readable file * Forbid piping things into ranger * Improved hints 2011-04-05: Version 1.4.3 * Fixed mimetype checking when invoking ranger with a filename * Fixed loss of bookmarks when disk is full * Minor improvements 2011-03-05: Version 1.4.2 * Added --choosefile and --choosedir flag * Added use of bookmarks in tab completion of the :cd command * Fixed bug with detached programs and python 3.2 2011-01-04: Version 1.4.1 * Fixed crash when preview failed under some circumstances * Fixed graphical bug when pressing i 2010-12-22: Version 1.4.0 * Added option to use any external scripts for previews (see scope.sh) * Added key: zv to toggle the use of the external script * Added indicator for the used filter (type "zf") * Added option padding_right to remove whitespace if theres no preview * Added command :search_inc for incremental search * Added commands :save_copy_buffer and :load_copy_buffer to share the copied files between ranger instances * Added mimeopen as a fallback if no useful application can be found * Added natural sort, sorts 1foo before 10foo. (type "on") * Added keys: yp, yd and yb to copy path, dirname or basename to seleciton * Let open_with use the selection, not just one file * Run files with right mouse click * Implemented copying via coreutils rather than internal python code * Improved handling of unicode * Some restructuration of the source code 2010-12-13: Version 1.2.3 * Enable binding to alt-keys * Fixed memory leak in garbage collecting of old, unused directory objects * Fixed python3 incompatibilities * Fixed problems with identifying changes of files * Fixed lazy lookup of some FSObject attributes 2010-10-10: Version 1.2.2 * Prevent currently used directories from being garbage collected * Disable mouse buttons when console is open * Fixed :cd command: Without arguments, cd's into $HOME * Fixed bug which prevented pydoc to work on some config files * Fixed some bugs in "snow" and "jungle" colorschemes * Several other clean-ups and fixes 2010-09-16: Version 1.2.1 * Fixed yy/pp bug when yanking multiple directories 2010-09-13: Version 1.2.0 * !!! Changed the default configuration directory to ~/.config/ranger !!! * Removed "Console Modes", each old mode is now a simple command * Disabled file previews by default if ranger is used by root * Allow to jump to specific help sections by typing two numbers, e.g. 13? * Added keys: da, dr, ya, yr for adding and removing files from copy buffer * Added keys: gl and gL to resolve links, see 11? * Added key: pL to create a relative symlink * Added %
and % macros for the console, see 33? * Fixed ansi codes for colors in the pager * Use the file ~/.mime.types for mime type detection * Several clean-ups and fixes 2010-07-17: Version 1.1.2 * Fix crash when using scrollwheel to scroll down in some cases * The command "ranger dir1 dir2 ..." opens multiple directories in tabs * Removed pydoc html documentation by default, re-create it with "make doc" * Minor fixes 2010-06-18: Version 1.1.1 * New install script, "setup.py" * New flag for running programs: "w" (waits for enter press) * Minor fixes 2010-06-09: Version 1.1.0 * Added a man page * Tab support * Improved directory loading performance * Commands are definable in ~/.ranger/commands.py * Case insensitive sorting (type zs) * Better UTF support * Possibility to turn off previews (zp and zP) * Changing options with :set (e.g. :set column_ratios=1,2,3,4) * Ask for confirmation when using :delete * New invocation flag: --fail-unless-cd * New hotkeys, commands, options. * New syntax for ~/.ranger/keys.py * Several user contributions * And tons of general improvements NOTE: The syntax for configuration is still subject to change.