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 | $DISPLAY is not empty (i.e. Xorg runs)
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 chromium-browser, X, flag f = chromium-browser -- "$@"
70 ext x?html?, has chromium, X, flag f = chromium -- "$@"
71 ext x?html?, has google-chrome, X, flag f = google-chrome -- "$@"
72 ext x?html?, has opera, X, flag f = opera -- "$@"
73 ext x?html?, has firefox, X, flag f = firefox -- "$@"
74 ext x?html?, has seamonkey, X, flag f = seamonkey -- "$@"
75 ext x?html?, has iceweasel, X, flag f = iceweasel -- "$@"
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|js|sh|php = ${VISUAL:-$EDITOR} -- "$@"
91 !mime ^text, label pager, ext xml|json|csv|tex|py|pl|rb|js|sh|php = "$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"
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"
110 #--------------------------------------------
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 -- "$@"
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 -- "$@"
133 #--------------------------------------------
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 -- "$@"
140 #-------------------------------------------
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 "$@"
156 ext docx?, has catdoc, terminal = catdoc -- "$@" | "$PAGER"
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 "$@"
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 -- "$@"
169 ext epub, has ebook-viewer, X, flag f = ebook-viewer -- "$@"
170 ext mobi, has ebook-viewer, X, flag f = ebook-viewer -- "$@"
172 #-------------------------------------------
174 #-------------------------------------------
175 mime ^image/svg, has inkscape, X, flag f = inkscape -- "$@"
176 mime ^image/svg, has display, X, flag f = display -- "$@"
178 mime ^image, has pqiv, X, flag f = pqiv -- "$@"
179 mime ^image, has sxiv, X, flag f = sxiv -- "$@"
180 mime ^image, has feh, X, flag f = feh -- "$@"
181 mime ^image, has mirage, X, flag f = mirage -- "$@"
182 mime ^image, has ristretto, X, flag f = ristretto "$@"
183 mime ^image, has eog, X, flag f = eog -- "$@"
184 mime ^image, has eom, X, flag f = eom -- "$@"
185 mime ^image, has nomacs, X, flag f = nomacs -- "$@"
186 mime ^image, has geeqie, X, flag f = geeqie -- "$@"
187 mime ^image, has gwenview, X, flag f = gwenview -- "$@"
188 mime ^image, has gimp, X, flag f = gimp -- "$@"
189 ext xcf, X, flag f = gimp -- "$@"
191 #-------------------------------------------
193 #-------------------------------------------
195 # avoid password prompt by providing empty password
196 ext 7z, has 7z = 7z -p l "$@" | "$PAGER"
197 # This requires atool
198 ext ace|ar|arc|bz2?|cab|cpio|cpt|deb|dgc|dmg|gz, has atool = atool --list --each -- "$@" | "$PAGER"
199 ext iso|jar|msi|pkg|rar|shar|tar|tgz|xar|xpi|xz|zip, has atool = atool --list --each -- "$@" | "$PAGER"
200 ext 7z|ace|ar|arc|bz2?|cab|cpio|cpt|deb|dgc|dmg|gz, has atool = atool --extract --each -- "$@"
201 ext iso|jar|msi|pkg|rar|shar|tar|tgz|xar|xpi|xz|zip, has atool = atool --extract --each -- "$@"
203 # Listing and extracting archives without atool:
204 ext tar|gz|bz2|xz, has tar = tar vvtf "$1" | "$PAGER"
205 ext tar|gz|bz2|xz, has tar = for file in "$@"; do tar vvxf "$file"; done
206 ext bz2, has bzip2 = for file in "$@"; do bzip2 -dk "$file"; done
207 ext zip, has unzip = unzip -l "$1" | less
208 ext zip, has unzip = for file in "$@"; do unzip -d "${file%.*}" "$file"; done
209 ext ace, has unace = unace l "$1" | less
210 ext ace, has unace = for file in "$@"; do unace e "$file"; done
211 ext rar, has unrar = unrar l "$1" | less
212 ext rar, has unrar = for file in "$@"; do unrar x "$file"; done
214 #-------------------------------------------
215 # Flag t fallback terminals
216 #-------------------------------------------
217 # Rarely installed terminal emulators get higher priority; It is assumed that
218 # if you install a rare terminal emulator, you probably use it.
219 # gnome-terminal/konsole/xterm on the other hand are often installed as part of
220 # a desktop environment or as fallback terminal emulators.
221 mime ^ranger/x-terminal-emulator, has terminology = terminology -e "$@"
222 mime ^ranger/x-terminal-emulator, has kitty = kitty -- "$@"
223 mime ^ranger/x-terminal-emulator, has alacritty = alacritty -e "$@"
224 mime ^ranger/x-terminal-emulator, has sakura = sakura -e "$@"
225 mime ^ranger/x-terminal-emulator, has lilyterm = lilyterm -e "$@"
226 #mime ^ranger/x-terminal-emulator, has cool-retro-term = cool-retro-term -e "$@"
227 mime ^ranger/x-terminal-emulator, has termite = termite -x '"$@"'
228 #mime ^ranger/x-terminal-emulator, has yakuake = yakuake -e "$@"
229 mime ^ranger/x-terminal-emulator, has guake = guake -ne "$@"
230 mime ^ranger/x-terminal-emulator, has tilda = tilda -c "$@"
231 mime ^ranger/x-terminal-emulator, has st = st -e "$@"
232 mime ^ranger/x-terminal-emulator, has terminator = terminator -x "$@"
233 mime ^ranger/x-terminal-emulator, has urxvt = urxvt -e "$@"
234 mime ^ranger/x-terminal-emulator, has pantheon-terminal = pantheon-terminal -e "$@"
235 mime ^ranger/x-terminal-emulator, has lxterminal = lxterminal -e "$@"
236 mime ^ranger/x-terminal-emulator, has mate-terminal = mate-terminal -x "$@"
237 mime ^ranger/x-terminal-emulator, has xfce4-terminal = xfce4-terminal -x "$@"
238 mime ^ranger/x-terminal-emulator, has konsole = konsole -e "$@"
239 mime ^ranger/x-terminal-emulator, has gnome-terminal = gnome-terminal -- "$@"
240 mime ^ranger/x-terminal-emulator, has xterm = xterm -e "$@"
242 #-------------------------------------------
244 #-------------------------------------------
245 label wallpaper, number 11, mime ^image, has feh, X = feh --bg-scale "$1"
246 label wallpaper, number 12, mime ^image, has feh, X = feh --bg-tile "$1"
247 label wallpaper, number 13, mime ^image, has feh, X = feh --bg-center "$1"
248 label wallpaper, number 14, mime ^image, has feh, X = feh --bg-fill "$1"
250 # Define the editor for non-text files + pager as last action
251 !mime ^text, !ext xml|json|csv|tex|py|pl|rb|js|sh|php = ask
252 label editor, !mime ^text, !ext xml|json|csv|tex|py|pl|rb|js|sh|php = ${VISUAL:-$EDITOR} -- "$@"
253 label pager, !mime ^text, !ext xml|json|csv|tex|py|pl|rb|js|sh|php = "$PAGER" -- "$@"
255 # The very last action, so that it's never triggered accidentally, is to execute a program:
256 mime application/x-executable = "$1"