|Number of watchers on Github||3268|
|Number of open issues||202|
|Average time to close an issue||13 days|
|Average time to merge a PR||12 days|
|Open pull requests||59+|
|Closed pull requests||51+|
|Last commit||over 1 year ago|
|Repo Created||about 10 years ago|
|Repo Last Updated||over 1 year ago|
|Organization / Author||ranger|
|Do you use ranger? Leave a review!|
|View open issues (202)|
|View ranger activity|
|View on github|
|Fresh, new opensource launches 🚀🚀🚀|
Trendy new open source projects in your inbox! View examples
ranger is a console file manager with VI key bindings. It provides a
minimalistic and nice curses interface with a view on the directory hierarchy.
It ships with
rifle, a file launcher that is good at automatically finding
out which program to use for what file type.
This file describes ranger and how to get it to run. For instructions on the
usage, please read the man page. See
HACKING.md for development specific
For configuration, check the files in
ranger/config/ or copy the
default config to
examples/ directory contains several scripts and plugins that demonstrate how
ranger can be extended or combined with other programs. These files can be
found in the git repository or in
A note to packagers: Versions meant for packaging are listed in the changelog on the website.
>=3.1) with the
cursesmodule and (optionally) wide-unicode support.
fileprogram for determining file types
chardet, in case of encoding detection problems
sudoto use the
run as root-feature
w3mimgdisplayprogram to preview images
Optional, for enhanced file previews (with
caca-utils) for ASCII-art image previews
pygmentizefor syntax highlighting of code
unrarfor previews of archives
elinksfor previews of html pages
pdftotextfor pdf previews
transmission-showfor viewing bit-torrent information
exiftoolfor viewing information about media files
odt2txtfor OpenDocument text files (
Use the package manager of your operating system to install ranger.
Note that ranger can be started without installing by simply running
To install ranger manually:
sudo make install
This translates roughly to:
sudo python setup.py install --optimize=1 --record=install_log.txt
This also saves a list of all installed files to
install_log.txt, which you can
use to uninstall ranger.
After starting ranger, you can use the Arrow Keys or
l to navigate,
to open a file or type
Q to quit. The third column shows a preview of the
current file. The second is the main column and the first shows the parent
Ranger can automatically copy default configuration files to
if you run it with the switch
--copy-config=( rc | scope | ... | all ).
ranger --help for a description of that switch. Also check
ranger/config/ for the default configuration.