literate-dotfiles/dotfiles/ranger.org

#+TITLE: Ranger Configuration

* Config
  :PROPERTIES:
  :header-args: :tangle ~/.config/ranger/rc.conf
  :header-args+: :comments both :mkdirp yes
  :END:

** Options
#+BEGIN_SRC conf
# 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
#set viewmode multipane

# How many columns are there, and what are their relative widths?
set column_ratios 1,3,4

# Which files should be hidden? (regular expression)
#set hidden_filter ^\.|\.(?:pyc|pyo|bak|swp)$|^lost\+found$|^__(py)?cache__$
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 ~/.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
# like feh or sxiv?  You can still open selected files by marking them.
# TODO
set open_all_images true

# Be aware of version control systems and display information.
set vcs_aware false

# State of the three backends git, hg, bzr. The possible states are
# disabled, local (only show local info), enabled (show local and remote
# information).
set vcs_backend_git enabled
set vcs_backend_hg disabled
set vcs_backend_bzr disabled

# Use one of the supported image preview protocols
set preview_images true

# Set the preview image method
# TODO
set preview_images_method w3m

# Use a unicode "..." character to mark cut-off filenames?
set unicode_ellipsis false

# Show dotfiles in the bookmark preview box?
set show_hidden_bookmarks true

# Which colorscheme to use?  These colorschemes are available by default:
# default, jungle, snow, solarized
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

# Save the console history on exit?
set save_console_history false

# 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 true

# Display files tags in all columns or only in main column?
set display_tags_in_all_columns true

# Set a title for the window?
set update_title false

# Set the title to "ranger" in the tmux program?
set update_tmux_title false

# 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

# 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.
set autosave_bookmarks false

# You can display the "real" cumulative size of directories by using the
# command :get_cumulative_size or typing "dc".  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:
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 0

# 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
#+END_SRC

** Command Aliases in the Console
#+BEGIN_SRC conf
alias e    edit
alias q    quit
alias q!   quitall
alias qa   quitall
alias qall quitall
alias setl setlocal

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
#+END_SRC

** Some Custom Keybindings
*** Extract
#+BEGIN_SRC conf
  map ,x shell atool -x %f
#+END_SRC

*** Compress
#+BEGIN_SRC conf
map ,z shell apack %f.zip %f
#+END_SRC

*** Delete first page of pdf
#+BEGIN_SRC conf
  map ,d shell ~/scripts/pdf-delete-first-page.sh %f
#+END_SRC

*** Magit Status
#+BEGIN_SRC conf
  map ,gs shell emacsclient -create-frame --alternate-editor="" --eval '(magit-status)'
#+END_SRC

*** Upload with Tansfer.sh
#+BEGIN_SRC conf
  map ,t shell curl --progress-bar --upload-file %f https://transfer.sh/$(basename $1) | xclip -in -selection clipboard;
#+END_SRC

*** Open current folder with PCManFM
#+begin_src conf
  map ,o shell nohup pcmanfm %d &
#+end_src

** Define keys for the browser
*** Basic
#+BEGIN_SRC conf
  map     Q quit!
  map     q quit
  copymap q ZZ ZQ

  map R     reload_cwd
  map <C-r> reset
  map <C-l> redraw_window
  map <C-c> abort
  map <esc> change_mode normal
  map ~ set viewmode!

  map i display_file
  map ? help
  map W display_log
  map w taskview_open

  map : console
  map ; console
  map ! console shell%space
  map @ console -p6 shell  %%s
  map # console shell -p%space
#+END_SRC

*** Open Shell in current directory
#+BEGIN_SRC conf
  map s shell $SHELL
  # Open External Shell in current directory
  map S shell nohup termite &

  map r chain draw_possible_programs; console open_with%%space
#+END_SRC

*** Print on Rnice
#+BEGIN_SRC conf
  map ,p shell print-rnice %f &
#+END_SRC

*** Filter
#+BEGIN_SRC conf
  map f console filter%space
  # Reset filter
  map F filter
#+END_SRC

*** Change the line mode
#+BEGIN_SRC conf
  map Mf linemode filename
  map Mi linemode fileinfo
  map Mm linemode mtime
  map Mp linemode permissions
  map Ms linemode sizemtime
  map Mt linemode metatitle
#+END_SRC

