ranger/ranger is a Python project with 17.5k stars in the Developer Tools space. A VIM-inspired filemanager for the console
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
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.
For mc aficionados there's also the multi-pane viewmode.
This file describes ranger and how to get it to run. For instructions on the
usage, please read the man page (man ranger in a terminal). See HACKING.md
for development-specific information.
For configuration, check the files in ranger/config/ or copy the
default config to ~/.config/ranger with ranger --copy-config
(see instructions).
The 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 /usr/share/doc/ranger.
A note to packagers: Versions meant for packaging are listed in the changelog
on the website.
img2txt (from caca-utils) for ASCII-art image previews
w3mimgdisplay, ueberzug, mpv, iTerm2, kitty (or other terminal supporting the Kitty graphics protocol), terminology or urxvt for image previews
convert (from imagemagick) to auto-rotate images and for image previews
rsvg-convert (from librsvg)
for SVG previews
ffmpeg, or ffmpegthumbnailer for video thumbnails
highlight, bat or pygmentize for syntax highlighting of code
atool, bsdtar, unrar and/or 7zz to preview archives
bsdtar, tar, unrar, unzip and/or zipinfo (and sed) to preview
archives as their first image
lynx, w3m or elinks to preview html pages
pdftotext or mutool (and fmt) for textual pdf previews, pdftoppm to
preview as image
djvutxt for textual DjVu previews, ddjvu to preview as image
calibre or epub-thumbnailer for image previews of ebooks
transmission-show for viewing BitTorrent information
mediainfo or exiftool for viewing information about media files
odt2txt for OpenDocument text files (odt, ods, odp and sxw)
python or jq for JSON files
sqlite3 for listing tables in SQLite database (and optionally sqlite-utils for fancier box drawing.)
jupyter nbconvert for Jupyter Notebooks
fontimage for font previews
openscad for 3D model previews (stl, off, dxf, scad, csg)
draw.io for draw.io diagram previews
(drawio extension)
Installing
Use the package manager of your operating system to install ranger.
You can also install ranger through PyPI: pip install ranger-fm.
However, it is recommended to use pipx instead
(to benefit from isolated environments). Use
pipx run --spec ranger-fm ranger to install and run ranger in one step.
Check current version:
Installing from a clone
Note that you don't have to install ranger; you can simply run ranger.py.
This also saves a list of all installed files to install_log.txt, which you can
use to uninstall ranger.
Getting Started
After starting ranger, you can use the Arrow Keys or hjkl to
navigate, Enter to open a file or 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 directory.
Ranger can automatically copy default configuration files to ~/.config/ranger
if you run it with the switch --copy-config=( rc | scope | ... | all ).
See ranger --help for a description of that switch. Also check
ranger/config/ for the default configuration.
Going Further
To get the most out of ranger, read the Official User Guide.
For frequently asked questions, see the FAQ.
For more information on customization, see the wiki.
Community
For help, support, or if you just want to hang out with us, you can find us here:
IRC: channel #ranger on Libera.Chat. Don't have an IRC client? Join us via the webchat!
The most recent commit recorded on ranger/ranger was 3 months ago, based on the GitHub push timestamp. The repository has 938 forks — one of the better signals of community interest.
How many stars does ranger/ranger have?
ranger/ranger has 17.5k GitHub stars — refresh the page for the live number, or check github.com/ranger/ranger. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is ranger/ranger written in?
ranger/ranger is written primarily in Python. GitHub's language field is based on the largest share of bytes in the default branch.
What license does ranger/ranger use?
ranger/ranger is released under the GPL-3.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is ranger/ranger associated with?
GitHub's repository topics for ranger/ranger: "console", "file-launcher", "file-manager", "file-preview", "vim". TopGit's editorial category is Developer Tools.
Where can I see ranger/ranger in action?
The project maintains a homepage at https://ranger.fm. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about ranger/ranger?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/ranger/ranger is the definitive source.
Read full README in the tab above.
Is ranger worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of ranger.