ranger /ranger

A VIM-inspired filemanager for the console

★ 17,465⑂ 939👁 146⑃ 994● 2,251▤ 0
PythonGPL-3.0Created 2009-06-04ranger.fm
+1
Daily
17,465
stars
939
forks
146
watchers
994
prs
2,251
issues
0
releases

README

Ranger 1.9.4
============






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.

!screenshot

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.


About
-----
 Authors:     see AUTHORS file
 License:     GNU General Public License Version 3
 Website:     https://ranger.fm/
 Download:    https://ranger.fm/ranger-stable.tar.gz
 Bug reports: https://github.com/ranger/ranger/issues
 git clone    https://github.com/ranger/ranger.git


Design Goals
------------
 An easily maintainable file manager in a high level language
 A quick way to switch directories and browse the file system
 Keep it small but useful, do one thing and do it well
 Console-based, with smooth integration into the unix shell


Features
--------
 UTF-8 Support  (if your Python copy supports it)
 Multi-column display
 Preview of the selected file/directory
 Common file operations (create/chmod/copy/delete/...)
 Renaming multiple files at once
 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...


Dependencies
------------
 Python (=2.6 or =3.1) with the curses module
  and (optionally) wide-unicode support
 A pager (less by default)

 Optional dependencies

For general usage:

 file for determining file types
 chardet (Python package) for improved encoding detection of text files
 sudo to use the "run as root" feature
 python-bidi (Python package) to display right-to-left file names correctly
  (Hebrew, Arabic)

For enhanced file previews (with scope.sh):

 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

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON