+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
#86w3m image preview banding/flickering77 comments · 2013-03-25#1890Multiple issues with `kitty` image preview.38 comments · 2020-03-25#959Copy a file (content) to one of X clipboards35 comments · 2017-10-13#539Image preview not working inside tmux session in iTerm233 comments · 2016-05-01#1248Ranger is missing a refresh after an edit in a specific case32 comments · 2018-08-10#1654How can I disable the top header and bottom status bar?28 comments · 2019-08-04#1385rifle is using unknown setting for editor choice28 comments · 2018-11-24#1401Open editor in separate window27 comments · 2018-12-09