rifle.conf (14116B)
1 # vim: ft=cfg 2 # 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. 6 # 7 # Syntax: 8 # <condition1> , <condition2> , ... = command 9 # 10 # The command can contain these environment variables: 11 # $1-$9 | The n-th selected file 12 # $@ | All selected files 13 # 14 # If you use the special command "ask", rifle will ask you what program to run. 15 # 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 25 # file | $1 is a file 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) 30 # 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. 36 # else | Always true. 37 # 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. 50 51 #------------------------------------------- 52 # Websites 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 "$@" 83 84 #------------------------------------------- 85 # Misc 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|js|sh|php = ${VISUAL:-$EDITOR} -- "$@" 91 !mime ^text, label pager, ext xml|json|csv|tex|py|pl|rb|js|sh|php = "$PAGER" -- "$@" 92 93 ext 1 = man "$1" 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 = wine "$1" 98 name ^[mM]akefile$ = make 99 100 #-------------------------------------------- 101 # Scripts 102 #------------------------------------------- 103 ext py = python -- "$1" 104 ext pl = perl -- "$1" 105 ext rb = ruby -- "$1" 106 ext js = node -- "$1" 107 ext sh = sh -- "$1" 108 ext php = php -- "$1" 109 110 #-------------------------------------------- 111 # Audio without X 112 #------------------------------------------- 113 mime ^audio|ogg$, terminal, has mpv = mpv -- "$@" 114 mime ^audio|ogg$, terminal, has mplayer2 = mplayer2 -- "$@" 115 mime ^audio|ogg$, terminal, has mplayer = mplayer -- "$@" 116 ext midi?, terminal, has wildmidi = wildmidi -- "$@" 117 118 #-------------------------------------------- 119 # Video/Audio with a GUI 120 #------------------------------------------- 121 mime ^video|audio, has gmplayer, X, flag f = gmplayer -- "$@" 122 mime ^video|audio, has smplayer, X, flag f = smplayer "$@" 123 mime ^video, has mpv, X, flag f = mpv -- "$@" 124 mime ^video, has mpv, X, flag f = mpv --fs -- "$@" 125 mime ^video, has mplayer2, X, flag f = mplayer2 -- "$@" 126 mime ^video, has mplayer2, X, flag f = mplayer2 -fs -- "$@" 127 mime ^video, has mplayer, X, flag f = mplayer -- "$@" 128 mime ^video, has mplayer, X, flag f = mplayer -fs -- "$@" 129 mime ^video|audio, has vlc, X, flag f = vlc -- "$@" 130 mime ^video|audio, has totem, X, flag f = totem -- "$@" 131 mime ^video|audio, has totem, X, flag f = totem --fullscreen -- "$@" 132 133 #-------------------------------------------- 134 # Video without X 135 #------------------------------------------- 136 mime ^video, terminal, !X, has mpv = mpv -- "$@" 137 mime ^video, terminal, !X, has mplayer2 = mplayer2 -- "$@" 138 mime ^video, terminal, !X, has mplayer = mplayer -- "$@" 139 140 #------------------------------------------- 141 # Documents 142 #------------------------------------------- 143 ext pdf, has llpp, X, flag f = llpp "$@" 144 ext pdf, has zathura, X, flag f = zathura -- "$@" 145 ext pdf, has mupdf, X, flag f = mupdf "$@" 146 ext pdf, has mupdf-x11,X, flag f = mupdf-x11 "$@" 147 ext pdf, has apvlv, X, flag f = apvlv -- "$@" 148 ext pdf, has xpdf, X, flag f = xpdf -- "$@" 149 ext pdf, has evince, X, flag f = evince -- "$@" 150 ext pdf, has atril, X, flag f = atril -- "$@" 151 ext pdf, has okular, X, flag f = okular -- "$@" 152 ext pdf, has epdfview, X, flag f = epdfview -- "$@" 153 ext pdf, has qpdfview, X, flag f = qpdfview "$@" 154 ext pdf, has open, X, flag f = open "$@" 155 156 ext docx?, has catdoc, terminal = catdoc -- "$@" | "$PAGER" 157 158 ext sxc|xlsx?|xlt|xlw|gnm|gnumeric, has gnumeric, X, flag f = gnumeric -- "$@" 159 ext sxc|xlsx?|xlt|xlw|gnm|gnumeric, has kspread, X, flag f = kspread -- "$@" 160 ext pptx?|od[dfgpst]|docx?|sxc|xlsx?|xlt|xlw|gnm|gnumeric, has libreoffice, X, flag f = libreoffice "$@" 161 ext pptx?|od[dfgpst]|docx?|sxc|xlsx?|xlt|xlw|gnm|gnumeric, has soffice, X, flag f = soffice "$@" 162 ext pptx?|od[dfgpst]|docx?|sxc|xlsx?|xlt|xlw|gnm|gnumeric, has ooffice, X, flag f = ooffice "$@" 163 164 ext djvu, has zathura,X, flag f = zathura -- "$@" 165 ext djvu, has evince, X, flag f = evince -- "$@" 166 ext djvu, has atril, X, flag f = atril -- "$@" 167 ext djvu, has djview, X, flag f = djview -- "$@" 168 169 ext epub, has ebook-viewer, X, flag f = ebook-viewer -- "$@" 170 ext epub, has zathura, X, flag f = zathura -- "$@" 171 ext epub, has mupdf, X, flag f = mupdf -- "$@" 172 ext mobi, has ebook-viewer, X, flag f = ebook-viewer -- "$@" 173 174 ext cbr, has zathura, X, flag f = zathura -- "$@" 175 ext cbz, has zathura, X, flag f = zathura -- "$@" 176 177 #------------------------------------------- 178 # Images 179 #------------------------------------------- 180 mime ^image/svg, has inkscape, X, flag f = inkscape -- "$@" 181 mime ^image/svg, has display, X, flag f = display -- "$@" 182 183 mime ^image, has mpv, X, flag f = mpv --pause -- "$@" 184 mime ^image, has imv, X, flag f = imv -- "$@" 185 mime ^image, has pqiv, X, flag f = pqiv -- "$@" 186 mime ^image, has sxiv, X, flag f = sxiv -- "$@" 187 mime ^image, has feh, X, flag f = feh -- "$@" 188 mime ^image, has mirage, X, flag f = mirage -- "$@" 189 mime ^image, has ristretto, X, flag f = ristretto "$@" 190 mime ^image, has eog, X, flag f = eog -- "$@" 191 mime ^image, has eom, X, flag f = eom -- "$@" 192 mime ^image, has nomacs, X, flag f = nomacs -- "$@" 193 mime ^image, has geeqie, X, flag f = geeqie -- "$@" 194 mime ^image, has gpicview, X, flag f = gpicview -- "$@" 195 mime ^image, has gwenview, X, flag f = gwenview -- "$@" 196 mime ^image, has gimp, X, flag f = gimp -- "$@" 197 ext xcf, X, flag f = gimp -- "$@" 198 199 #------------------------------------------- 200 # Archives 201 #------------------------------------------- 202 203 # avoid password prompt by providing empty password 204 ext 7z, has 7z = 7z -p l "$@" | "$PAGER" 205 # This requires atool 206 ext ace|ar|arc|bz2?|cab|cpio|cpt|deb|dgc|dmg|gz, has atool = atool --list --each -- "$@" | "$PAGER" 207 ext iso|jar|msi|pkg|rar|shar|tar|tgz|xar|xpi|xz|zip, has atool = atool --list --each -- "$@" | "$PAGER" 208 ext 7z|ace|ar|arc|bz2?|cab|cpio|cpt|deb|dgc|dmg|gz, has atool = atool --extract --each -- "$@" 209 ext iso|jar|msi|pkg|rar|shar|tar|tgz|xar|xpi|xz|zip, has atool = atool --extract --each -- "$@" 210 211 # Listing and extracting archives without atool: 212 ext tar|gz|bz2|xz, has tar = tar vvtf "$1" | "$PAGER" 213 ext tar|gz|bz2|xz, has tar = for file in "$@"; do tar vvxf "$file"; done 214 ext bz2, has bzip2 = for file in "$@"; do bzip2 -dk "$file"; done 215 ext zip, has unzip = unzip -l "$1" | less 216 ext zip, has unzip = for file in "$@"; do unzip -d "${file%.*}" "$file"; done 217 ext ace, has unace = unace l "$1" | less 218 ext ace, has unace = for file in "$@"; do unace e "$file"; done 219 ext rar, has unrar = unrar l "$1" | less 220 ext rar, has unrar = for file in "$@"; do unrar x "$file"; done 221 222 #------------------------------------------- 223 # Fonts 224 #------------------------------------------- 225 mime ^font, has fontforge, X, flag f = fontforge "$@" 226 227 #------------------------------------------- 228 # Flag t fallback terminals 229 #------------------------------------------- 230 # Rarely installed terminal emulators get higher priority; It is assumed that 231 # if you install a rare terminal emulator, you probably use it. 232 # gnome-terminal/konsole/xterm on the other hand are often installed as part of 233 # a desktop environment or as fallback terminal emulators. 234 mime ^ranger/x-terminal-emulator, has terminology = terminology -e "$@" 235 mime ^ranger/x-terminal-emulator, has kitty = kitty -- "$@" 236 mime ^ranger/x-terminal-emulator, has alacritty = alacritty -e "$@" 237 mime ^ranger/x-terminal-emulator, has sakura = sakura -e "$@" 238 mime ^ranger/x-terminal-emulator, has lilyterm = lilyterm -e "$@" 239 #mime ^ranger/x-terminal-emulator, has cool-retro-term = cool-retro-term -e "$@" 240 mime ^ranger/x-terminal-emulator, has termite = termite -x '"$@"' 241 #mime ^ranger/x-terminal-emulator, has yakuake = yakuake -e "$@" 242 mime ^ranger/x-terminal-emulator, has guake = guake -ne "$@" 243 mime ^ranger/x-terminal-emulator, has tilda = tilda -c "$@" 244 mime ^ranger/x-terminal-emulator, has st = st -e "$@" 245 mime ^ranger/x-terminal-emulator, has terminator = terminator -x "$@" 246 mime ^ranger/x-terminal-emulator, has urxvt = urxvt -e "$@" 247 mime ^ranger/x-terminal-emulator, has pantheon-terminal = pantheon-terminal -e "$@" 248 mime ^ranger/x-terminal-emulator, has lxterminal = lxterminal -e "$@" 249 mime ^ranger/x-terminal-emulator, has mate-terminal = mate-terminal -x "$@" 250 mime ^ranger/x-terminal-emulator, has xfce4-terminal = xfce4-terminal -x "$@" 251 mime ^ranger/x-terminal-emulator, has konsole = konsole -e "$@" 252 mime ^ranger/x-terminal-emulator, has gnome-terminal = gnome-terminal -- "$@" 253 mime ^ranger/x-terminal-emulator, has xterm = xterm -e "$@" 254 255 #------------------------------------------- 256 # Misc 257 #------------------------------------------- 258 label wallpaper, number 11, mime ^image, has feh, X = feh --bg-scale "$1" 259 label wallpaper, number 12, mime ^image, has feh, X = feh --bg-tile "$1" 260 label wallpaper, number 13, mime ^image, has feh, X = feh --bg-center "$1" 261 label wallpaper, number 14, mime ^image, has feh, X = feh --bg-fill "$1" 262 263 #------------------------------------------- 264 # Generic file openers 265 #------------------------------------------- 266 label open, has xdg-open = xdg-open -- "$@" 267 label open, has open = open -- "$@" 268 269 # Define the editor for non-text files + pager as last action 270 !mime ^text, !ext xml|json|csv|tex|py|pl|rb|js|sh|php = vim 271 label editor, !mime ^text, !ext xml|json|csv|tex|py|pl|rb|js|sh|php = vim -- "$@" 272 label pager, !mime ^text, !ext xml|json|csv|tex|py|pl|rb|js|sh|php = "$PAGER" -- "$@" 273 274 275 ###################################################################### 276 # The actions below are left so low down in this file on purpose, so # 277 # they are never triggered accidentally. # 278 ###################################################################### 279 280 # Execute a file as program/script. 281 mime application/x-executable = "$1" 282 283 # Move the file to trash using trash-cli. 284 label trash, has trash-put = trash-put -- "$@" 285 label trash = mkdir -p -- ${XDG_DATA_DIR:-$HOME/.ranger}/ranger-trash; mv -- "$@" ${XDG_DATA_DIR:-$HOME/.ranger}/ranger-trash