Ranger Configuration
Table of Contents
Config
Options
# Which viewmode should be used? Possible values are: # miller: Use miller columns which show multiple levels of the hierarchy # multipane: Midnight-commander like multipane view showing all tabs next # to each other set viewmode miller # How many columns are there, and what are their relative widths? set column_ratios 1,1 # Which files should be hidden? (regular expression) set hidden_filter ^\.|\.(?:pyc|vrb|pyo|lof|bak|swp|aux|log|nav|out|snm|toc|bcf|run\.xml|synctex\.gz|blg|bbl)$|^lost\+found$|^__(py)?cache__$ # Show hidden files? You can toggle this by typing 'zh' set show_hidden false # Ask for a confirmation when running the "delete" command? # Valid values are "always", "never", "multiple" (default) # With "multiple", ranger will ask only if you delete multiple files at once. set confirm_on_delete multiple # Which script is used to generate file previews? # ranger ships with scope.sh, a script that calls external programs (see # README.md for dependencies) to preview images, archives, etc. set preview_script /home/thomas/.config/ranger/scope.sh # Use the external preview script or display simple plain text or image previews? set use_preview_script true # Automatically count files in the directory, even before entering them? set automatically_count_files true # Open all images in this directory when running certain image viewers set open_all_images true # Be aware of version control systems and display information. set vcs_aware false # Use one of the supported image preview protocols set preview_images true # Set the preview image method set preview_images_method w3m set colorscheme default # Preview files on the rightmost column? # And collapse (shrink) the last column if there is nothing to preview? set preview_files true set preview_directories true set collapse_preview true # Draw the status bar on top of the browser window (default: bottom) set status_bar_on_top false # Draw a progress bar in the status bar which displays the average state of all # currently running tasks which support progress bars? set draw_progress_bar_in_status_bar true # Draw borders around columns? set draw_borders true # Display the directory name in tabs? set dirname_in_tabs false # Enable the mouse support? set mouse_enabled true # Display the file size in the main column or status bar? set display_size_in_main_column true set display_size_in_status_bar false # Display files tags in all columns or only in main column? set display_tags_in_all_columns false # Set a title for the window? set update_title false # Set the title to "ranger" in the tmux program? set update_tmux_title true # Shorten the title if it gets long? The number defines how many # directories are displayed at once, 0 turns off this feature. set shorten_title 3 # Abbreviate $HOME with ~ in the titlebar (first line) of ranger? set tilde_in_titlebar true # How many directory-changes or console-commands should be kept in history? set max_history_size 20 set max_console_history_size 50 # Try to keep so much space between the top/bottom border when scrolling: set scroll_offset 8 # Flush the input after each key hit? (Noticeable when ranger lags) set flushinput true # Padding on the right when there's no preview? # This allows you to click into the space to run the file. set padding_right true set autosave_bookmarks false set autoupdate_cumulative_size false # Turning this on makes sense for screen readers: set show_cursor false # One of: size, natural, basename, atime, ctime, mtime, type, random set sort natural # Additional sorting options set sort_reverse false set sort_case_insensitive true set sort_directories_first true set sort_unicode false # Enable this if key combinations with the Alt Key don't work for you. # (Especially on xterm) set xterm_alt_key false # Whether to include bookmarks in cd command set cd_bookmarks false # Avoid previewing files larger than this size, in bytes. Use a value of 0 to # disable this feature. set preview_max_size 5000000 # Add the highlighted file to the path in the titlebar set show_selection_in_titlebar true # The delay that ranger idly waits for user input, in milliseconds, with a # resolution of 100ms. Lower delay reduces lag between directory updates but # increases CPU load. set idle_delay 2000 # When the metadata manager module looks for metadata, should it only look for # a ".metadata.json" file in the current directory, or do a deep search and # check all directories above the current one as well? set metadata_deep_search false # Clear all existing filters when leaving a directory set clear_filters_on_dir_change false # Disable displaying line numbers in main column set line_numbers false
Command Aliases in the Console
alias q quit alias filter scout -prt alias find scout -aeit alias mark scout -mr alias unmark scout -Mr alias search scout -rs alias search_inc scout -rts alias travel scout -aefiklst
Some Custom Keybindings
Extract
map ,x shell ~/.config/ranger/scripts/extract.sh %f
Extract Script
if [ $TMUX ]; then tmux split -v -l 2 atool -x $1 && tmux select-pane -U else atool -x $1 fi
Compress
map ,z shell ~/.config/ranger/scripts/compress.sh %f
Compress Script
if [ $TMUX ]; then tmux split -v -l 2 apack ${1%.*}.zip $1 && tmux select-pane -U else apack ${1%.*}.zip $1 fi
Delete first page of pdf
map ,d shell ~/.config/ranger/scripts/pdf-delete-first-page.sh %f
Delete first page of PDF
The requirement is to have pdftk
or stapler
installed.
if [[ -f $1 && $1 == *.pdf ]]; then # Argument if a file if type stapler > /dev/null 2>&1; then stapler del "$1" 1 /tmp/pdftk_out.pdf && mv /tmp/pdftk_out.pdf "$1" elif type pdftk > /dev/null 2>&1; then pdftk "$1" cat 2-end output /tmp/pdftk_out.pdf && mv /tmp/pdftk_out.pdf "$1" else echo "Neither pdftk nor stapler are installed" fi fi
Convert PDF to PNG
map ,cp shell pdftoppm -png %f > $(echo %f | cut -f 1 -d '.' | sed 's/$/.png/')
Magit Status
map ,gs shell emacsclient -create-frame --alternate-editor="" -n --eval '(magit-status)'
Upload with 0x0 (previously Tansfer.sh)
map ,t shell ~/.config/ranger/scripts/upload.sh %f
Upload Script
if [ $TMUX ]; then tmux split -v -l 1 "curl --progress-bar -F\"file=@$1\" https://0x0.st | xsel -ib;" && tmux select-pane -U else curl --progress-bar -F"file=@$1" https://0x0.st | xsel -ib; fi
Open current folder with PCManFM
map ,o shell nohup pcmanfm %d &
Open with Emacs
map ,e shell emacsclient -create-frame --alternate-editor="" -n %f
Print on Rnice
map ,p shell print-rnice %f &
Define keys for the browser
Basic
map Q quit! map q eval fm.execute_console("shell tmux detach") if 'TMUX' in os.environ.keys() else fm.execute_console("quit")
map <C-c> abort map <esc> change_mode normal map ~ set viewmode!
map ? help
map : console map ; console
map ! console shell%space
map @ console -p6 shell %%s
Open Shell in current directory
map s shell $SHELL map S shell nohup $TERMINAL &
Open With
map O chain draw_possible_programs; console open_with%space
Filter
map f console filter%space # Reset filter map F filter
Tagging / Marking
map <Space> mark_files toggle=True map v mark_files all=True toggle=True
VIM-like
copymap <UP> k copymap <DOWN> j copymap <LEFT> h copymap <RIGHT> l copymap <HOME> gg copymap <END> G
Jumping around
map H history_go -1
map L history_go 1
map ] move_parent 1
map [ move_parent -1
map } traverse
map cd console cd%space
Go to special folders
map gh cd ~ map ga cd ~/Cloud/administratif map gm cd ~/Cloud/thesis map gp cd ~/Pictures map gT cd ~/.local/share/Trash/files map gd cd ~/Downloads map gc cd ~/.config/literate-dotfiles
Get size of folders
# Get size of all folders map du shell -p du --max-depth=1 -h --apparent-size # Get size of all folders and sort them map dU shell -p du --max-depth=1 -h --apparent-size | sort -rh
Yank path of directory/file
# Yank path of current directory/file map yp shell -f echo -n %d/%f | xsel -i; xsel -o | xsel -i -b # Yank path of directory map yd shell -f echo -n %d | xsel -i; xsel -o | xsel -i -b # Yank filename map yn shell -f echo -n %f | xsel -i; xsel -o | xsel -i -b
Drag and Drop
map D shell dragon-drag-and-drop -a -x %p
Rename files
map a rename_append map C eval fm.execute_console("bulkrename") if fm.thisdir.marked_items else fm.open_console("rename ") map A eval fm.open_console('rename ' + fm.thisfile.relative_path.replace("%", "%%")) map I eval fm.open_console('rename ' + fm.thisfile.relative_path.replace("%", "%%"), position=7)
Paste files
map pp paste map po paste overwrite=True map pP paste append=True map pO paste overwrite=True append=True map pl paste_symlink relative=False map pL paste_symlink relative=True map phl paste_hardlink map pht paste_hardlinked_subtree
Delete and move files
map dD shell -s trash-put %s map dd cut map du uncut
Copy files
map yy copy map yu uncut
Searching
map / console search%space
map n search_next
map N search_next forward=False
Tabs
map <C-n> tab_new ~ map <C-w> tab_close map <TAB> tab_move 1 map <S-TAB> tab_move -1 map gn tab_new ~ map gt tab_move 1
Settings
map zh set show_hidden! map zi set preview_images! map zv set use_preview_script!
Bookmarks
map `<any> enter_bookmark %any map '<any> enter_bookmark %any map m<any> set_bookmark %any map um<any> unset_bookmark %any map m<bg> draw_bookmarks copymap m<bg> um<bg> `<bg> '<bg>
FZF
map <C-f> fzf_select
Define keys for the console
Basic
cmap <tab> eval fm.ui.console.tab() cmap <s-tab> eval fm.ui.console.tab(-1) cmap <ESC> eval fm.ui.console.close() cmap <CR> eval fm.ui.console.execute() cmap <C-l> redraw_window copycmap <ESC> <C-c> copycmap <CR> <C-j>
Move around
cmap <up> eval fm.ui.console.history_move(-1) cmap <down> eval fm.ui.console.history_move(1) cmap <left> eval fm.ui.console.move(left=1) cmap <right> eval fm.ui.console.move(right=1) cmap <home> eval fm.ui.console.move(right=0, absolute=True) cmap <end> eval fm.ui.console.move(right=-1, absolute=True)
Line Editing
cmap <backspace> eval fm.ui.console.delete(-1)
cmap <delete> eval fm.ui.console.delete(0)
cmap <C-w> eval fm.ui.console.delete_word()
cmap <C-y> eval fm.ui.console.paste()
copycmap <home> <C-a>
copycmap <end> <C-e>
Rifle
# This is the configuration file of "rifle", ranger's file executor/opener. # Each line consists of conditions and a command. For each line the conditions # are checked and if they are met, the respective command is run. # # Syntax: # <condition1> , <condition2> , ... = command # # The command can contain these environment variables: # $1-$9 | The n-th selected file # $@ | All selected files # # If you use the special command "ask", rifle will ask you what program to run. # # Prefixing a condition with "!" will negate its result. # These conditions are currently supported: # match <regexp> | The regexp matches $1 # ext <regexp> | The regexp matches the extension of $1 # mime <regexp> | The regexp matches the mime type of $1 # name <regexp> | The regexp matches the basename of $1 # path <regexp> | The regexp matches the absolute path of $1 # has <program> | The program is installed (i.e. located in $PATH) # env <variable> | The environment variable "variable" is non-empty # file | $1 is a file # directory | $1 is a directory # number <n> | change the number of this command to n # terminal | stdin, stderr and stdout are connected to a terminal # X | $DISPLAY is not empty (i.e. Xorg runs) # # There are also pseudo-conditions which have a "side effect": # flag <flags> | Change how the program is run. See below. # label <label> | Assign a label or name to the command so it can # | be started with :open_with <label> in ranger # | or `rifle -p <label>` in the standalone executable. # else | Always true. # # Flags are single characters which slightly transform the command: # f | Fork the program, make it run in the background. # | New command = setsid $command >& /dev/null & # r | Execute the command with root permissions # | New command = sudo $command # t | Run the program in a new terminal. If $TERMCMD is not defined, # | rifle will attempt to extract it from $TERM. # | New command = $TERMCMD -e $command # Note: The "New command" serves only as an illustration, the exact # implementation may differ. # Note: When using rifle in ranger, there is an additional flag "c" for # only running the current file even if you have marked multiple files. #------------------------------------------- # Websites #------------------------------------------- # Rarely installed browsers get higher priority; It is assumed that if you # install a rare browser, you probably use it. Firefox/konqueror/w3m on the # other hand are often only installed as fallback browsers. ext x?html?, has qutebrowser, X, flag f = qutebrowser -- "$@" ext x?html?, has firefox, X, flag f = firefox -- "$@" ext x?html?, has elinks, terminal = elinks "$@" ext x?html?, has links2, terminal = links2 "$@" ext x?html?, has links, terminal = links "$@" ext x?html?, has lynx, terminal = lynx -- "$@" ext x?html?, has w3m, terminal = w3m "$@" #Spreadsheets for scim ext sc|csv|sxc|xlsx?|xlt|xlw|gnm|gnumeric, = sc-im -- "$@" #------------------------------------------- # Misc #------------------------------------------- ext org = emacsclient -c "$1" # Define the "editor" for text files as first action mime ^text, label editor = $EDITOR -- "$@" mime ^text, label pager = "$PAGER" -- "$@" !mime ^text, label editor, ext xml|json|csv|tex|py|pl|rb|js|sh|php = $EDITOR -- "$@" !mime ^text, label pager, ext xml|json|csv|tex|py|pl|rb|js|sh|php = "$PAGER" -- "$@" ext 1 = man "$1" ext s[wmf]c, has zsnes, X = zsnes "$1" ext s[wmf]c, has snes9x-gtk,X = snes9x-gtk "$1" ext nes, has fceux, X = fceux "$1" ext exe = wine "$1" name ^[mM]akefile$ = make #-------------------------------------------- # Code #------------------------------------------- ext py = python -- "$1" ext pl = perl -- "$1" ext rb = ruby -- "$1" ext js = node -- "$1" ext sh = sh -- "$1" ext php = php -- "$1" #-------------------------------------------- # Video/Audio with a GUI #------------------------------------------- mime ^video, has mpv, X, flag f = mpv -- "$@" mime ^video, has mpv, X, flag f = mpv --fs -- "$@" mime ^video, has mpv, X, flag f = mpv --loop -- "$@" #-------------------------------------------- # Audio without X #------------------------------------------- mime ^audio|ogg$, terminal, has mpv = mpv --no-audio-display -- "$@" mime ^audio|ogg$ = tag "$@" mime ^audio|ogg$, terminal, has mpv = mpv -- "$@" #-------------------------------------------- # Video without X: #------------------------------------------- mime ^video, terminal, !X, has mpv = mpv -- "$@" mime ^video, terminal, !X, has mplayer2 = mplayer2 -- "$@" mime ^video, terminal, !X, has mplayer = mplayer -- "$@" #------------------------------------------- # Documents #------------------------------------------- ext pdf, has zathura, X, flag f = zathura -- "$@" ext pdf, has llpp, X, flag f = llpp "$@" ext pdf, has mupdf, X, flag f = mupdf "$@" ext pdf, has mupdf, X, flag f = mupdf -I "$@" ext pdf, has mupdf-x11,X, flag f = mupdf-x11 "$@" ext pdf, has apvlv, X, flag f = apvlv -- "$@" ext pdf, has xpdf, X, flag f = xpdf -- "$@" ext pdf, has evince, X, flag f = evince -- "$@" ext pdf, has atril, X, flag f = atril -- "$@" ext pdf, has okular, X, flag f = okular -- "$@" ext pdf, has epdfview, X, flag f = epdfview -- "$@" ext pdf, has qpdfview, X, flag f = qpdfview "$@" ext epub, has zathura, X, flag f = zathura -- "$@" ext epub, has mupdf, X, flag f = mupdf "$@" ext docx?, has wps, X, flag f = wps "$@" ext docx?, has catdoc, terminal = catdoc -- "$@" | "$PAGER" ext pptx?|od[dfgpst]|docx?|sxc|xlsx?|xlt|xlw|gnm|gnumeric, has wpp, X, flag f = wpp "$@" ext sxc|xlsx?|xlt|xlw|gnm|gnumeric, has gnumeric, X, flag f = gnumeric -- "$@" ext sxc|xlsx?|xlt|xlw|gnm|gnumeric, has kspread, X, flag f = kspread -- "$@" ext pptx?|od[dfgpst]|docx?|sxc|xlsx?|xlt|xlw|gnm|gnumeric, has libreoffice, X, flag f = libreoffice "$@" ext pptx?|od[dfgpst]|docx?|sxc|xlsx?|xlt|xlw|gnm|gnumeric, has soffice, X, flag f = soffice "$@" ext pptx?|od[dfgpst]|docx?|sxc|xlsx?|xlt|xlw|gnm|gnumeric, has ooffice, X, flag f = ooffice "$@" ext djvu, has zathura,X, flag f = zathura -- "$@" ext djvu, has evince, X, flag f = evince -- "$@" ext djvu, has atril, X, flag f = atril -- "$@" #------------------------------------------- # Image Viewing: #------------------------------------------- mime ^image/svg, has inkscape, X, flag f = inkscape -- "$@" mime ^image/svg, has display, X, flag f = display -- "$@" mime ^image/gif, has mpv, X, flag f = mpv --loop -- "$@" mime ^image/gif, has viewnior, X, flag f = viewnior -- "$@" mime ^image/gif, has qutebrowser, X, flag f = qutebrowser -- "$@" ext xcf, X, flag f = gimp -- "$@" mime ^image, has sxiv, X, flag f = sxiv -- "$@" mime ^image, has feh, X, flag f = feh --scale-down --auto-zoom --image-bg black -- "$@" mime ^image, has feh, X, flag f = feh --scale-down --auto-zoom -- "$@" mime ^image, has mirage, X, flag f = mirage -- "$@" mime ^image, has ristretto, X, flag f = ristretto "$@" mime ^image, has eog, X, flag f = eog -- "$@" mime ^image, has eom, X, flag f = eom -- "$@" mime ^image, has gimp, X, flag f = gimp -- "$@" mime ^image, has pinta, X, flag f = pinta -- "$@" mime ^image, has mypaint, X, flag f = mypaint -- "$@" mime ^image, has kolourpaint, X, flag f = kolourpaint -- "$@" #------------------------------------------- # Archives #------------------------------------------- # This requires atool ext jar = java -jar "$@" ext 7z|ace|ar|arc|bz2?|cab|cpio|cpt|deb|dgc|dmg|gz, has als = als -- "$@" | "$PAGER" ext iso|jar|msi|pkg|rar|shar|tar|tgz|xar|xpi|xz|zip, has als = als -- "$@" | "$PAGER" ext 7z|ace|ar|arc|bz2?|cab|cpio|cpt|deb|dgc|dmg|gz, has aunpack = aunpack -- "$@" ext iso|jar|msi|pkg|rar|shar|tar|tgz|xar|xpi|xz|zip, has aunpack = aunpack -- "$@" # Fallback: ext tar|gz, has tar = tar vvtf "$@" | "$PAGER" ext tar|gz, has tar = tar vvxf "$@" #------------------------------------------- # Misc #------------------------------------------- label wallpaper, number 11, mime ^image, has feh, X = feh --bg-scale "$1" label wallpaper, number 12, mime ^image, has feh, X = feh --bg-tile "$1" label wallpaper, number 13, mime ^image, has feh, X = feh --bg-center "$1" label wallpaper, number 14, mime ^image, has feh, X = feh --bg-fill "$1" # Define the editor for non-text files + pager as last action !mime ^text, !ext xml|json|csv|tex|py|pl|rb|js|sh|php = ask label editor, !mime ^text, !ext xml|json|csv|tex|py|pl|rb|js|sh|php = $EDITOR -- "$@" label pager, !mime ^text, !ext xml|json|csv|tex|py|pl|rb|js|sh|php = "$PAGER" -- "$@" ext blend, has blender, X, flag f = blender -- "$@" has dragon-drag-and-drop, X, flag f = dragon-drag-and-drop -a -x "$@"
Ranger Commands
Import
from ranger.api.commands import * import os
fzfselect
class fzf_select(Command): """ :fzf_select Find a file using fzf. With a prefix argument select only directories. See: https://github.com/junegunn/fzf """ def execute(self): import subprocess import os.path if self.quantifier: # match only directories command="find -L . \( -path '*/\.*' -o -fstype 'dev' -o -fstype 'proc' \) -prune \ -o -type d -print 2> /dev/null | sed 1d | cut -b3- | fzf +m" else: # match files and directories command="find -L . \( -path '*/\.*' -o -fstype 'dev' -o -fstype 'proc' \) -prune \ -o -print 2> /dev/null | sed 1d | cut -b3- | fzf +m" fzf = self.fm.execute_command(command, universal_newlines=True, stdout=subprocess.PIPE) stdout, stderr = fzf.communicate() if fzf.returncode == 0: fzf_file = os.path.abspath(stdout.rstrip('\n')) if os.path.isdir(fzf_file): self.fm.cd(fzf_file) else: self.fm.select_file(fzf_file)