*** Tagging / Marking
#+BEGIN_SRC conf
  map t       tag_toggle
  map ut      tag_remove
  map <Space> mark_files toggle=True
  map v       mark_files all=True toggle=True
  map uv      mark_files all=True val=False
  map V       toggle_visual_mode
  map uV      toggle_visual_mode reverse=True
#+END_SRC

*** VIM-like
#+BEGIN_SRC conf
  copymap <UP>       k
  copymap <DOWN>     j
  copymap <LEFT>     h
  copymap <RIGHT>    l
  copymap <HOME>     gg
  copymap <END>      G
  copymap <PAGEDOWN> <C-F>
  copymap <PAGEUP>   <C-B>
#+END_SRC

*** Jumping around
#+BEGIN_SRC conf
  map H     history_go -1
  map L     history_go 1
  map ]     move_parent 1
  map [     move_parent -1
  map }     traverse
#+END_SRC

*** TODO [#A] Go to special folders
#+BEGIN_SRC conf
  map cd console cd%space

  map gh cd ~
  map gm cd ~/MEGA/These
  map gd cd ~/Downloads
  map gc cd ~/.config/literate-dotfiles/
#+END_SRC

*** External Programs
#+BEGIN_SRC conf
  map E edit
#+END_SRC

*** Get size of folders
#+BEGIN_SRC conf
  # 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
#+END_SRC

*** Yank path of directory/file
#+BEGIN_SRC conf
  # 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
#+END_SRC

*** Filesystem Operations
#+BEGIN_SRC conf
map = chmod
#+END_SRC

*** Drag and Drop
#+BEGIN_SRC conf
  map D shell dragon-drag-and-drop -a -x %p
#+END_SRC

*** TODO Rename
#+BEGIN_SRC conf
  #map cw console rename%space
  map cw eval fm.execute_console("bulkrename") if fm.thisdir.marked_items else fm.open_console("rename ")
#+END_SRC

*** Rename files - like vim bindings
#+BEGIN_SRC conf
  map a  rename_append
  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)
#+END_SRC

*** Paste files
#+BEGIN_SRC conf
  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
#+END_SRC

*** Delete and move files
#+BEGIN_SRC conf
  map dD console delete
  map dd cut
  map ud uncut
  map da cut mode=add
  map dr cut mode=remove
  map dt cut mode=toggle
#+END_SRC

*** Copy files
#+BEGIN_SRC conf
  map yy copy
  map uy uncut
  map ya copy mode=add
  map yr copy mode=remove
  map yt copy mode=toggle
#+END_SRC

*** Temporary workarounds
#+BEGIN_SRC conf
  map dgg eval fm.cut(dirarg=dict(to=0), narg=quantifier)
  map dG  eval fm.cut(dirarg=dict(to=-1), narg=quantifier)
  map dj  eval fm.cut(dirarg=dict(down=1), narg=quantifier)
  map dk  eval fm.cut(dirarg=dict(up=1), narg=quantifier)
  map ygg eval fm.copy(dirarg=dict(to=0), narg=quantifier)
  map yG  eval fm.copy(dirarg=dict(to=-1), narg=quantifier)
  map yj  eval fm.copy(dirarg=dict(down=1), narg=quantifier)
  map yk  eval fm.copy(dirarg=dict(up=1), narg=quantifier)
#+END_SRC

*** Searching
#+BEGIN_SRC conf
  map /  console search%space
  map n  search_next
  map N  search_next forward=False
  map ct search_next order=tag
  map cs search_next order=size
  map ci search_next order=mimetype
  map cc search_next order=ctime
  map cm search_next order=mtime
  map ca search_next order=atime
#+END_SRC

*** Tabs
#+BEGIN_SRC conf
  map <C-n>     tab_new ~
  map <C-w>     tab_close
  map <TAB>     tab_move 1
  map <S-TAB>   tab_move -1
  map <A-Right> tab_move 1
  map <A-Left>  tab_move -1
  map gt        tab_move 1
  map gT        tab_move -1
  map gn        tab_new ~
  map gc        tab_close
  map uq        tab_restore
  map <a-1>     tab_open 1
  map <a-2>     tab_open 2
  map <a-3>     tab_open 3
  map <a-4>     tab_open 4
  map <a-5>     tab_open 5
  map <a-6>     tab_open 6
  map <a-7>     tab_open 7
  map <a-8>     tab_open 8
  map <a-9>     tab_open 9
