.de Sp \" Vertical space (when we can't use .PP)

.if t .sp .5v

.if n .sp

..

.de Vb \" Begin verbatim text

.ft CW

.nf

.ne \\$1

..

.de Ve \" End verbatim text

.ft R

.fi

..

.tr \(*W-

.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'

.ie n \{\

. ds -- \(*W-

. ds PI pi

. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch

. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch

. ds L" ""

. ds R" ""

. ds C` ""

. ds C' ""

'br\}

.el\{\

. ds -- \|\(em\|

. ds PI \(*p

. ds L" ``

. ds R" ''

. ds C`

. ds C'

'br\}

.ie \n(.g .ds Aq \(aq

.el .ds Aq '

.de IX

..

.nr rF 0

.if \n(.g .if rF .nr rF 1

.if (\n(rF:(\n(.g==0)) \{\

. if \nF \{\

. de IX

. tm Index:\\$1\t\\n%\t"\\$2"

..

. if !\nF==2 \{\

. nr % 0

. nr F 2

. \}

. \}

.\}

.rr rF

.if n \{\

. ds #H 0

. ds #V .8m

. ds #F .3m

. ds #[ \f1

. ds #] \fP

.\}

.if t \{\

. ds #H ((1u-(\\\\n(.fu%2u))*.13m)

. ds #V .6m

. ds #F 0

. ds #[ \&

. ds #] \&

.\}

.if n \{\

. ds ' \&

. ds ` \&

. ds ^ \&

. ds , \&

. ds ~ ~

. ds /

.\}

.if t \{\

. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"

. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'

. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'

. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'

. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'

. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'

.\}

.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'

.ds 8 \h'\*(#H'\(*b\h'-\*(#H'

.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]

.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'

.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'

.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]

.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]

.ds ae a\h'-(\w'a'u*4/10)'e

.ds Ae A\h'-(\w'A'u*4/10)'E

.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'

.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'

.if \n(.H>23 .if \n(.V>19 \

. ds : e

. ds 8 ss

. ds o a

. ds d- d\h'-1'\(ga

. ds D- D\h'-1'\(hy

. ds th \o'bp'

. ds Th \o'LP'

. ds ae ae

. ds Ae AE

.\}

.rm #[ #] #H #V #F C

.IX Title "RANGER 1"

.if n .ad l

.nh

ranger \- visual file manager

.IX Header "SYNOPSIS"

\&\fBranger\fR [\fB\-\-version\fR] [\fB\-\-help\fR] [\fB\-\-debug\fR] [\fB\-\-clean\fR]

[\fB\-\-cachedir\fR=\fIdirectory\fR] [\fB\-\-confdir\fR=\fIdirectory\fR]

[\fB\-\-datadir\fR=\fIdirectory\fR] [\fB\-\-copy\-config\fR=\fIwhich\fR]

[\fB\-\-choosefile\fR=\fItarget\fR] [\fB\-\-choosefiles\fR=\fItarget\fR]

[\fB\-\-choosedir\fR=\fItarget\fR] [\fB\-\-selectfile\fR=\fIfilepath\fR]

[\fB\-\-show\-only\-dirs\fR]

[\fB\-\-list\-unused\-keys\fR] [\fB\-\-list\-tagged\-files\fR=\fItag\fR]

[\fB\-\-profile\fR] [\fB\-\-cmd\fR=\fIcommand\fR] [\fIpath ...\fR]

.IX Header "DESCRIPTION"

ranger is a console file manager with \s-1VI\s0 key bindings.

.IX Header "RESOURCES"

This \fImanual\fR contains instructions on how to use and configure ranger.

.PP

Inside \fIranger\fR, you can press \fI?\fR for a list of key bindings, commands or

settings.

.PP

The \fI\s-1README\s0\fR contains install instructions.

.PP

The file \fI\s-1HACKING\s0.md\fR contains guidelines for code modification.

.PP

The directory \fIdoc/configs\fR contains configuration files. They are usually

installed to \fI/usr/share/doc/ranger/config\fR and can be obtained with ranger's

\&\-\-copy\-config option.

.PP

The directory \fIexamples\fR contains reference implementations for ranger

plugins, sample configuration files and some programs for integrating ranger

with other software. They are usually installed to

\&\fI/usr/share/doc/ranger/examples\fR.

.PP

The man page of \fBrifle\fR\|(1) describes the functions of the file opener

.PP

The section \fI\s-1LINKS\s0\fR of this man page contains further resources.

.IX Header "POSITIONAL ARGUMENTS"

.IP "\fIpath ...\fR" 14

.IX Item "path ..."

Each path will be opened in a tab and if the path is a file it will be selected.

Omitting this is equivalent to providing the current directory.

.IX Header "OPTIONS"

.IP "\fB\-d\fR, \fB\-\-debug\fR" 14

.IX Item "-d, --debug"

Activate the debug mode: Whenever an error occurs, ranger will exit and print a

full traceback. The default behavior is to merely print the name of the

exception in the statusbar/log and try to keep running.

.IP "\fB\-c\fR, \fB\-\-clean\fR" 14

.IX Item "-c, --clean"

Activate the clean mode: ranger will not access or create any configuration

files nor will it leave any traces on your system. This is useful when your

configuration is broken, when you want to avoid clutter, etc.

.IP "\fB\-\-cachedir\fR=\fIdir\fR" 14

.IX Item "--cachedir=dir"

Change the cache directory of ranger from \f(CW$XDG_CACHE_HOME\fR or ~/.cache/ranger to \*(L"dir\*(R".

.IP "\fB\-r\fR \fIdir\fR, \fB\-\-confdir\fR=\fIdir\fR" 14

.IX Item "-r dir, --confdir=dir"

Change the configuration directory of ranger from \f(CW$XDG_CONFIG_HOME\fR or ~/.config/ranger to \*(L"dir\*(R".

.IP "\fB\-\-datadir\fR=\fIdir\fR" 14

.IX Item "--datadir=dir"

Change the data directory of ranger from \f(CW$XDG_DATA_HOME\fR or ~/.local/share/ranger to \*(L"dir\*(R".

.IP "\fB\-\-copy\-config\fR=\fIfile\fR" 14

.IX Item "--copy-config=file"

Create copies of the default configuration files in your local configuration

directory. Existing ones will not be overwritten. Possible values: \fIall\fR,

\&\fIcommands\fR, \fIcommands_full\fR, \fIrc\fR, \fIrifle\fR, \fIscope\fR.

.Sp

Note: You may want to disable loading of the global configuration files by

exporting \fIRANGER_LOAD_DEFAULT_RC=FALSE\fR in your environment. See also:

\&\-\-copy\-config=\fBcommands\fR will copy only a small sample configuration file with

a thoroughly commented example. It is recommended to keep this file tidy to

avoid getting defunct commands on ranger upgrades. The full default

commands.py can be copied with \-\-copy\-config=\fBcommands_full\fR, but that file

will be ignored by ranger and serves only as a reference for making your own

commands.

.IP "\fB\-\-choosefile\fR=\fItargetfile\fR" 14

.IX Item "--choosefile=targetfile"

Allows you to pick a file with ranger. This changes the behavior so that when

you open a file, ranger will exit and write the absolute path of that file into

\&\fItargetfile\fR.

.IP "\fB\-\-choosefiles\fR=\fItargetfile\fR" 14

.IX Item "--choosefiles=targetfile"

Allows you to pick multiple files with ranger. This changes the behavior so

that when you open a file, ranger will exit and write the absolute paths of all

selected files into \fItargetfile\fR, adding one newline after each filename.

.IP "\fB\-\-choosedir\fR=\fItargetfile\fR" 14

.IX Item "--choosedir=targetfile"

Allows you to pick a directory with ranger. When you exit ranger, it will

write the last visited directory into \fItargetfile\fR.

.IP "\fB\-\-selectfile\fR=\fItargetfile\fR" 14

.IX Item "--selectfile=targetfile"

Open ranger with \fItargetfile\fR selected. This is a legacy option, superseded by

the behavior for the \s-1POSITIONAL ARGUMENTS.\s0

.IP "\fB\-\-show\-only\-dirs\fR" 14

.IX Item "--show-only-dirs"

Display only the directories. May be used in conjunction with

\&\fB\-\-choosedir\fR=\fItargetfile\fR.

.IP "\fB\-\-list\-unused\-keys\fR" 14

.IX Item "--list-unused-keys"

List common keys which are not bound to any action in the \*(L"browser\*(R" context.

This list is not complete, you can bind any key that is supported by curses:

use the key code returned by \f(CW\*(C`getch()\*(C'\fR.

.IP "\fB\-\-list\-tagged\-files\fR=\fItag\fR" 14

.IX Item "--list-tagged-files=tag"

List all files which are tagged with the given tag. Note: Tags are single

characters. The default tag is \*(L"*\*(R"

.IP "\fB\-\-profile\fR" 14

.IX Item "--profile"

Print statistics of \s-1CPU\s0 usage on exit.

.IP "\fB\-\-cmd\fR=\fIcommand\fR" 14

.IX Item "--cmd=command"

Execute the command after the configuration has been read. Use this option

multiple times to run multiple commands.

.IP "\fB\-\-version\fR" 14

.IX Item "--version"

Print the version and exit.

.IP "\fB\-h\fR, \fB\-\-help\fR" 14

.IX Item "-h, --help"

Print a list of options and exit.

.IX Header "CONCEPTS"

This part explains how certain parts of ranger work and how they can be used

efficiently.

.IX Subsection "TAGS"

Tags are single characters which are displayed left of a filename. You can use

tags however you want. Press \*(L"t\*(R" to toggle tags and \*(L"ut\*(R" to remove any tags of

the selection. The default tag is an Asterisk (\*(L"*\*(R"), but you can use any tag by

typing \fI"<tagname>\fR.

.IX Subsection "PREVIEWS"

By default, only text files are previewed, but you can enable external preview

scripts by setting the option \f(CW\*(C`use_preview_script\*(C'\fR and \f(CW\*(C`preview_files\*(C'\fR to true.

.PP

This default script is \fI\f(CI%rangerdir\fI/data/scope.sh\fR. It contains more

documentation and calls to the programs \fIlynx\fR and \fIelinks\fR for html,

\&\fIhighlight\fR for text/code, \fIimg2txt\fR for images, \fIatool\fR for archives,

\&\fIpdftotext\fR or \fImutool\fR for PDFs and \fImediainfo\fR for video and audio files.

.PP

Install these programs (just the ones you need) and scope.sh will automatically

use them.

.PP

Independently of the preview script, there is a feature to preview images

by drawing them directly into the terminal. To enable this feature, set the

option \f(CW\*(C`preview_images\*(C'\fR to true and enable one of the image preview modes:

.PP

.IX Subsection "w3m"

.PP

This does not work over ssh, requires certain terminals (tested on \*(L"xterm\*(R" and

\&\*(L"urxvt\*(R") and is incompatible with tmux, although it works with screen.

.PP

To enable this feature, install the program \*(L"w3m\*(R" and set the option

\&\f(CW\*(C`preview_images_method\*(C'\fR to w3m.

.PP

When using a terminal with a nonzero border which is not automatically detected, the w3m preview will be misaligned.

Use the \f(CW\*(C`w3m_offset\*(C'\fR option to manually adjust the image offset. This should be the same value as the terminal's border value.

.PP

.IX Subsection "iTerm2"

.PP

This only works in iTerm2 compiled with image preview support, but works over

ssh.

.PP

To enable this feature, set the option \f(CW\*(C`preview_images_method\*(C'\fR to iterm2.

.PP

This feature relies on the dimensions of the terminal's font. By default, a

width of 8 and height of 11 are used. To use other values, set the options

\&\f(CW\*(C`iterm2_font_width\*(C'\fR and \f(CW\*(C`iterm2_font_height\*(C'\fR to the desired values.

.PP

.IX Subsection "terminology"

.PP

This only works in terminology. It can render vector graphics, but works only locally.

.PP

To enable this feature, set the option \f(CW\*(C`preview_images_method\*(C'\fR to terminology.

.PP

.IX Subsection "urxvt"

.PP

This only works in urxvt compiled with pixbuf support. Does not work over ssh.

.PP

Essentially this mode sets an image as a terminal background temporarily, so it

will break any previously set image background.

.PP

To enable this feature, set the option \f(CW\*(C`preview_images_method\*(C'\fR to urxvt.

.PP

.IX Subsection "urxvt-full"

.PP

The same as urxvt but utilizing not only the preview pane but the whole terminal

window.

.PP

To enable this feature, set the option \f(CW\*(C`preview_images_method\*(C'\fR to urxvt-full.

.PP

.IX Subsection "kitty"

.PP

This only works on Kitty. It requires \s-1PIL\s0 (or pillow) to work.

Allows remote image previews, for example in an ssh session.

.PP

To enable this feature, set the option \f(CW\*(C`preview_images_method\*(C'\fR to kitty.

.IX Subsection "SELECTION"

The \fIselection\fR is defined as \*(L"All marked files \s-1IF THERE ARE ANY,\s0 otherwise

the current file.\*(R" Be aware of this when using the :delete command, which

deletes all files in the selection.

.PP

You can mark files by pressing <Space>, v, etc. A yellow \fBMrk\fR symbol at the

bottom right indicates that there are marked files in this directory.

.IX Subsection "MACROS"

Macros can be used in commands to abbreviate things.

.PP

.Vb 6

\& %f the highlighted file

\& %d the path of the current directory

\& %s the selected files in the current directory

\& %t all tagged files in the current directory

\& %c the full paths of the currently copied/cut files

\& %p the full paths of selected files

.Ve

.PP

The macros \f(CW%f\fR, \f(CW%d\fR, \f(CW%p\fR, and \f(CW%s\fR also have upper case variants, \f(CW%F\fR, \f(CW%D\fR, \f(CW%P\fR, and

\&\f(CW%S\fR, which refer to the next tab. To refer to specific tabs, add a number in

between. (%7s = selection of the seventh tab.)

.PP

\&\f(CW%c\fR is the only macro which ranges out of the current directory. So you may

\&\*(L"abuse\*(R" the copying function for other purposes, like diffing two files which

are in different directories:

.PP

.Vb 2

\& Yank the file A (type yy), move to the file B, then type

\& @diff %c %f

.Ve

.PP

Macros for file paths are generally shell-escaped so they can be used in the

\&\f(CW\*(C`shell\*(C'\fR command.

.PP

When mapping keys you can use the placeholder <any>, the key entered in that

position can be used through the \f(CW%any\fR and \f(CW%any_path\fR macros. (When using

multiple <any> placeholders you can index the macros: \f(CW%any0\fR, \f(CW%any_path0\fR, \f(CW%any1\fR,

\&\f(CW%any_path1\fR...) The macro \f(CW%any\fR will be replaced with the key pressed in the

position of the <any> placeholder. The macro \f(CW%any_path\fR will be replaced with

the path of the bookmark mapped to the key pressed in the position of the

<any> placeholder. For example this macro can be used to echo the key that was

pressed after \*(L"c\*(R":

.PP

.Vb 1

\& map c<any> echo %any

.Ve

.PP

\&\f(CW%any\fR is used in the ranger configuration to create a keybinding for adding a

bookmark. c<set_bookmark> creates a bookmark for the current directory and the

key for the bookmark is the first supplied argument. In this case the key

pressed after \*(L"m\*(R":

.PP

.Vb 1

\& map m<any> set_bookmark %any

.Ve

.PP

The \f(CW%any_path\fR macro can be used to echo the path of the bookmark that is set to

the key pressed after \*(L"c\*(R":

.PP

.Vb 1

\& map c<any> echo %any_path

.Ve

.PP

A practical example of the use of \f(CW%any_path\fR is the pasting of cut/copied files

to a bookmarked directory:

.PP

.Vb 1

\& map p\*(Aq<any> paste dest=%any_path

.Ve

.PP

The macro \f(CW%rangerdir\fR expands to the directory of ranger's python library, you

can use it for something like this command:

alias show_commands shell less \f(CW%rangerdir\fR/config/commands.py

.PP

\&\f(CW%confdir\fR expands to the directory given by \fB\-\-confdir\fR.

.PP

\&\f(CW%datadir\fR expands to the directory given by \fB\-\-datadir\fR.

.PP

The macro \f(CW%space\fR expands to a space character. You can use it to add spaces to

the end of a command when needed, while preventing editors to strip spaces off

the end of the line automatically.

.PP

To write a literal %, you need to escape it by writing %%.

.IX Subsection "BOOKMARKS"

Type \fBm<key>\fR to bookmark the current directory. You can re-enter this

directory by typing \fB`<key>\fR. <key> can be any letter or digit. Unlike vim,

both lowercase and uppercase bookmarks are persistent.

.PP

Each time you jump to a bookmark, the special bookmark at key ` will be set

to the last directory. So typing \*(L"``\*(R" gets you back to where you were before.

.PP

Bookmarks are selectable when tabbing in the :cd command.

.PP

Note: The bookmarks ' (Apostrophe) and ` (Backtick) are the same.

.IX Subsection "RIFLE"

Rifle is the file opener of ranger. It can be used as a standalone program or

a python module. It is located at \fI\f(CI$repo\fI/ranger/ext/rifle.py\fR. In contrast to

other, more simple file openers, rifle can automatically find installed

programs so it can be used effectively out of the box on a variety of systems.

.PP

It's configured in \fIrifle.conf\fR through a list of conditions and commands.

For each line the conditions are checked and if they are met, the respective

command is taken into consideration. By default, simply the first matching

rule is used. In ranger, you can list and choose rules by typing \*(L"r\*(R" or simply

by typing \*(L"<rulenumber><enter>\*(R". If you use rifle standalone, you can list all

rules with the \*(L"\-l\*(R" option and pick a rule with \*(L"\-p <number>\*(R".

.PP

The rules, along with further documentation, are contained in

\&\fI\f(CI$repo\fI/ranger/config/rifle.conf\fR.

.IX Subsection "FLAGS"

Flags give you a way to modify the behavior of the spawned process. They are

used in the commands \f(CW\*(C`:open_with\*(C'\fR (key \*(L"r\*(R") and \f(CW\*(C`:shell\*(C'\fR (key \*(L"!\*(R").

.PP

.Vb 6

\& f Fork the process, i.e. run in background. Please use this flag instead of

\& calling "disown" or "nohup", to avoid killing the background command when

\& pressing Ctrl+C in ranger.

\& c Run the current file only, instead of the selection

\& r Run application with root privilege (requires sudo)

\& t Run application in a new terminal window

.Ve

.PP

There are some additional flags that can currently be used only in the \f(CW\*(C`shell\*(C'\fR

command: (for example \f(CW\*(C`:shell \-w df\*(C'\fR)

.PP

.Vb 3

\& p Redirect output to the pager

\& s Silent mode. Output will be discarded.

\& w Wait for an Enter\-press when the process is done

.Ve

.PP

By default, all the flags are off unless otherwise specified in \fIrc.conf\fR key

bindings or \fIrifle.conf\fR rules. You can specify as many flags as you want. An

uppercase flag negates the effect: \*(L"ffcccFsf\*(R" is equivalent to \*(L"cs\*(R".

.PP

The terminal program name for the \*(L"t\*(R" flag is taken from the environment

variable \f(CW$TERMCMD\fR. If it doesn't exist, it tries to extract it from \f(CW$TERM\fR,

uses \*(L"x\-terminal-emulator\*(R" as a fallback, and then \*(L"xterm\*(R" if that fails.

.PP

Examples: \f(CW\*(C`:open_with c\*(C'\fR will open the file that you currently point at, even

if you have selected other files. \f(CW\*(C`:shell \-w df\*(C'\fR will run \*(L"df\*(R" and wait for

you to press Enter before switching back to ranger.

.IX Subsection "PLUGINS"

ranger's plugin system consists of python files which are located in

\&\fI~/.config/ranger/plugins/\fR and are imported in alphabetical order when

starting ranger. A plugin changes rangers behavior by overwriting or extending

a function that ranger uses. This allows you to change pretty much every part

of ranger, but there is no guarantee that things will continue to work in

future versions as the source code evolves.

.PP

Adding new commands via a plugin as simple as specifying them like you would do

in the \fIcommands.py\fR.

.PP

There are some hooks that are specifically made for the use in plugins. They

are functions that start with hook_ and can be found throughout the code.

.PP

.Vb 1

\& grep \*(Aqdef hook_\*(Aq \-r /path/to/rangers/source

.Ve

.PP

Also try:

.PP

.Vb 1

\& pydoc ranger.api

.Ve

.PP

Note that you should \s-1NOT\s0 simply overwrite a function unless you know what

you're doing. Instead, save the existing function and call it from your new

one. This way, multiple plugins can use the same hook. There are several

sample plugins in the \fI/usr/share/doc/ranger/examples/\fR directory, including a

hello-world plugin that describes this procedure.

.IX Header "KEY BINDINGS"

Key bindings are defined in the file \fI\f(CI%rangerdir\fI/config/rc.conf\fR. Check this

file for a list of all key bindings. You can copy it to your local

configuration directory with the \-\-copy\-config=rc option.

.PP

Many key bindings take an additional numeric argument. Type \fI5j\fR to move

down 5 lines, \fI2l\fR to open a file in mode 2, \fI10<Space>\fR to mark 10 files.

.PP

This list contains the most useful bindings:

.IX Subsection "MAIN BINDINGS"

.IP "h, j, k, l" 14

.IX Item "h, j, k, l"

Move left, down, up or right

.IP "^D or J, ^U or K" 14

.IX Item "^D or J, ^U or K"

Move a half page down, up

.IP "H, L" 14

.IX Item "H, L"

Move back and forward in the history

.IP "gg" 14

.IX Item "gg"

Move to the top

.IP "G" 14

.IX Item "G"

Move to the bottom

.IP "[, ]" 14

Move up and down in the parent directory.

.IP "^R" 14

.IX Item "^R"

Reload everything

.IP "F" 14

.IX Item "F"

Toggle \fIfreeze_files\fR setting. When active (indicated by a cyan \fI\s-1FROZEN\s0\fR

message in the status bar), directories and files will not be loaded, improving

performance when all the files you need are already loaded. This does not

affect file previews, which can be toggled with \fIzI\fR. Also try disabling the

preview of directories with \fIzP\fR.

.IP "^L" 14

.IX Item "^L"

Redraw the screen

.IP "i" 14

.IX Item "i"

Inspect the current file in a bigger window.

.IP "E" 14

.IX Item "E"

Edit the current file in \f(CW$VISUAL\fR otherwise \f(CW$EDITOR\fR otherwise \*(L"vim\*(R"

.IP "S" 14

.IX Item "S"

Open a shell in the current directory

.IP "?" 14

Opens this man page

.IP "W" 14

.IX Item "W"

Opens the log window where you can review messages that pop up at the bottom.

.IP "w" 14

.IX Item "w"

Opens the task window where you can view and modify background processes that

currently run in ranger. In there, you can type \*(L"dd\*(R" to abort a process and

\&\*(L"J\*(R" or \*(L"K\*(R" to change the priority of a process. Only one process is run at a

time.

.IP "^C" 14

.IX Item "^C"

Stop the currently running background process that ranger has started, like

copying files, loading directories or file previews.

.IP "<octal>=, +<who><what>, \-<who><what>" 14

.IX Item "<octal>=, +<who><what>, -<who><what>"

Change the permissions of the selection. For example, \f(CW\*(C`777=\*(C'\fR is equivalent to

\&\f(CW\*(C`chmod 777 %s\*(C'\fR, \f(CW\*(C`+ar\*(C'\fR does \f(CW\*(C`chmod a+r %s\*(C'\fR, \f(CW\*(C`\-ow\*(C'\fR does \f(CW\*(C`chmod o\-w %s\*(C'\fR etc.

.IP "yy" 14

.IX Item "yy"

Copy (yank) the selection, like pressing Ctrl+C in modern \s-1GUI\s0 programs. (You

can also type \*(L"ya\*(R" to add files to the copy buffer, \*(L"yr\*(R" to remove files again,

or \*(L"yt\*(R" for toggling.)

.IP "dd" 14

.IX Item "dd"

Cut the selection, like pressing Ctrl+X in modern \s-1GUI\s0 programs. (There are

also \*(L"da\*(R", \*(L"dr\*(R" and \*(L"dt\*(R" shortcuts equivalent to \*(L"ya\*(R", \*(L"yr\*(R" and \*(L"yt\*(R".)

.IP "pp" 14

.IX Item "pp"

Paste the files which were previously copied or cut, like pressing Ctrl+V in

modern \s-1GUI\s0 programs.

.IP "po" 14

.IX Item "po"

Paste the copied/cut files, overwriting existing files.

.IP "pP, pO" 14

.IX Item "pP, pO"

Like pp and po, but queues the operation so that it will be executed \fIafter\fR

any other operations. Reminder: type \f(CW\*(C`w\*(C'\fR to open the task window.

.IP "pl, pL" 14

.IX Item "pl, pL"

Create symlinks (absolute or relative) to the copied files

.IP "phl" 14

.IX Item "phl"

Create hardlinks to the copied files

.IP "pht" 14

.IX Item "pht"

Duplicate the subdirectory tree of the copied directory, then create

hardlinks for each contained file into the new directory tree.

.IP "m\fIX\fR" 14

.IX Item "mX"

Create a bookmark with the name \fIX\fR

.IP "`\fIX\fR" 14

.IX Item "`X"

Move to the bookmark with the name \fIX\fR

.IP "n" 14

.IX Item "n"

Find the next file. By default, this gets you to the newest file in the

directory, but if you search something using the keys /, cm, ct, ..., it will

get you to the next found entry.

.IP "N" 14

.IX Item "N"

Find the previous file.

.IP "o\fIX\fR" 14

.IX Item "oX"

Change the sort method (like in mutt)

.IP "z\fIX\fR" 14

.IX Item "zX"

Change settings. See the settings section for a list of settings and their

hotkey.

.IP "u\fI?\fR" 14

.IX Item "u?"

Universal undo-key. Depending on the key that you press after \*(L"u\*(R", it either

restores closed tabs (uq), removes tags (ut), clears the copy/cut buffer (ud),

starts the reversed visual mode (uV) or clears the selection (uv).

.IP "f" 14

.IX Item "f"

Quickly navigate by entering a part of the filename.

.IP "Space" 14

.IX Item "Space"

Mark a file.

.IP "v" 14

.IX Item "v"

Toggle the mark-status of all files

.IP "V" 14

.IX Item "V"

Starts the visual mode, which selects all files between the starting point and

the cursor until you press \s-1ESC.\s0 To unselect files in the same way, use \*(L"uV\*(R".

.IP "/" 14

Search for files in the current directory.

.IP ":" 14

Open the console.

.IP "!" 14

Open the console with the content \*(L"shell \*(R" so you can quickly run commands

.IP "@" 14

Open the console with the content \*(L"shell \f(CW%s\fR\*(R", placing the cursor before the

\&\*(L" \f(CW%s\fR\*(R" so you can quickly run commands with the current selection as the

argument.

.IP "r" 14

.IX Item "r"

Open the console with the content \*(L"open with \*(R" so you can decide which program

to use to open the current file selection.

.IP "cd" 14

.IX Item "cd"

Open the console with the content \*(L"cd \*(R"

.IP "^P" 14

.IX Item "^P"

Open the console with the most recent command.

.IP "Alt\-\fIN\fR" 14

.IX Item "Alt-N"

Open a tab. N has to be a number from 0 to 9. If the tab doesn't exist yet, it

will be created.

.IP "gn, ^N" 14

.IX Item "gn, ^N"

Create a new tab.

.IP "gt, gT" 14

.IX Item "gt, gT"

Go to the next or previous tab. You can also use \s-1TAB\s0 and \s-1SHIFT+TAB\s0 instead.

.IP "gc, ^W" 14

.IX Item "gc, ^W"

Close the current tab. The last tab cannot be closed this way.

.IP "M" 14

.IX Item "M"

A key chain that allows you to quickly change the line mode of all the files of

the current directory. For a more permanent solution, use the command

\&\*(L"default_linemode\*(R" in your rc.conf.

.IP ".n" 14

.IX Item ".n"

Apply a new filename filter.

.IP ".m" 14

.IX Item ".m"

Apply a new mimetype filter.

.IP ".d" 14

.IX Item ".d"

Apply the typefilter \*(L"directory\*(R".

.IP ".f" 14

.IX Item ".f"

Apply the typefilter \*(L"file\*(R".

.IP ".l" 14

.IX Item ".l"

Apply the typefilter \*(L"symlink\*(R".

.IP ".|" 14

Combine the two topmost filters from the filter stack in the \*(L"\s-1OR\*(R"\s0

relationship, instead of the \*(L"\s-1AND\*(R"\s0 used implicitly.

.IP ".&" 14

Explicitly combine the two topmost filters in the \*(L"\s-1AND\*(R"\s0

relationship. Usually not needed though might be useful in more

complicated scenarios.

.IP ".!" 14

Negate the topmost filter.

.IP ".r" 14

.IX Item ".r"

Rotate the filter stack by N elements. Just confirm with enter to

rotate by 1, i.e. move the topmost element to the bottom of the stack.

.IP ".c" 14

.IX Item ".c"

Clear the filter stack.

.IP ".*" 14

Decompose the topmost filter combinator (e.g. \f(CW\*(C`.!\*(C'\fR, \f(CW\*(C`.|\*(C'\fR).

.IP ".p" 14

.IX Item ".p"

Pop the topmost filter from the filter stack.

.IP ".." 14

Show the current filter stack state.

.IX Subsection "READLINE-LIKE BINDINGS IN THE CONSOLE"

.IP "^B, ^F" 14

.IX Item "^B, ^F"

Move left and right (B for back, F for forward)

.IP "^P, ^N" 14

.IX Item "^P, ^N"

Move up and down (P for previous, N for Next)

.IP "^A, ^E" 14

.IX Item "^A, ^E"

Move to the start or to the end

.IP "Alt-B, Alt-LEFT" 14

.IX Item "Alt-B, Alt-LEFT"

Move backwards by words.

.IP "Alt-F, Alt-RIGHT" 14

.IX Item "Alt-F, Alt-RIGHT"

Move forwards by words.

.IP "^D" 14

.IX Item "^D"

Delete the current character.

.IP "^H" 14

.IX Item "^H"

Backspace.

.IX Header "MOUSE BUTTONS"

.IP "Left Mouse Button" 4

.IX Item "Left Mouse Button"

Click on something and you'll move there. To run a file, \*(L"enter\*(R" it, like a

directory, by clicking on the preview.

.IP "Right Mouse Button" 4

.IX Item "Right Mouse Button"

Enter a directory or run a file.

.IP "Scroll Wheel" 4

.IX Item "Scroll Wheel"

Scrolls up or down. You can point at the column of the parent directory while

scrolling to switch directories.

.IX Header "SETTINGS"

This section lists all built-in settings of ranger. The valid types for the

value are in [brackets]. The hotkey to toggle the setting is in <brakets>, if

a hotkey exists.

.PP

Settings can be changed in the file \fI~/.config/ranger/rc.conf\fR or on the

fly with the command \fB:set option value\fR. Examples:

.PP

.Vb 2

\& set column_ratios 1,2,3

\& set show_hidden true

.Ve

.PP

Toggling options can be done with:

.PP

.Vb 1

\& set show_hidden!

.Ve

.PP

The different types of settings and an example for each type:

.PP

.Vb 7

\& setting type | example values

\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

\& bool | true, false

\& integer | 1, 23, 1337

\& string | foo, hello world

\& list | 1,2,3,4

\& none | none

.Ve

.PP

You can view a list of all settings and their current values by pressing \*(L"3?\*(R"

in ranger.

.IP "automatically_count_files [bool]" 4

.IX Item "automatically_count_files [bool]"

Should ranger count and display the number of files in each directory

as soon as it's visible? This gets slow with remote file systems. Turning it

off will still allow you to see the number of files after entering the

directory.

.IP "autosave_bookmarks [bool]" 4

.IX Item "autosave_bookmarks [bool]"

Save bookmarks (used with mX and `X) instantly? This helps to synchronize

bookmarks between multiple ranger instances but leads to *slight* performance

loss. When false, bookmarks are saved when ranger is exited.

.IP "autoupdate_cumulative_size [bool]" 4

.IX Item "autoupdate_cumulative_size [bool]"

You can display the \*(L"real\*(R" cumulative size of directories by using the command

:get_cumulative_size or typing \*(L"dc\*(R". The size is expensive to calculate and

will not be updated automatically. You can choose to update it automatically

though by turning on this option.

.IP "cd_bookmarks [bool]" 4

.IX Item "cd_bookmarks [bool]"

Specify whether bookmarks should be included in the tab completion of the \*(L"cd\*(R"

command.

.IP "cd_tab_case [string]" 4

.IX Item "cd_tab_case [string]"

Changes case sensitivity for the \*(L"cd\*(R" command tab completion. Possible values are:

.Sp

.Vb 3

\& sensitive

\& insensitive

\& smart

.Ve

.IP "cd_tab_fuzzy [bool]" 4

.IX Item "cd_tab_fuzzy [bool]"

Use fuzzy tab completion with the \*(L"cd\*(R" command. For example,