Ranger
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.
Installation
USE flags
USE flags for app-misc/ranger Vim-inspired file manager for the console
test
|
Enable dependencies and/or preparations necessary to run tests (usually controlled by FEATURES=test but can be toggled independently) |
Emerge
root #emerge --ask app-misc/rangerAdditional software
Ranger can be extended with additional tools, this section will discuss some possibilities of note.
Dragon
Dragon is a drag and drop functionality for X/Wayland, that can be used in conjunction with Ranger.
Dragon is not currently present in the Gentoo ebuild repository, however it is available at the GURU overlay.
In a pinch, Dragon can be installed by compiling from the git repo, to a user's home. First, create a directory to hold the source if one does not yet exist, clone the git repository, and enter the source directory:
user $mkdir --parents ~/.local/src
user $cd ~/.local/src
user $git clone https://github.com/mwh/dragon.git
user $cd dragon
Install Dragon, prefixing to a directory in the user's home dir:
user $make prefix="~/.local" installThe ~/.local/bin directory can be added to the PATH environment variable, to allow invocation of dragon from the command line - and in scripts - without specifying the full path to the executable.
To use Dragon in Ranger, add to the configuration files:
/.config/ranger/rc.confmap <C-d> shell dragon -a -x %p --and-exit
~/.config/ranger/rifle.confhas dragon, X, flag f = dragon -a -x "$@"
It should now be possible to press Ctrl+d in ranger to open a GUI popup with the selected folder, which can be used to drag and drop.
Configuration
Files
Ranger's global configuration files are (by default) stored in /etc/ranger. However, the configuration files can be copied and made user specific.
All configuration files can be copied to ~/.config/ranger/ using the following command:
user $ranger --copy-config=allThere are other possible values for this option to copy specific configuration files. Visit the man page section for more info
To disable loading of the global configuration files, export RANGER_LOAD_DEFAULT_RC=FALSE to the shell environment.
Usage
Invocation
user $ranger --help Usage: ranger [options] [path]
Options:
--version show program's version number and exit
-h, --help show this help message and exit
-d, --debug activate debug mode
-c, --clean don't touch/require any config files.
--logfile=file log file to use, '-' for stderr
--cachedir=dir change the cache directory. (/home/chr/.cache/ranger)
-r dir, --confdir=dir
change the configuration directory.
(/home/chr/.config/ranger)
--datadir=dir change the data directory.
(/home/chr/.local/share/ranger)
--copy-config=which copy the default configs to the local config
directory. Possible values: all, rc, rifle, commands,
commands_full, scope
--choosefile=OUTFILE Makes ranger act like a file chooser. When opening a
file, it will quit and write the name of the selected
file to OUTFILE.
--choosefiles=OUTFILE
Makes ranger act like a file chooser for multiple
files at once. When opening a file, it will quit and
write the name of all selected files to OUTFILE.
--choosedir=OUTFILE Makes ranger act like a directory chooser. When ranger
quits, it will write the name of the last visited
directory to OUTFILE
--selectfile=filepath
Open ranger with supplied file selected.
--show-only-dirs Show only directories, no files or links
--list-unused-keys List common keys which are not bound to any action.
--list-tagged-files=tag
List all files which are tagged with the given tag,
default: *
--profile Print statistics of CPU usage on exit.
--cmd=COMMAND Execute COMMAND after the configuration has been read.
Use this option multiple times to run multiple
commands.
External resources
- LF - a terminal file manager inspired by ranger, written in Go.
- app-misc/nnn - the "missing terminal file browser" for X.