#+END_SRC

*** Sorting
#+BEGIN_SRC conf
  map or set sort_reverse!
  map oz set sort=random
  map os chain set sort=size;      set sort_reverse=False
  map ob chain set sort=basename;  set sort_reverse=False
  map on chain set sort=natural;   set sort_reverse=False
  map om chain set sort=mtime;     set sort_reverse=False
  map oc chain set sort=ctime;     set sort_reverse=False
  map oa chain set sort=atime;     set sort_reverse=False
  map ot chain set sort=type;      set sort_reverse=False
  map oe chain set sort=extension; set sort_reverse=False

  map oS chain set sort=size;      set sort_reverse=True
  map oB chain set sort=basename;  set sort_reverse=True
  map oN chain set sort=natural;   set sort_reverse=True
  map oM chain set sort=mtime;     set sort_reverse=True
  map oC chain set sort=ctime;     set sort_reverse=True
  map oA chain set sort=atime;     set sort_reverse=True
  map oT chain set sort=type;      set sort_reverse=True
  map oE chain set sort=extension; set sort_reverse=True

  map dc get_cumulative_size
#+END_SRC

*** Settings
#+BEGIN_SRC conf
  map zc    set collapse_preview!
  map zd    set sort_directories_first!
  map zh    set show_hidden!
  map <C-h> set show_hidden!
  map zI    set flushinput!
  map zi    set preview_images!
  map zm    set mouse_enabled!
  map zp    set preview_files!
  map zP    set preview_directories!
  map zs    set sort_case_insensitive!
  map zu    set autoupdate_cumulative_size!
  map zv    set use_preview_script!
  map zf    console filter%space
#+END_SRC

*** Bookmarks
#+BEGIN_SRC conf
  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>
#+END_SRC

*** Custom Mapping
#+BEGIN_SRC conf
  map <C-f> fzf_select
#+END_SRC

*** Generate all the chmod bindings with some python help:
#+BEGIN_SRC conf
  eval for arg in "rwxXst": cmd("map +u{0} shell -f chmod u+{0} %s".format(arg))
  eval for arg in "rwxXst": cmd("map +g{0} shell -f chmod g+{0} %s".format(arg))
  eval for arg in "rwxXst": cmd("map +o{0} shell -f chmod o+{0} %s".format(arg))
  eval for arg in "rwxXst": cmd("map +a{0} shell -f chmod a+{0} %s".format(arg))
  eval for arg in "rwxXst": cmd("map +{0}  shell -f chmod u+{0} %s".format(arg))

  eval for arg in "rwxXst": cmd("map -u{0} shell -f chmod u-{0} %s".format(arg))
  eval for arg in "rwxXst": cmd("map -g{0} shell -f chmod g-{0} %s".format(arg))
  eval for arg in "rwxXst": cmd("map -o{0} shell -f chmod o-{0} %s".format(arg))
  eval for arg in "rwxXst": cmd("map -a{0} shell -f chmod a-{0} %s".format(arg))
  eval for arg in "rwxXst": cmd("map -{0}  shell -f chmod u-{0} %s".format(arg))
#+END_SRC

** Define keys for the console
*** Basic
#+BEGIN_SRC conf
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>
#+END_SRC

*** Move around
#+BEGIN_SRC conf
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)
cmap <a-left>   eval fm.ui.console.move_word(left=1)
cmap <a-right>  eval fm.ui.console.move_word(right=1)
#+END_SRC

*** Line Editing
#+BEGIN_SRC conf
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 <A-d>        eval fm.ui.console.delete_word(backward=False)
cmap <C-k>        eval fm.ui.console.delete_rest(1)
cmap <C-u>        eval fm.ui.console.delete_rest(-1)
cmap <C-y>        eval fm.ui.console.paste()
#+END_SRC

*** And of course the emacs way
#+BEGIN_SRC conf
copycmap <up>        <C-p>
copycmap <down>      <C-n>
copycmap <left>      <C-b>
copycmap <right>     <C-f>
copycmap <home>      <C-a>
copycmap <end>       <C-e>
copycmap <delete>    <C-d>
copycmap <backspace> <C-h>
#+END_SRC

