1RANGER(1) General Commands Manual RANGER(1)
2
6 ranger - visual file manager
7
9 ranger [OPTIONS] [FILE]
10
12 Ranger is a file manager with an ncurses frontend written in Python.
13 It is designed to give you a broader overview of the file system by
15 displaying previews and backviews, dividing the screen into several
16 columns. The keybindings are similar to those of other console pro‐
17 grams like vim, mutt or ncmpcpp so the usage will be intuitive and
18 efficient.
19
21 --version
22 Print the version and exit.
23 -h, --help
25 Print a list of options and exit.
26 -d, --debug
28 Activate the debug mode: Whenever an error occurs, ranger will
29 exit and print a full backtrace. The default behaviour is to
30 merely print the name of the exception in the statusbar/log and
31 to try to keep running.
32 -c, --clean
34 Activate the clean mode: Ranger will not access or create any
35 configuration files nor will it leave any traces on your system.
36 This is useful when your configuration is broken, when you want
37 to avoid clutter, etc.
38 --fail-unless-cd
40 Return the exit code 1 if ranger is used to run a file, for
41 example with `ranger --fail-unless-cd filename`. This can be
42 useful for scripts.
43 -r dir, --confdir=dir
45 Define a different configuration directory. The default is
46 $HOME/.ranger.
47 -m n, --mode=n
49 When a filename is supplied, make it run in mode n. Check the
50 documentation for more information on modes.
51 -f flags, --flags=flags
53 When a filename is supplied, make it run with the flags flags.
54 Check the documentation for more information on flags.
55
57 General Keybindings
58 Many keybindings take an additional numeric argument. Type 5j to move
59 down 5 lines, 10<Space> to mark 10 files or 3? to read the third chap‐
60 ter of the documentation.
61 h, j, k, l
63 Move left, down, up, right
64 ^D or J, ^U or K
66 Move a half page down, up
67 H, L Move back and forward in the history
69 gg Move to the top
71 G Move to the bottom
73 ^R Reload everything
75 ^L Redraw the screen
77 S Open a shell in the current directory
79 yy Yank the selection. (mark the files as copied)
81 dd Cut the selection
83 pp Paste the copied/cut files. By default, this will not overwrite
85 existing files. To overwrite them, use po.
86 mX Create a bookmark with the name X
88 `X Move to the bookmark with the name X
90 n, N Find the next file, the previous file. You can define what to
92 look for by typing cX. If nothing is specified, pressing n will
93 get you to the newest file in the directory.
94 oX Change the sort method (like in mutt)
96 zX Change settings
98 f Quickly navigate by entering a part of the filename
100 Space Mark a file
102 v, V Toggle the mark-status of all files, unmark all files
104 / Open the search console
106 : Open the command console
108 ? Opens the help screen with more keybindings and documentation
110 Keybindings for using Tabs
112 Tabs are used to work in different directories in the same Ranger
113 instance.
114 gN Open a tab. N has to be a number from 0 to 9. If the tab doesn't
116 exist yet, it will be created.
117 gn, ^N Create a new tab.
119 gt, gT Go to the next or previous tab. You can also use TAB and
121 SHIFT+TAB.
122 gc, ^W Close the current tab. The last tab cannot be closed.
124 Mouse Usage
126 Left Mouse Button
127 Click on something and you'll move there. To run a file,
128 "enter" it, like a directory, by clicking on the preview.
129 Right Mouse Button
131 Enter a directory
132 Scroll Wheel
134 Scroll
135 Commands
137 :delete
138 Destroy all files in the selection with a roundhouse kick.
139 Ranger will ask for a confirmation if you attempt to delete mul‐
140 tiple (marked) files or non-empty directories.
141 :rename newname
143 Rename the current file. Also try the keybinding A for append‐
144 ing something to a file name.
145 :quit Quit ranger. The current directory will be bookmarked as ' so
147 you can re-enter it by typing `` or '' the next time you start
148 ranger.
149
151 Change the directory after exit
152 A script like this in your bashrc would make you change the directory
153 of your parent shell after exiting ranger:
154 ranger() {
156 command ranger --fail-unless-cd $@ &&
157 cd "$(grep \^\' ~/.ranger/bookmarks | cut -b3-)"
158 }
159
161 The files in ranger/defaults/ can be copied into your configuration
162 directory (by default, this is $HOME/.ranger) and customized according
163 to your wishes. Most files don't have to be copied completely though:
164 Just define those settings you want to add or change and they will
165 override the defauls. Colorschemes can be placed in $HOME/.ranger/col‐
166 orschemes.
167 All configuration is done in Python. Each configuration file should
169 contain sufficient documentation.
170
172 Copyright © 2009, 2010 Roman Zimbelmann
173 This program is free software: you can redistribute it and/or modify it
175 under the terms of the GNU General Public License as published by the
176 Free Software Foundation, either version 3 of the License, or (at your
177 option) any later version.
178 There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
180 PARTICULAR PURPOSE.
181
183 The project page: <http://savannah.nongnu.org/projects/ranger>
184 The mailing list: <http://savannah.nongnu.org/mail/?group=ranger>
186
188 Please report them here and include as much relevant information as
189 possible:
190 <http://savannah.nongnu.org/bugs/?group=ranger>
192 ranger-1.1.2 RANGER(1)