RANGER(1) ranger RANGER(1) ranger - .SH " (SYNOPSIS)" ranger [--version] [--help] [--debug] [--clean] [--cachedir=directory] [--confdir=directory] [--datadir=directory] [--copy-config=which] [--choosefile=target] [--choosefiles=target] [--choosedir=target] [--selectfile=filepath] [--show-only-dirs] [--list-unused-keys] [--list-tagged-files=tag] [--profile] [--cmd=command] [path ...] (DESCRIPTION) ranger () VI . (RESOURCES) ranger . ranger ? . README . HACKING.md . doc/configs . /usr/share/doc/ranger/config --copy-config ranger . examples ranger ranger . /usr/share/doc/ranger/examples . rifle(1) (file opener) . LINKS . (POSITIONAL ARGUMENTS) path ... () . . (OPTIONS) -d, --debug : ranger (traceback) . / . -c, --clean : ranger . . --cachedir=dir (cache) ranger $XDG_CACHE_HOME ~/.cache/ranger "dir". -r dir, --confdir=dir ranger $XDG_CONFIG_HOME ~/.config/ranger "dir". --datadir=dir ranger $XDG_DATA_HOME ~/.local/share/ranger "dir". --copy-config=file . . : all commands commands_full rc rifle scope. : RANGER_LOAD_DEFAULT_RC=FALSE . : FILES ENVIRONMENT --copy-config=commands . ranger . commands.py --copy-config=commands_full ranger . --choosefile=targetfile ranger . ranger targetfile . --choosefiles=targetfile ranger . ranger targetfile . --choosedir=targetfile ranger . ranger targetfile . --selectfile=targetfile ranger targetfile . (legacy) POSITIONAL ARGUMENTS . --show-only-dirs . --choosedir=targetfile . --list-unused-keys "browser" . curses : "getch()" . --list-tagged-files=tag . : . "*" . --profile (CPU) . --cmd=command . . --version . -h --help ..SH " (CONCEPTS)" ranger . (TAGS) . . "t" "ut" . ("*") " . (PREVIEWS) "use_preview_script" "preview_files" true . %rangerdir/data/scope.sh . . . : - "file" - "chardet" ( Python) - "sudo" << >> ("run as root") - "python-bidi" ( Python) ( ) ( scope.sh): - "img2txt" ( "caca-utils") (ASCII-art) - "w3mimgdisplay" "ueberzug" "mpv" "iTerm2" "kitty" "terminology" "urxvt" - "convert" ( "imagemagick") SVG - "ffmpegthumbnailer" - "highlight" "bat" "pygmentize" - "atool" "bsdtar" "unrar" / "7z" - "bsdtar" "tar" "unrar" "unzip" / "zipinfo" ( "sed") - "lynx" "w3m" "elinks" html - "pdftotext" "mutool" ( "fmt") pdf "pdftoppm" - "djvutxt" DjVu "ddjvu" - "calibre" "epub-thumbnailer" - "transmission-show" BitTorrent - "mediainfo" "exiftool" - "odt2txt" OpenDocument ( odt ods odp sxw) - "python" "jq" JSON - "fontimage" ( ) scope.sh . . "preview_images" true : iTerm2 iTerm2 ssh . "preview_images_method" iterm2 . . . "iterm2_font_width" "iterm2_font_height" . kitty Kitty . PIL ( pillow) . ssh . "preview_images_method" kitty . terminology terminology . . "preview_images_method" terminology . ueberzug Ueberzug . PIL ( pillow) X11 . ( tmux ) tmux Wayland . "preview_images_method" ueberzug . urxvt urxvt pixbuf . ssh . . "preview_images_method" urxvt . urxvt-full urxvt . "preview_images_method" urxvt-full . w3m ssh ( "xterm" "urxvt" ) tmux screen . "w3m" "preview_images_method" w3m . w3m . "w3m_offset" . ..SS " (SELECTION)" " " . :delete . v . Mrk . (MACROS) . %f ( ) %d %s %t %c (cut) %p %f %d %p %s %F %D %P %S (tab) . . (%7s = .) %c . "" (diff) : A (yank) (yy ) B : @diff %c %f (shell-escaped) "shell" . %any %any_path . ( : %any0 %any_path0 %any1 %any_path1...). %any . %any_path . "c" : map c echo %any %any ranger . c . "m" : map m set_bookmark %any %any_path "c" : map c echo %any_path %any_path (paste) / : map p' paste dest=%any_path %rangerdir ranger : alias show_commands shell less %rangerdir/config/commands.py %confdir --confdir . %datadir --datadir . %space . . % %% (escape ). chain . %%space : chain command1; command2%%space.SS " (BOOKMARKS)" m . ` . . vim . ` . "``" . Tab :cd . : ' () ` () . RIFLE rifle ranger . python . $repo/ranger/ext/rifle.py . rifle (out of the box) . rifle.conf . . . ranger "r" "" . rifle "-l" "-p " . $repo/ranger/config/rifle.conf . (FLAGS) . ":open_with" ( "r") ":shell" ( "!") . f (Fork) . "disown" "nohup" Ctrl+C ranger . c r ( sudo) t "shell" : ( ":shell -w df") p (pager) s (Silent). . w Enter rc.conf rifle.conf . . : "ffcccFsf" "cs" . "t" $TERMCMD . $TERM "x-terminal-emulator" "xterm" . : ":open_with c" . ":shell -w df" "df" ranger Enter . (PLUGINS) ranger python ~/.config/ranger/plugins/ ranger (import) . ranger . ranger . commands.py . (hook) . hook_ . grep 'def hook_' -r /path/to/rangers/source : pydoc ranger.api . . . /usr/share/doc/ranger/examples/ hello-world ..SH " (KEY BINDINGS)" %rangerdir/config/rc.conf . . --copy-config=rc . . 5j 2l 10 . : (MAIN BINDINGS) h, j, k, l ^D or J, ^U or K H, L gg G [, ] . ^R F freeze_files. ( FROZEN ) . zI . zP . ^L i . E $VISUAL $EDITOR "vim" S ? (man page) W . w ranger . "dd" "J" "K" . . ^C ranger . =, +, - . "777=" "chmod 777 %s" "+ar" "chmod a+r %s" "-ow" "chmod o-w %s" . yy (yank) Ctrl+C GUI. ( "ya" "yr" "yt" .) dd (cut) Ctrl+X GUI. ( "da" "dr" "dt" "ya" "yr" "yt" .) pp (paste) Ctrl+V GUI. '_' ( ) "file.ext_" "file.ext_0" . "file_.ext" "paste_ext" . po / . pP, pO pp po . : "w" . pl, pL (symlinks) phl (hardlinks) pht . mX X `X X n . / cm ct ... . N . oX ( mutt) zX . . u? (undo) . "u" (uq) (ut) / (ud) (uV) (uv). f . Space . v V (visual mode) ESC . "uV" . / . : . ! "shell " . @ "shell %s" " %s" . r "open with " . cd "cd " ^P . Alt-N . N 0 9 . . Alt-l, Alt-r . gn, ^N . gt, gT . TAB SHIFT+TAB . gc, ^W . . M (line mode) . "default_linemode" rc.conf ..IP ".d" 14 "directory". .f "file". .l "symlink". .m mimetype . .n . .# hash . ." (duplicate) . .' (unique) . .| "OR" "AND" . .& "AND". . .! (NOT) . .r N . N count vim . .c . .* ( ".!" ".|"). .p (Pop) . .. . READLINE (READLINE-LIKE BINDINGS IN THE CONSOLE) ^B, ^F (B F ) ^P, ^N (P N ) ^A, ^E Alt-B, Alt-LEFT . Alt-F, Alt-RIGHT . ^D . ^H (Backspace). (MOUSE BUTTONS) Left Mouse Button . "" . Right Mouse Button . Scroll Wheel . ..SH " (SETTINGS)" ranger . [] . < > . ~/.config/ranger/rc.conf :set option value . : set column_ratios 1,2,3 set show_hidden true : set show_hidden! : setting type | example values ---------------+---------------------------- bool | true, false integer | 1, 23, 1337 string | foo, hello world list | 1,2,3,4 none | none "3?" ranger . automatically_count_files [bool] ranger (remote) . . autosave_bookmarks [bool] ( mX `X) ranger ** . false ranger . autoupdate_cumulative_size [bool] :get_cumulative_size "dc" <<>> . . . cd_bookmarks [bool] (tab completion) "cd" . cd_tab_case [string] "cd" . : sensitive insensitive smart cd_tab_fuzzy [bool] "cd". :cd /u/lo/b :cd /usr/local/bin . clear_filters_on_dir_change [bool] 'true' . collapse_preview [bool] colorscheme [string] : default jungle snow. snow jungle . column_ratios [list] 1,1,1 . 1,1,1,1,4 . confirm_on_delete [string] "delete" "always" () "never" "multiple". "multiple" ranger . dirname_in_tabs [bool] display_size_in_main_column [bool] display_size_in_status_bar [bool] display_free_space_in_status_bar [bool] display_tags_in_all_columns [bool] draw_borders [string] : none outline separators both draw_progress_bar_in_status_bar [bool] flushinput [bool] "j" ranger . . freeze_files [bool] . . global_inode_type_filter [string] filter_inode_type . --choosedir : ranger --choosedir=/tmp/x --cmd='set global_inode_type_filter d' hidden_filter [string] . . set hidden_filter ^\.|~$ hint_collapse_threshold [int] . "..." . hostname_in_titlebar [bool] hostname size_in_bytes [bool] . idle_delay [integer] ( ) ranger . (CPU) . iterm2_font_height [integer] iTerm2 iTerm . iterm2_font_width [integer] iTerm2 iTerm . line_numbers [string] . : false absolute "gg" relative "k" "j" max_console_history_size [integer, none] "none" ..IP "max_history_size [integer, none]" 4 metadata_deep_search [bool] (metadata) ".metadata.json" mouse_enabled [bool] nested_ranger_warning [string] "RANGER_LEVEL" ranger ranger . "true" "false" "error". "error" "--debug" (crash) ranger . one_indexed [bool] . : false true open_all_images [bool] feh sxiv . . padding_right [bool] collapse_preview . preview_directories [bool] preview_files [bool] preview_images [bool] w3mimgpreview preview_images_method [string] . : w3m iterm2 urxvt urxvt-full terminology. PREVIEWS . preview_max_size [int] ( ) . . preview_script [string, none] use_preview_script ranger . relative_current_zero [bool] line_numbers relative true false . save_backtick_bookmark [bool] "`" . "``" . save_console_history [bool] ranger . save_tabs_on_exit [bool] . (stack) . scroll_offset [integer] / . shorten_title [integer] . . show_cursor [bool] show_hidden_bookmarks [bool] () ( ') show_hidden [bool] , <^H> show_selection_in_titlebar [bool] sort_case_insensitive [bool] true "a" "B" ASCII . sort_directories_first [bool] sort_reverse [bool] sort_unicode [bool] sort [string] , , , , , , , , atime basename ctime extension mtime natural type size random . : "oN" Z A. status_bar_on_top [bool] tilde_in_titlebar [bool] $HOME ~ ( ) ranger unicode_ellipsis [bool] "..." "~" bidi_support [bool] (RTL) ( ) BIDI . pip python-bidi . update_title [bool] WM_NAME WM_ICON_NAME . update_tmux_title [bool] window-name tmux/screen "ranger" use_preview_script [bool] preview_script vcs_aware [bool] . vcs : git hg. vcs_backend_git, vcs_backend_hg, vcs_backend_bzr, vcs_backend_svn [string] . : disabled . local . enabled . hg bzr . vcs_msg_length [int] . . viewmode [string] miller ( ) multipane ( ) midnight- commander. w3m_delay [float] w3m. . w3m_offset [int] (offset) . st UXterm urxvt . wrap_plaintext_previews [bool] () . wrap_scroll [bool] - . xterm_alt_key [bool] Alt . ( xterm).SH " (COMMANDS)" ":" . "?c" ranger . <<>> : alias [newcommand] [oldcommand] bulkrename cd [path] chain command1[; command2[; command3...]] chmod octal_number cmap key command console [-pSTARTPOSITION] command copycmap key newkey [newkey2...] copymap key newkey [newkey2...] copypmap key newkey [newkey2...] copytmap key newkey [newkey2...] cunmap keys... default_linemode [path=regexp | tag=tags] linemodename delete echo [text] edit [filename] eval [-q] python_code filter [string] filter_inode_type [dfl] find pattern flat level grep pattern help jump_non [-FLAGS...] linemode linemodename load_copy_buffer map key command mark pattern mark_tag [tags] meta key value mkdir dirname open_with [application] [flags] [mode] pmap key command prompt_metadata [key1 [key2 [...]]] punmap keys... quit quit! quitall quitall! relink newpath rename_append [-FLAGS...] rename newname save_copy_buffer scout [-FLAGS...] pattern search pattern search_inc pattern set option value setintag tags option value setlocal [path=] option value shell [-FLAGS...] command source filename terminal tmap key command touch filename trash travel pattern tunmap keys... unmap keys... unmark pattern unmark_tag [tags] ranger.core.actions.Actions. . . : alias [newcommand] [oldcommand] oldcommand newcommand . bulkrename . . . . cd [path] cd . path . ":cd -" `` . chain command1[; command2[; command3...]] . chmod octal_number . 000 777 . . . . [-+] = . +ar -ow 777= . : man 1 chmod console [-pN] command command . N . copymap key newkey [newkey2 ...] copycmap key newkey [newkey2 ...] copypmap key newkey [newkey2 ...] copytmap key newkey [newkey2 ...] key newkey "browser" . ( ) . copymap j down "down" . console pager taskview "copycmap" "copypmap" "copytmap" . default_linemode [path=regexp | tag=tags] linemodename . linemode . : "permissions": :default_linemode permissions "permissions" "p" "P" : :default_linemode tag=pP permissions ~/books/ "metatitle": :default_linemode path=/home/.*?/books/.* metatitle delete ! () ranger . "confirm_on_delete" . echo text . edit [filename] . eval [-q] python_code . `fm' FM . `p' . "-q" . : :eval fm :eval len(fm.tabs) :eval p("Hello World!") filter [string] string basename . . scout . filter_inode_type [dfl] inode . 'd' . 'f' . 'l' . . . filter_stack [command [args]] . : :filter_stack add type f :filter_stack add duplicate :filter_stack add and :filter_stack add type l :filter_stack add or : .f ." .& .l .| : add FILTER_TYPE [ARGS...] . "AND" . "FILTER_TYPE" : duplicate . . filename NAME NAME (regular expression) . hash PATH PATH . mimetype TYPE MIME . typefilter [d|f|l] "d" "f" "l" (symlinks). unique . and "AND". . not . or "OR" "AND" . pop (pop) . decompose ( ".!" ".|"). rotate [N=1] N . N count vim . clear . show . find pattern ( ) . . ( .) scout . flat level () . -1 . 0 . -2 . grep pattern . help ranger . jump_non [-flags...] . : -r -w linemode linemodename (linemode) . : "filename": "..." "fileinfo": "..." "mtime": "..." ISO "humanreadablemtime": "..." . "sizemtime": "... " ISO "humanreadablesizemtime": "... " . "permissions": " " "metatitle": .metadata.json "filename" . :meta . LinemodeBase . ranger.core.linemode . load_copy_buffer ~/.config/ranger/copy_buffer. ranger . map key command cmap key command pmap key command tmap key command . / . 5j "self.quantifier" . (bind) pager taskview. "cmap" "pmap" "tmap" . mark pattern . scout . mark_tag [tags] . . meta key value . : :meta title The Hitchhiker's Guide to the Galaxy :meta year 1979 "metatitle" Mt . mkdir dirname dirname. open_with [application] [flags] [mode] . flags . mode . "rifle" "r" ranger . (mode) ..IP "prompt_metadata [keys ...]" 2 "meta" . quit . ' ranger `` '' . quit! "quit" . quitall "quit" . quitall! "quitall" . relink newpath (symlink) . . rename newname . . A . rename_append [-flags...] ":rename " . : -a -r save_copy_buffer ~/.config/ranger/copy_buffer . ranger . scout [-flags...] [--] pattern . : -a -e enter -f -g glob -i -k -l "rdme" "readme" -m enter -M enter -p : enter -r (regular expression) -s -i -t -v . ":scout -gpt" :filter globbing . search pattern ( ) . scout . search_inc pattern ( ) . . scout . set option value . . tab . : setting type | example values ---------------+---------------------------- bool | true, false integer | 1, 23, 1337 string | foo, hello world list | 1,2,3,4 none | none setintag tags option value tag . . "v v : setintag v sort ctime setlocal [path=path] option value path. . . path . "path=~/dl" ~/dl ~/dl2 ~/dl/foo. "path=~/dl$" . path : path='~/dl dl$' path="~/dl dl$" shell [-flags] command . flags . source filename ranger . rc.conf : map X chain shell vim -p %confdir/rc.conf %rangerdir/config/rc.conf; \ source %confdir/rc.conf scroll_preview value value . terminal x-terminal-emulator . touch filename filename . trash rifle . rifle trash-cli $XDG_DATA_HOME/ranger-trash ~/.ranger/ranger-trash . delete . () ranger . "confirm_on_delete" . travel pattern . . . ESC . scout . unmap [keys ...] cunmap [keys ...] punmap [keys ...] tunmap [keys ...] "browser" . pager taskview "cunmap" "punmap" "tunmap" . unmark pattern . scout . unmark_tag [tags] . ..SH " (FILES)" ranger $HOME/.config/ranger $XDG_CONFIG_HOME $XDG_CONFIG_HOME/ranger . --copy-config . . rc.conf commands.py colorschemes . . ( : ENVIRONMENT). : . rc.conf commands.py /etc/ranger . ranger --clean . (CONFIGURATION) rc.conf . . commands.py python ":" ranger rc.conf . . commands_full.py --copy-config=commands_full . ranger . rifle.conf "rifle" . scope.sh . use_preview_script preview_files preview_script ranger . colorschemes/ . plugins/ . (STORAGE) bookmarks . /^(.):(.*)$/ . . ranger m ' um . copy_buffer :save_copy_buffer . :load_copy_buffer ranger . history . tagged () . /^(.:)?(.*)$/ . ranger t T . " . (ENVIRONMENT) ranger : RANGER_LEVEL ranger "1" . ranger . RANGER_LOAD_DEFAULT_RC FALSE ranger rc.conf . rc.conf ~/.config/ranger/ . VISUAL "E" . EDITOR . EDITOR VISUAL "E" . "vim" . SHELL ranger :shell "S" . "/bin/sh" . TERMCMD ranger :terminal "t" . "xterm" . BAT_STYLE bat highlight . "bat --list-themes" . PYGMENTIZE_STYLE pygmentize highlight . : python -c 'import pygments.styles; [print(stl) for stl in pygments.styles.get_all_styles()]' HIGHLIGHT_STYLE highlight . "highlight --list-themes" . HIGHLIGHT_TABWIDTH highlight . HIGHLIGHT_OPTIONS highlight . "--style=" "HIGHLIGHT_STYLE" . "--replace-tabs=" "HIGHLIGHT_TABWIDTH" . OPENSCAD_COLORSCHEME openscad . openscad . ranger Tomorrow Night . OPENSCAD_IMGSIZE () openscad . . "1000,1000" . XDG_CONFIG_HOME . $HOME/.config . PYTHONOPTIMIZE python . PYTHONOPTIMIZE=1 ( python -O) python assert . . PYTHONOPTIMIZE=2 ( python -OO) docstring . . W3MIMGDISPLAY_PATH . /usr/lib/w3m/w3mimgdisplay ..SH " (EXAMPLES)" ranger ranger . /usr/share/doc/ranger/examples/ doc/ranger/ . (LICENSE) GNU General Public License 3 ( ) . (LINKS) : : : IRC: #ranger freenode.net ranger git . : git clone git@github.com:ranger/ranger.git (SEE ALSO) rifle(1) (BUGS) : . () ranger : "PYTHONOPTIMIZE= ranger --debug" 2024-11-04 ranger-1.9.4 RANGER(1)