*** Others
#+BEGIN_SRC conf
# Note: There are multiple ways to express backspaces.  <backspace> (code 263)
# and <backspace2> (code 127).  To be sure, use both.
copycmap <backspace> <backspace2>

# This special expression allows typing in numerals:
cmap <allow_quantifiers> false
#+END_SRC

** Pager Keybindings
*** Movement
#+BEGIN_SRC conf
pmap  <down>      pager_move  down=1
pmap  <up>        pager_move  up=1
pmap  <left>      pager_move  left=4
pmap  <right>     pager_move  right=4
pmap  <home>      pager_move  to=0
pmap  <end>       pager_move  to=-1
pmap  <pagedown>  pager_move  down=1.0  pages=True
pmap  <pageup>    pager_move  up=1.0    pages=True
pmap  <C-d>       pager_move  down=0.5  pages=True
pmap  <C-u>       pager_move  up=0.5    pages=True

copypmap <UP>       k  <C-p>
copypmap <DOWN>     j  <C-n> <CR>
copypmap <LEFT>     h
copypmap <RIGHT>    l
copypmap <HOME>     g
copypmap <END>      G
copypmap <C-d>      d
copypmap <C-u>      u
copypmap <PAGEDOWN> n  f  <C-F>  <Space>
copypmap <PAGEUP>   p  b  <C-B>
#+END_SRC

*** Basic
#+BEGIN_SRC conf
pmap     <C-l> redraw_window
pmap     <ESC> pager_close
copypmap <ESC> q Q i <F3>
pmap E      edit_file
#+END_SRC

** Taskview Keybindings
*** Movement
#+BEGIN_SRC conf
tmap <up>        taskview_move up=1
tmap <down>      taskview_move down=1
tmap <home>      taskview_move to=0
tmap <end>       taskview_move to=-1
tmap <pagedown>  taskview_move down=1.0  pages=True
tmap <pageup>    taskview_move up=1.0    pages=True
tmap <C-d>       taskview_move down=0.5  pages=True
tmap <C-u>       taskview_move up=0.5    pages=True

copytmap <UP>       k  <C-p>
copytmap <DOWN>     j  <C-n> <CR>
copytmap <HOME>     g
copytmap <END>      G
copytmap <C-u>      u
copytmap <PAGEDOWN> n  f  <C-F>  <Space>
copytmap <PAGEUP>   p  b  <C-B>
#+END_SRC

*** Changing priority and deleting tasks
#+BEGIN_SRC conf
tmap J          eval -q fm.ui.taskview.task_move(-1)
tmap K          eval -q fm.ui.taskview.task_move(0)
tmap dd         eval -q fm.ui.taskview.task_remove()
tmap <pagedown> eval -q fm.ui.taskview.task_move(-1)
tmap <pageup>   eval -q fm.ui.taskview.task_move(0)
tmap <delete>   eval -q fm.ui.taskview.task_remove()
#+END_SRC

*** Basic
#+BEGIN_SRC conf
tmap <C-l> redraw_window
tmap <ESC> taskview_close
copytmap <ESC> q Q w <C-c>
default_linemode devicons
#+END_SRC

* Rifle
  :PROPERTIES:
  :header-args: :tangle ~/.config/ranger/rifle.conf
  :header-args+: :comments both :mkdirp yes
  :END:

#+BEGIN_SRC conf
  # 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 vimprobable,    X, flag f = vimprobable -- "$@"
  ext x?html?, has vimprobable2,   X, flag f = vimprobable2 -- "$@"
  ext x?html?, has qutebrowser,	 X, flag f = qutebrowser -- "$@"
  ext x?html?, has chromium,       X, flag f = chromium -- "$@"
  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
  #-------------------------------------------
  # 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 llpp,     X, flag f = llpp "$@"
  ext pdf, has zathura,  X, flag f = zathura -- "$@"
  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 abiword, X, flag f = abiword "$@"

  ext docx?, has catdoc,       terminal = catdoc -- "$@" | "$PAGER"

  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 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 sxiv,      X, flag f = sxiv -- "$@"
  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 "$@"
#+END_SRC
* Ranger Commands
  :PROPERTIES:
  :header-args: :tangle ~/.config/ranger/commands.py
  :header-args+: :comments both :mkdirp yes
  :END:
** Import
#+begin_src python
  from ranger.api.commands import *

  import os
#+end_src

** fzf_select
#+begin_src python
  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)
#+end_src