3 # This is the configuration file of "rifle", ranger's file executor/opener.
 
   4 # Each line consists of conditions and a command.  For each line the conditions
 
   5 # are checked and if they are met, the respective command is run.
 
   8 #   <condition1> , <condition2> , ... = command
 
  10 # The command can contain these environment variables:
 
  11 #   $1-$9 | The n-th selected file
 
  12 #   $@    | All selected files
 
  14 # If you use the special command "ask", rifle will ask you what program to run.
 
  16 # Prefixing a condition with "!" will negate its result.
 
  17 # These conditions are currently supported:
 
  18 #   match <regexp> | The regexp matches $1
 
  19 #   ext <regexp>   | The regexp matches the extension of $1
 
  20 #   mime <regexp>  | The regexp matches the mime type of $1
 
  21 #   name <regexp>  | The regexp matches the basename of $1
 
  22 #   path <regexp>  | The regexp matches the absolute path of $1
 
  23 #   has <program>  | The program is installed (i.e. located in $PATH)
 
  24 #   env <variable> | The environment variable "variable" is non-empty
 
  26 #   directory      | $1 is a directory
 
  27 #   number <n>     | change the number of this command to n
 
  28 #   terminal       | stdin, stderr and stdout are connected to a terminal
 
  29 #   X              | A graphical environment is available (darwin, Xorg, or Wayland)
 
  31 # There are also pseudo-conditions which have a "side effect":
 
  32 #   flag <flags>  | Change how the program is run. See below.
 
  33 #   label <label> | Assign a label or name to the command so it can
 
  34 #                 | be started with :open_with <label> in ranger
 
  35 #                 | or `rifle -p <label>` in the standalone executable.
 
  38 # Flags are single characters which slightly transform the command:
 
  39 #   f | Fork the program, make it run in the background.
 
  40 #     |   New command = setsid $command >& /dev/null &
 
  41 #   r | Execute the command with root permissions
 
  42 #     |   New command = sudo $command
 
  43 #   t | Run the program in a new terminal.  If $TERMCMD is not defined,
 
  44 #     | rifle will attempt to extract it from $TERM.
 
  45 #     |   New command = $TERMCMD -e $command
 
  46 # Note: The "New command" serves only as an illustration, the exact
 
  47 # implementation may differ.
 
  48 # Note: When using rifle in ranger, there is an additional flag "c" for
 
  49 # only running the current file even if you have marked multiple files.
 
  51 #-------------------------------------------
 
  53 #-------------------------------------------
 
  54 # Rarely installed browsers get higher priority; It is assumed that if you
 
  55 # install a rare browser, you probably use it.  Firefox/konqueror/w3m on the
 
  56 # other hand are often only installed as fallback browsers.
 
  57 ext x?html?, has surf,             X, flag f = surf -- file://"$1"
 
  58 ext x?html?, has vimprobable,      X, flag f = vimprobable -- "$@"
 
  59 ext x?html?, has vimprobable2,     X, flag f = vimprobable2 -- "$@"
 
  60 ext x?html?, has qutebrowser,      X, flag f = qutebrowser -- "$@"
 
  61 ext x?html?, has dwb,              X, flag f = dwb -- "$@"
 
  62 ext x?html?, has jumanji,          X, flag f = jumanji -- "$@"
 
  63 ext x?html?, has luakit,           X, flag f = luakit -- "$@"
 
  64 ext x?html?, has uzbl,             X, flag f = uzbl -- "$@"
 
  65 ext x?html?, has uzbl-tabbed,      X, flag f = uzbl-tabbed -- "$@"
 
  66 ext x?html?, has uzbl-browser,     X, flag f = uzbl-browser -- "$@"
 
  67 ext x?html?, has uzbl-core,        X, flag f = uzbl-core -- "$@"
 
  68 ext x?html?, has midori,           X, flag f = midori -- "$@"
 
  69 ext x?html?, has opera,            X, flag f = opera -- "$@"
 
  70 ext x?html?, has firefox,          X, flag f = firefox -- "$@"
 
  71 ext x?html?, has seamonkey,        X, flag f = seamonkey -- "$@"
 
  72 ext x?html?, has iceweasel,        X, flag f = iceweasel -- "$@"
 
  73 ext x?html?, has chromium-browser, X, flag f = chromium-browser -- "$@"
 
  74 ext x?html?, has chromium,         X, flag f = chromium -- "$@"
 
  75 ext x?html?, has google-chrome,    X, flag f = google-chrome -- "$@"
 
  76 ext x?html?, has epiphany,         X, flag f = epiphany -- "$@"
 
  77 ext x?html?, has konqueror,        X, flag f = konqueror -- "$@"
 
  78 ext x?html?, has elinks,            terminal = elinks "$@"
 
  79 ext x?html?, has links2,            terminal = links2 "$@"
 
  80 ext x?html?, has links,             terminal = links "$@"
 
  81 ext x?html?, has lynx,              terminal = lynx -- "$@"
 
  82 ext x?html?, has w3m,               terminal = w3m "$@"
 
  84 #-------------------------------------------
 
  86 #-------------------------------------------
 
  87 # Define the "editor" for text files as first action
 
  88 mime ^text,  label editor = ${VISUAL:-$EDITOR} -- "$@"
 
  89 mime ^text,  label pager  = $PAGER -- "$@"
 
  90 !mime ^text, label editor, ext xml|json|csv|tex|py|pl|rb|rs|js|sh|php|dart = ${VISUAL:-$EDITOR} -- "$@"
 
  91 !mime ^text, label pager,  ext xml|json|csv|tex|py|pl|rb|rs|js|sh|php|dart = $PAGER -- "$@"
 
  94 ext s[wmf]c, has zsnes, X     = zsnes "$1"
 
  95 ext s[wmf]c, has snes9x-gtk,X = snes9x-gtk "$1"
 
  96 ext nes, has fceux, X         = fceux "$1"
 
  97 ext exe, has wine             = wine "$1"
 
  98 name ^[mM]akefile$            = make
 
 100 #--------------------------------------------
 
 102 #-------------------------------------------
 
 103 ext py  = python -- "$1"
 
 104 ext pl  = perl -- "$1"
 
 105 ext rb  = ruby -- "$1"
 
 106 ext js  = node -- "$1"
 
 108 ext php = php -- "$1"
 
 109 ext dart = dart run -- "$1"
 
 111 #--------------------------------------------
 
 113 #-------------------------------------------
 
 114 mime ^audio|ogg$, terminal, has mpv      = mpv -- "$@"
 
 115 mime ^audio|ogg$, terminal, has mplayer2 = mplayer2 -- "$@"
 
 116 mime ^audio|ogg$, terminal, has mplayer  = mplayer -- "$@"
 
 117 ext midi?,        terminal, has wildmidi = wildmidi -- "$@"
 
 119 #--------------------------------------------
 
 120 # Video/Audio with a GUI
 
 121 #-------------------------------------------
 
 122 #mime ^video|^audio, has gmplayer, X, flag f = gmplayer -- "$@"
 
 123 #mime ^video|^audio, has smplayer, X, flag f = smplayer "$@"
 
 124 mime ^video,        has mpv,      X, flag f = mpv -- "$@"
 
 125 mime ^video,        has mpv,      X, flag f = mpv --fs -- "$@"
 
 126 mime ^video,        has mplayer2, X, flag f = mplayer2 -- "$@"
 
 127 mime ^video,        has mplayer2, X, flag f = mplayer2 -fs -- "$@"
 
 128 mime ^video,        has mplayer,  X, flag f = mplayer -- "$@"
 
 129 mime ^video,        has mplayer,  X, flag f = mplayer -fs -- "$@"
 
 130 mime ^video|^audio, has vlc,      X, flag f = vlc -- "$@"
 
 131 mime ^video|^audio, has totem,    X, flag f = totem -- "$@"
 
 132 mime ^video|^audio, has totem,    X, flag f = totem --fullscreen -- "$@"
 
 133 mime ^audio,        has tenacity, X, flag f = tenacity -- "$@"
 
 134 ext aup,            has tenacity, X, flag f = tenacity -- "$@"
 
 136 #--------------------------------------------
 
 138 #-------------------------------------------
 
 139 mime ^video, terminal, !X, has mpv       = mpv --video=no -- "$@"
 
 140 mime ^video, terminal, !X, has mplayer2  = mplayer2 -- "$@"
 
 141 mime ^video, terminal, !X, has mplayer   = mplayer -- "$@"
 
 143 #-------------------------------------------
 
 145 #-------------------------------------------
 
 146 ext pdf, has llpp,     X, flag f = llpp "$@"
 
 147 ext pdf, has zathura,  X, flag f = zathura -- "$@"
 
 148 ext pdf, has mupdf,    X, flag f = mupdf "$@"
 
 149 ext pdf, has mupdf-x11,X, flag f = mupdf-x11 "$@"
 
 150 ext pdf, has apvlv,    X, flag f = apvlv -- "$@"
 
 151 ext pdf, has xpdf,     X, flag f = xpdf -- "$@"
 
 152 ext pdf, has evince,   X, flag f = evince -- "$@"
 
 153 ext pdf, has atril,    X, flag f = atril -- "$@"
 
 154 ext pdf, has okular,   X, flag f = okular -- "$@"
 
 155 ext pdf, has epdfview, X, flag f = epdfview -- "$@"
 
 156 ext pdf, has qpdfview, X, flag f = qpdfview "$@"
 
 157 ext pdf, has open,     X, flag f = open "$@"
 
 159 ext sc,    has sc,                    = sc -- "$@"
 
 160 ext docx?, has catdoc,       terminal = catdoc -- "$@" | $PAGER
 
 162 ext                        sxc|xlsx?|xlt|xlw|gnm|gnumeric, has gnumeric,    X, flag f = gnumeric -- "$@"
 
 163 ext                        sxc|xlsx?|xlt|xlw|gnm|gnumeric, has kspread,     X, flag f = kspread -- "$@"
 
 164 ext pptx?|od[dfgpst]|docx?|sxc|xlsx?|xlt|xlw|gnm|gnumeric, has libreoffice, X, flag f = libreoffice "$@"
 
 165 ext pptx?|od[dfgpst]|docx?|sxc|xlsx?|xlt|xlw|gnm|gnumeric, has soffice,     X, flag f = soffice "$@"
 
 166 ext pptx?|od[dfgpst]|docx?|sxc|xlsx?|xlt|xlw|gnm|gnumeric, has ooffice,     X, flag f = ooffice "$@"
 
 168 ext djvu, has zathura,X, flag f = zathura -- "$@"
 
 169 ext djvu, has evince, X, flag f = evince -- "$@"
 
 170 ext djvu, has atril,  X, flag f = atril -- "$@"
 
 171 ext djvu, has djview, X, flag f = djview -- "$@"
 
 173 ext epub, has ebook-viewer, X, flag f = ebook-viewer -- "$@"
 
 174 ext epub, has zathura,      X, flag f = zathura -- "$@"
 
 175 ext epub, has mupdf,        X, flag f = mupdf -- "$@"
 
 176 ext mobi, has ebook-viewer, X, flag f = ebook-viewer -- "$@"
 
 178 ext cb[rz], has qcomicbook, X, flag f = qcomicbook "$@"
 
 179 ext cb[rz], has mcomix,     X, flag f = mcomix -- "$@"
 
 180 ext cb[rz], has zathura,    X, flag f = zathura -- "$@"
 
 181 ext cb[rz], has atril,      X, flag f = atril -- "$@"
 
 183 ext sla,  has scribus,      X, flag f = scribus -- "$@"
 
 185 #-------------------------------------------
 
 187 #-------------------------------------------
 
 188 mime ^image/svg, has inkscape, X, flag f = inkscape -- "$@"
 
 189 mime ^image/svg, has display,  X, flag f = display -- "$@"
 
 191 mime ^image, has imv,       X, flag f = imv -- "$@"
 
 192 mime ^image, has pqiv,      X, flag f = pqiv -- "$@"
 
 193 mime ^image, has sxiv,      X, flag f = sxiv -- "$@"
 
 194 mime ^image, has feh,       X, flag f, !ext gif = feh -- "$@"
 
 195 mime ^image, has mirage,    X, flag f = mirage -- "$@"
 
 196 mime ^image, has ristretto, X, flag f = ristretto "$@"
 
 197 mime ^image, has eog,       X, flag f = eog -- "$@"
 
 198 mime ^image, has eom,       X, flag f = eom -- "$@"
 
 199 mime ^image, has nomacs,    X, flag f = nomacs -- "$@"
 
 201 #mime ^image, has geeqie,    X, flag f = geeqie -- "$@"
 
 202 mime ^image, has gpicview,  X, flag f = gpicview -- "$@"
 
 203 mime ^image, has gwenview,  X, flag f = gwenview -- "$@"
 
 204 mime ^image, has mcomix,    X, flag f = mcomix -- "$@"
 
 205 mime ^image, has gimp,      X, flag f = gimp -- "$@"
 
 206 mime ^image, has krita,     X, flag f = krita -- "$@"
 
 207 ext kra,     has krita,     X, flag f = krita -- "$@"
 
 208 ext xcf,                    X, flag f = gimp -- "$@"
 
 210 #-------------------------------------------
 
 212 #-------------------------------------------
 
 214 # avoid password prompt by providing empty password
 
 215 ext 7z, has 7z = 7z -p l "$@" | $PAGER
 
 216 # This requires atool
 
 217 ext ace|ar|arc|bz2?|cab|cpio|cpt|deb|dgc|dmg|gz,     has atool = atool --list --each -- "$@" | $PAGER
 
 218 ext iso|jar|msi|pkg|rar|shar|tar|tgz|xar|xpi|xz|zip, has atool = atool --list --each -- "$@" | $PAGER
 
 219 ext 7z|ace|ar|arc|bz2?|cab|cpio|cpt|deb|dgc|dmg|gz,  has atool = atool --extract --each -- "$@"
 
 220 ext iso|jar|msi|pkg|rar|shar|tar|tgz|xar|xpi|xz|zip, has atool = atool --extract --each -- "$@"
 
 222 # Listing and extracting archives without atool:
 
 223 ext tar|gz|bz2|xz, has tar = tar vvtf "$1" | $PAGER
 
 224 ext tar|gz|bz2|xz, has tar = for file in "$@"; do tar vvxf "$file"; done
 
 225 ext bz2, has bzip2 = for file in "$@"; do bzip2 -dk "$file"; done
 
 226 ext zip, has unzip = unzip -l "$1" | less
 
 227 ext zip, has unzip = for file in "$@"; do unzip -d "${file%.*}" "$file"; done
 
 228 ext ace, has unace = unace l "$1" | less
 
 229 ext ace, has unace = for file in "$@"; do unace e "$file"; done
 
 230 ext rar, has unrar = unrar l "$1" | less
 
 231 ext rar, has unrar = for file in "$@"; do unrar x "$file"; done
 
 232 ext rar|zip, has qcomicbook, X, flag f = qcomicbook "$@"
 
 233 ext rar|zip, has mcomix,     X, flag f = mcomix -- "$@"
 
 234 ext rar|zip, has zathura,    X, flag f = zathura -- "$@"
 
 236 #-------------------------------------------
 
 238 #-------------------------------------------
 
 239 mime ^font, has fontforge, X, flag f = fontforge "$@"
 
 241 #-------------------------------------------
 
 242 # Flag t fallback terminals
 
 243 #-------------------------------------------
 
 244 # Rarely installed terminal emulators get higher priority; It is assumed that
 
 245 # if you install a rare terminal emulator, you probably use it.
 
 246 # gnome-terminal/konsole/xterm on the other hand are often installed as part of
 
 247 # a desktop environment or as fallback terminal emulators.
 
 248 mime ^ranger/x-terminal-emulator, has terminology = terminology -e "$@"
 
 249 mime ^ranger/x-terminal-emulator, has kitty = kitty -- "$@"
 
 250 mime ^ranger/x-terminal-emulator, has alacritty = alacritty -e "$@"
 
 251 mime ^ranger/x-terminal-emulator, has sakura = sakura -e "$@"
 
 252 mime ^ranger/x-terminal-emulator, has lilyterm = lilyterm -e "$@"
 
 253 #mime ^ranger/x-terminal-emulator, has cool-retro-term = cool-retro-term -e "$@"
 
 254 mime ^ranger/x-terminal-emulator, has termite = termite -x '"$@"'
 
 255 #mime ^ranger/x-terminal-emulator, has yakuake = yakuake -e "$@"
 
 256 mime ^ranger/x-terminal-emulator, has guake = guake -ne "$@"
 
 257 mime ^ranger/x-terminal-emulator, has tilda = tilda -c "$@"
 
 258 mime ^ranger/x-terminal-emulator, has st = st -e "$@"
 
 259 mime ^ranger/x-terminal-emulator, has terminator = terminator -x "$@"
 
 260 mime ^ranger/x-terminal-emulator, has urxvt = urxvt -e "$@"
 
 261 mime ^ranger/x-terminal-emulator, has pantheon-terminal = pantheon-terminal -e "$@"
 
 262 mime ^ranger/x-terminal-emulator, has lxterminal = lxterminal -e "$@"
 
 263 mime ^ranger/x-terminal-emulator, has mate-terminal = mate-terminal -x "$@"
 
 264 mime ^ranger/x-terminal-emulator, has xfce4-terminal = xfce4-terminal -x "$@"
 
 265 mime ^ranger/x-terminal-emulator, has konsole = konsole -e "$@"
 
 266 mime ^ranger/x-terminal-emulator, has gnome-terminal = gnome-terminal -- "$@"
 
 267 mime ^ranger/x-terminal-emulator, has xterm = xterm -e "$@"
 
 269 #-------------------------------------------
 
 271 #-------------------------------------------
 
 272 label wallpaper, number 11, mime ^image, has feh, X = feh --bg-scale "$1"
 
 273 label wallpaper, number 12, mime ^image, has feh, X = feh --bg-tile "$1"
 
 274 label wallpaper, number 13, mime ^image, has feh, X = feh --bg-center "$1"
 
 275 label wallpaper, number 14, mime ^image, has feh, X = feh --bg-fill "$1"
 
 277 #-------------------------------------------
 
 278 # Generic file openers
 
 279 #-------------------------------------------
 
 280 label open, has xdg-open = xdg-open "$@"
 
 281 label open, has open     = open -- "$@"
 
 283 # Define the editor for non-text files + pager as last action
 
 284               !mime ^text, !ext xml|json|csv|tex|py|pl|rb|rs|js|sh|php|dart  = ask
 
 285 label editor, !mime ^text, !ext xml|json|csv|tex|py|pl|rb|rs|js|sh|php|dart  = ${VISUAL:-$EDITOR} -- "$@"
 
 286 label pager,  !mime ^text, !ext xml|json|csv|tex|py|pl|rb|rs|js|sh|php|dart  = $PAGER -- "$@"
 
 289 ######################################################################
 
 290 # The actions below are left so low down in this file on purpose, so #
 
 291 # they are never triggered accidentally.                             #
 
 292 ######################################################################
 
 294 # Execute a file as program/script.
 
 295 mime application/x-executable = "$1"
 
 297 # Move the file to trash using trash-cli.
 
 298 label trash, has trash-put = trash-put -- "$@"
 
 299 label trash = mkdir -p -- "${XDG_DATA_HOME:-$HOME/.local/share}/ranger/trash"; mv -- "$@" "${XDG_DATA_HOME:-$HOME/.local/share}/ranger/trash"