1 | #!/bin/sh
|
---|
2 | #---------------------------------------------
|
---|
3 | # xdg-open
|
---|
4 | #
|
---|
5 | # Utility script to open a URL in the registered default application.
|
---|
6 | #
|
---|
7 | # Refer to the usage() function below for usage.
|
---|
8 | #
|
---|
9 | # Copyright 2009-2010, Fathi Boudra <fabo@freedesktop.org>
|
---|
10 | # Copyright 2009-2010, Rex Dieter <rdieter@fedoraproject.org>
|
---|
11 | # Copyright 2006, Kevin Krammer <kevin.krammer@gmx.at>
|
---|
12 | # Copyright 2006, Jeremy White <jwhite@codeweavers.com>
|
---|
13 | #
|
---|
14 | # LICENSE:
|
---|
15 | #
|
---|
16 | # Permission is hereby granted, free of charge, to any person obtaining a
|
---|
17 | # copy of this software and associated documentation files (the "Software"),
|
---|
18 | # to deal in the Software without restriction, including without limitation
|
---|
19 | # the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
---|
20 | # and/or sell copies of the Software, and to permit persons to whom the
|
---|
21 | # Software is furnished to do so, subject to the following conditions:
|
---|
22 | #
|
---|
23 | # The above copyright notice and this permission notice shall be included
|
---|
24 | # in all copies or substantial portions of the Software.
|
---|
25 | #
|
---|
26 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
---|
27 | # OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
---|
28 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
---|
29 | # THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
|
---|
30 | # OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
|
---|
31 | # ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
|
---|
32 | # OTHER DEALINGS IN THE SOFTWARE.
|
---|
33 | #
|
---|
34 | #---------------------------------------------
|
---|
35 |
|
---|
36 | manualpage()
|
---|
37 | {
|
---|
38 | cat << _MANUALPAGE
|
---|
39 | Name
|
---|
40 |
|
---|
41 | xdg-open -- opens a file or URL in the user's preferred
|
---|
42 | application
|
---|
43 |
|
---|
44 | Synopsis
|
---|
45 |
|
---|
46 | xdg-open { file | URL }
|
---|
47 |
|
---|
48 | xdg-open { --help | --manual | --version }
|
---|
49 |
|
---|
50 | Description
|
---|
51 |
|
---|
52 | xdg-open opens a file or URL in the user's preferred
|
---|
53 | application. If a URL is provided the URL will be opened in the
|
---|
54 | user's preferred web browser. If a file is provided the file
|
---|
55 | will be opened in the preferred application for files of that
|
---|
56 | type. xdg-open supports file, ftp, http and https URLs.
|
---|
57 |
|
---|
58 | xdg-open is for use inside a desktop session only. It is not
|
---|
59 | recommended to use xdg-open as root.
|
---|
60 |
|
---|
61 | Options
|
---|
62 |
|
---|
63 | --help
|
---|
64 | Show command synopsis.
|
---|
65 |
|
---|
66 | --manual
|
---|
67 | Show this manual page.
|
---|
68 |
|
---|
69 | --version
|
---|
70 | Show the xdg-utils version information.
|
---|
71 |
|
---|
72 | Exit Codes
|
---|
73 |
|
---|
74 | An exit code of 0 indicates success while a non-zero exit code
|
---|
75 | indicates failure. The following failure codes can be returned:
|
---|
76 |
|
---|
77 | 1
|
---|
78 | Error in command line syntax.
|
---|
79 |
|
---|
80 | 2
|
---|
81 | One of the files passed on the command line did not
|
---|
82 | exist.
|
---|
83 |
|
---|
84 | 3
|
---|
85 | A required tool could not be found.
|
---|
86 |
|
---|
87 | 4
|
---|
88 | The action failed.
|
---|
89 |
|
---|
90 | See Also
|
---|
91 |
|
---|
92 | xdg-mime(1), xdg-settings(1), MIME applications associations
|
---|
93 | specification
|
---|
94 |
|
---|
95 | Examples
|
---|
96 |
|
---|
97 | xdg-open 'http://www.freedesktop.org/'
|
---|
98 |
|
---|
99 | Opens the freedesktop.org website in the user's default
|
---|
100 | browser.
|
---|
101 |
|
---|
102 | xdg-open /tmp/foobar.png
|
---|
103 |
|
---|
104 | Opens the PNG image file /tmp/foobar.png in the user's default
|
---|
105 | image viewing application.
|
---|
106 | _MANUALPAGE
|
---|
107 | }
|
---|
108 |
|
---|
109 | usage()
|
---|
110 | {
|
---|
111 | cat << _USAGE
|
---|
112 | xdg-open -- opens a file or URL in the user's preferred
|
---|
113 | application
|
---|
114 |
|
---|
115 | Synopsis
|
---|
116 |
|
---|
117 | xdg-open { file | URL }
|
---|
118 |
|
---|
119 | xdg-open { --help | --manual | --version }
|
---|
120 |
|
---|
121 | _USAGE
|
---|
122 | }
|
---|
123 |
|
---|
124 | #@xdg-utils-common@
|
---|
125 |
|
---|
126 | #----------------------------------------------------------------------------
|
---|
127 | # Common utility functions included in all XDG wrapper scripts
|
---|
128 | #----------------------------------------------------------------------------
|
---|
129 |
|
---|
130 | DEBUG()
|
---|
131 | {
|
---|
132 | [ -z "${XDG_UTILS_DEBUG_LEVEL}" ] && return 0;
|
---|
133 | [ ${XDG_UTILS_DEBUG_LEVEL} -lt $1 ] && return 0;
|
---|
134 | shift
|
---|
135 | echo "$@" >&2
|
---|
136 | }
|
---|
137 |
|
---|
138 | # This handles backslashes but not quote marks.
|
---|
139 | first_word()
|
---|
140 | {
|
---|
141 | read first rest
|
---|
142 | echo "$first"
|
---|
143 | }
|
---|
144 |
|
---|
145 | #-------------------------------------------------------------
|
---|
146 | # map a binary to a .desktop file
|
---|
147 | binary_to_desktop_file()
|
---|
148 | {
|
---|
149 | search="${XDG_DATA_HOME:-$HOME/.local/share}:${XDG_DATA_DIRS:-/usr/local/share:/usr/share}"
|
---|
150 | binary="`which "$1"`"
|
---|
151 | binary="`readlink -f "$binary"`"
|
---|
152 | base="`basename "$binary"`"
|
---|
153 | IFS=:
|
---|
154 | for dir in $search; do
|
---|
155 | unset IFS
|
---|
156 | [ "$dir" ] || continue
|
---|
157 | [ -d "$dir/applications" ] || [ -d "$dir/applnk" ] || continue
|
---|
158 | for file in "$dir"/applications/*.desktop "$dir"/applications/*/*.desktop "$dir"/applnk/*.desktop "$dir"/applnk/*/*.desktop; do
|
---|
159 | [ -r "$file" ] || continue
|
---|
160 | # Check to make sure it's worth the processing.
|
---|
161 | grep -q "^Exec.*$base" "$file" || continue
|
---|
162 | # Make sure it's a visible desktop file (e.g. not "preferred-web-browser.desktop").
|
---|
163 | grep -Eq "^(NoDisplay|Hidden)=true" "$file" && continue
|
---|
164 | command="`grep -E "^Exec(\[[^]=]*])?=" "$file" | cut -d= -f 2- | first_word`"
|
---|
165 | command="`which "$command"`"
|
---|
166 | if [ x"`readlink -f "$command"`" = x"$binary" ]; then
|
---|
167 | # Fix any double slashes that got added path composition
|
---|
168 | echo "$file" | sed -e 's,//*,/,g'
|
---|
169 | return
|
---|
170 | fi
|
---|
171 | done
|
---|
172 | done
|
---|
173 | }
|
---|
174 |
|
---|
175 | #-------------------------------------------------------------
|
---|
176 | # map a .desktop file to a binary
|
---|
177 | desktop_file_to_binary()
|
---|
178 | {
|
---|
179 | search="${XDG_DATA_HOME:-$HOME/.local/share}:${XDG_DATA_DIRS:-/usr/local/share:/usr/share}"
|
---|
180 | desktop="`basename "$1"`"
|
---|
181 | IFS=:
|
---|
182 | for dir in $search; do
|
---|
183 | unset IFS
|
---|
184 | [ "$dir" ] && [ -d "$dir/applications" ] || [ -d "$dir/applnk" ] || continue
|
---|
185 | # Check if desktop file contains -
|
---|
186 | if [ "${desktop#*-}" != "$desktop" ]; then
|
---|
187 | vendor=${desktop%-*}
|
---|
188 | app=${desktop#*-}
|
---|
189 | if [ -r $dir/applications/$vendor/$app ]; then
|
---|
190 | file_path=$dir/applications/$vendor/$app
|
---|
191 | elif [ -r $dir/applnk/$vendor/$app ]; then
|
---|
192 | file_path=$dir/applnk/$vendor/$app
|
---|
193 | fi
|
---|
194 | fi
|
---|
195 | if test -z "$file_path" ; then
|
---|
196 | for indir in "$dir"/applications/ "$dir"/applications/*/ "$dir"/applnk/ "$dir"/applnk/*/; do
|
---|
197 | file="$indir/$desktop"
|
---|
198 | if [ -r "$file" ]; then
|
---|
199 | file_path=$file
|
---|
200 | break
|
---|
201 | fi
|
---|
202 | done
|
---|
203 | fi
|
---|
204 | if [ -r "$file_path" ]; then
|
---|
205 | # Remove any arguments (%F, %f, %U, %u, etc.).
|
---|
206 | command="`grep -E "^Exec(\[[^]=]*])?=" "$file_path" | cut -d= -f 2- | first_word`"
|
---|
207 | command="`which "$command"`"
|
---|
208 | readlink -f "$command"
|
---|
209 | return
|
---|
210 | fi
|
---|
211 | done
|
---|
212 | }
|
---|
213 |
|
---|
214 | #-------------------------------------------------------------
|
---|
215 | # Exit script on successfully completing the desired operation
|
---|
216 |
|
---|
217 | exit_success()
|
---|
218 | {
|
---|
219 | if [ $# -gt 0 ]; then
|
---|
220 | echo "$@"
|
---|
221 | echo
|
---|
222 | fi
|
---|
223 |
|
---|
224 | exit 0
|
---|
225 | }
|
---|
226 |
|
---|
227 |
|
---|
228 | #-----------------------------------------
|
---|
229 | # Exit script on malformed arguments, not enough arguments
|
---|
230 | # or missing required option.
|
---|
231 | # prints usage information
|
---|
232 |
|
---|
233 | exit_failure_syntax()
|
---|
234 | {
|
---|
235 | if [ $# -gt 0 ]; then
|
---|
236 | echo "xdg-open: $@" >&2
|
---|
237 | echo "Try 'xdg-open --help' for more information." >&2
|
---|
238 | else
|
---|
239 | usage
|
---|
240 | echo "Use 'man xdg-open' or 'xdg-open --manual' for additional info."
|
---|
241 | fi
|
---|
242 |
|
---|
243 | exit 1
|
---|
244 | }
|
---|
245 |
|
---|
246 | #-------------------------------------------------------------
|
---|
247 | # Exit script on missing file specified on command line
|
---|
248 |
|
---|
249 | exit_failure_file_missing()
|
---|
250 | {
|
---|
251 | if [ $# -gt 0 ]; then
|
---|
252 | echo "xdg-open: $@" >&2
|
---|
253 | fi
|
---|
254 |
|
---|
255 | exit 2
|
---|
256 | }
|
---|
257 |
|
---|
258 | #-------------------------------------------------------------
|
---|
259 | # Exit script on failure to locate necessary tool applications
|
---|
260 |
|
---|
261 | exit_failure_operation_impossible()
|
---|
262 | {
|
---|
263 | if [ $# -gt 0 ]; then
|
---|
264 | echo "xdg-open: $@" >&2
|
---|
265 | fi
|
---|
266 |
|
---|
267 | exit 3
|
---|
268 | }
|
---|
269 |
|
---|
270 | #-------------------------------------------------------------
|
---|
271 | # Exit script on failure returned by a tool application
|
---|
272 |
|
---|
273 | exit_failure_operation_failed()
|
---|
274 | {
|
---|
275 | if [ $# -gt 0 ]; then
|
---|
276 | echo "xdg-open: $@" >&2
|
---|
277 | fi
|
---|
278 |
|
---|
279 | exit 4
|
---|
280 | }
|
---|
281 |
|
---|
282 | #------------------------------------------------------------
|
---|
283 | # Exit script on insufficient permission to read a specified file
|
---|
284 |
|
---|
285 | exit_failure_file_permission_read()
|
---|
286 | {
|
---|
287 | if [ $# -gt 0 ]; then
|
---|
288 | echo "xdg-open: $@" >&2
|
---|
289 | fi
|
---|
290 |
|
---|
291 | exit 5
|
---|
292 | }
|
---|
293 |
|
---|
294 | #------------------------------------------------------------
|
---|
295 | # Exit script on insufficient permission to write a specified file
|
---|
296 |
|
---|
297 | exit_failure_file_permission_write()
|
---|
298 | {
|
---|
299 | if [ $# -gt 0 ]; then
|
---|
300 | echo "xdg-open: $@" >&2
|
---|
301 | fi
|
---|
302 |
|
---|
303 | exit 6
|
---|
304 | }
|
---|
305 |
|
---|
306 | check_input_file()
|
---|
307 | {
|
---|
308 | if [ ! -e "$1" ]; then
|
---|
309 | exit_failure_file_missing "file '$1' does not exist"
|
---|
310 | fi
|
---|
311 | if [ ! -r "$1" ]; then
|
---|
312 | exit_failure_file_permission_read "no permission to read file '$1'"
|
---|
313 | fi
|
---|
314 | }
|
---|
315 |
|
---|
316 | check_vendor_prefix()
|
---|
317 | {
|
---|
318 | file_label="$2"
|
---|
319 | [ -n "$file_label" ] || file_label="filename"
|
---|
320 | file=`basename "$1"`
|
---|
321 | case "$file" in
|
---|
322 | [[:alpha:]]*-*)
|
---|
323 | return
|
---|
324 | ;;
|
---|
325 | esac
|
---|
326 |
|
---|
327 | echo "xdg-open: $file_label '$file' does not have a proper vendor prefix" >&2
|
---|
328 | echo 'A vendor prefix consists of alpha characters ([a-zA-Z]) and is terminated' >&2
|
---|
329 | echo 'with a dash ("-"). An example '"$file_label"' is '"'example-$file'" >&2
|
---|
330 | echo "Use --novendor to override or 'xdg-open --manual' for additional info." >&2
|
---|
331 | exit 1
|
---|
332 | }
|
---|
333 |
|
---|
334 | check_output_file()
|
---|
335 | {
|
---|
336 | # if the file exists, check if it is writeable
|
---|
337 | # if it does not exists, check if we are allowed to write on the directory
|
---|
338 | if [ -e "$1" ]; then
|
---|
339 | if [ ! -w "$1" ]; then
|
---|
340 | exit_failure_file_permission_write "no permission to write to file '$1'"
|
---|
341 | fi
|
---|
342 | else
|
---|
343 | DIR=`dirname "$1"`
|
---|
344 | if [ ! -w "$DIR" ] || [ ! -x "$DIR" ]; then
|
---|
345 | exit_failure_file_permission_write "no permission to create file '$1'"
|
---|
346 | fi
|
---|
347 | fi
|
---|
348 | }
|
---|
349 |
|
---|
350 | #----------------------------------------
|
---|
351 | # Checks for shared commands, e.g. --help
|
---|
352 |
|
---|
353 | check_common_commands()
|
---|
354 | {
|
---|
355 | while [ $# -gt 0 ] ; do
|
---|
356 | parm="$1"
|
---|
357 | shift
|
---|
358 |
|
---|
359 | case "$parm" in
|
---|
360 | --help)
|
---|
361 | usage
|
---|
362 | echo "Use 'man xdg-open' or 'xdg-open --manual' for additional info."
|
---|
363 | exit_success
|
---|
364 | ;;
|
---|
365 |
|
---|
366 | --manual)
|
---|
367 | manualpage
|
---|
368 | exit_success
|
---|
369 | ;;
|
---|
370 |
|
---|
371 | --version)
|
---|
372 | echo "xdg-open 1.1.3"
|
---|
373 | exit_success
|
---|
374 | ;;
|
---|
375 | esac
|
---|
376 | done
|
---|
377 | }
|
---|
378 |
|
---|
379 | check_common_commands "$@"
|
---|
380 |
|
---|
381 | [ -z "${XDG_UTILS_DEBUG_LEVEL}" ] && unset XDG_UTILS_DEBUG_LEVEL;
|
---|
382 | if [ ${XDG_UTILS_DEBUG_LEVEL-0} -lt 1 ]; then
|
---|
383 | # Be silent
|
---|
384 | xdg_redirect_output=" > /dev/null 2> /dev/null"
|
---|
385 | else
|
---|
386 | # All output to stderr
|
---|
387 | xdg_redirect_output=" >&2"
|
---|
388 | fi
|
---|
389 |
|
---|
390 | #--------------------------------------
|
---|
391 | # Checks for known desktop environments
|
---|
392 | # set variable DE to the desktop environments name, lowercase
|
---|
393 |
|
---|
394 | detectDE()
|
---|
395 | {
|
---|
396 | # see https://bugs.freedesktop.org/show_bug.cgi?id=34164
|
---|
397 | unset GREP_OPTIONS
|
---|
398 |
|
---|
399 | if [ -n "${XDG_CURRENT_DESKTOP}" ]; then
|
---|
400 | case "${XDG_CURRENT_DESKTOP}" in
|
---|
401 | # only recently added to menu-spec, pre-spec X- still in use
|
---|
402 | Cinnamon|X-Cinnamon)
|
---|
403 | DE=cinnamon;
|
---|
404 | ;;
|
---|
405 | ENLIGHTENMENT)
|
---|
406 | DE=enlightenment;
|
---|
407 | ;;
|
---|
408 | # GNOME, GNOME-Classic:GNOME, or GNOME-Flashback:GNOME
|
---|
409 | GNOME*)
|
---|
410 | DE=gnome;
|
---|
411 | ;;
|
---|
412 | KDE)
|
---|
413 | DE=kde;
|
---|
414 | ;;
|
---|
415 | # Deepin Desktop Environments
|
---|
416 | DEEPIN|Deepin|deepin)
|
---|
417 | DE=dde;
|
---|
418 | ;;
|
---|
419 | LXDE)
|
---|
420 | DE=lxde;
|
---|
421 | ;;
|
---|
422 | LXQt)
|
---|
423 | DE=lxqt;
|
---|
424 | ;;
|
---|
425 | MATE)
|
---|
426 | DE=mate;
|
---|
427 | ;;
|
---|
428 | XFCE)
|
---|
429 | DE=xfce
|
---|
430 | ;;
|
---|
431 | X-Generic)
|
---|
432 | DE=generic
|
---|
433 | ;;
|
---|
434 | esac
|
---|
435 | fi
|
---|
436 |
|
---|
437 | if [ x"$DE" = x"" ]; then
|
---|
438 | # classic fallbacks
|
---|
439 | if [ x"$KDE_FULL_SESSION" != x"" ]; then DE=kde;
|
---|
440 | elif [ x"$GNOME_DESKTOP_SESSION_ID" != x"" ]; then DE=gnome;
|
---|
441 | elif [ x"$MATE_DESKTOP_SESSION_ID" != x"" ]; then DE=mate;
|
---|
442 | elif `dbus-send --print-reply --dest=org.freedesktop.DBus /org/freedesktop/DBus org.freedesktop.DBus.GetNameOwner string:org.gnome.SessionManager > /dev/null 2>&1` ; then DE=gnome;
|
---|
443 | elif xprop -root _DT_SAVE_MODE 2> /dev/null | grep ' = \"xfce4\"$' >/dev/null 2>&1; then DE=xfce;
|
---|
444 | elif xprop -root 2> /dev/null | grep -i '^xfce_desktop_window' >/dev/null 2>&1; then DE=xfce
|
---|
445 | elif echo $DESKTOP | grep -q '^Enlightenment'; then DE=enlightenment;
|
---|
446 | elif [ x"$LXQT_SESSION_CONFIG" != x"" ]; then DE=lxqt;
|
---|
447 | fi
|
---|
448 | fi
|
---|
449 |
|
---|
450 | if [ x"$DE" = x"" ]; then
|
---|
451 | # fallback to checking $DESKTOP_SESSION
|
---|
452 | case "$DESKTOP_SESSION" in
|
---|
453 | gnome)
|
---|
454 | DE=gnome;
|
---|
455 | ;;
|
---|
456 | LXDE|Lubuntu)
|
---|
457 | DE=lxde;
|
---|
458 | ;;
|
---|
459 | MATE)
|
---|
460 | DE=mate;
|
---|
461 | ;;
|
---|
462 | xfce|xfce4|'Xfce Session')
|
---|
463 | DE=xfce;
|
---|
464 | ;;
|
---|
465 | esac
|
---|
466 | fi
|
---|
467 |
|
---|
468 | if [ x"$DE" = x"" ]; then
|
---|
469 | # fallback to uname output for other platforms
|
---|
470 | case "$(uname 2>/dev/null)" in
|
---|
471 | CYGWIN*)
|
---|
472 | DE=cygwin;
|
---|
473 | ;;
|
---|
474 | Darwin)
|
---|
475 | DE=darwin;
|
---|
476 | ;;
|
---|
477 | esac
|
---|
478 | fi
|
---|
479 |
|
---|
480 | if [ x"$DE" = x"gnome" ]; then
|
---|
481 | # gnome-default-applications-properties is only available in GNOME 2.x
|
---|
482 | # but not in GNOME 3.x
|
---|
483 | which gnome-default-applications-properties > /dev/null 2>&1 || DE="gnome3"
|
---|
484 | fi
|
---|
485 |
|
---|
486 | if [ -f "$XDG_RUNTIME_DIR/flatpak-info" ]; then
|
---|
487 | DE="flatpak"
|
---|
488 | fi
|
---|
489 | }
|
---|
490 |
|
---|
491 | #----------------------------------------------------------------------------
|
---|
492 | # kfmclient exec/openURL can give bogus exit value in KDE <= 3.5.4
|
---|
493 | # It also always returns 1 in KDE 3.4 and earlier
|
---|
494 | # Simply return 0 in such case
|
---|
495 |
|
---|
496 | kfmclient_fix_exit_code()
|
---|
497 | {
|
---|
498 | version=`LC_ALL=C.UTF-8 kde-config --version 2>/dev/null | grep '^KDE'`
|
---|
499 | major=`echo $version | sed 's/KDE.*: \([0-9]\).*/\1/'`
|
---|
500 | minor=`echo $version | sed 's/KDE.*: [0-9]*\.\([0-9]\).*/\1/'`
|
---|
501 | release=`echo $version | sed 's/KDE.*: [0-9]*\.[0-9]*\.\([0-9]\).*/\1/'`
|
---|
502 | test "$major" -gt 3 && return $1
|
---|
503 | test "$minor" -gt 5 && return $1
|
---|
504 | test "$release" -gt 4 && return $1
|
---|
505 | return 0
|
---|
506 | }
|
---|
507 |
|
---|
508 | #----------------------------------------------------------------------------
|
---|
509 | # Returns true if there is a graphical display attached.
|
---|
510 |
|
---|
511 | has_display()
|
---|
512 | {
|
---|
513 | if [ -n "$DISPLAY" ] || [ -n "$WAYLAND_DISPLAY" ]; then
|
---|
514 | return 0
|
---|
515 | else
|
---|
516 | return 1
|
---|
517 | fi
|
---|
518 | }
|
---|
519 |
|
---|
520 | # This handles backslashes but not quote marks.
|
---|
521 | last_word()
|
---|
522 | {
|
---|
523 | read first rest
|
---|
524 | echo "$rest"
|
---|
525 | }
|
---|
526 |
|
---|
527 | # Get the value of a key in a desktop file's Desktop Entry group.
|
---|
528 | # Example: Use get_key foo.desktop Exec
|
---|
529 | # to get the values of the Exec= key for the Desktop Entry group.
|
---|
530 | get_key()
|
---|
531 | {
|
---|
532 | local file="${1}"
|
---|
533 | local key="${2}"
|
---|
534 | local desktop_entry=""
|
---|
535 |
|
---|
536 | IFS_="${IFS}"
|
---|
537 | IFS=""
|
---|
538 | while read line
|
---|
539 | do
|
---|
540 | case "$line" in
|
---|
541 | "[Desktop Entry]")
|
---|
542 | desktop_entry="y"
|
---|
543 | ;;
|
---|
544 | # Reset match flag for other groups
|
---|
545 | "["*)
|
---|
546 | desktop_entry=""
|
---|
547 | ;;
|
---|
548 | "${key}="*)
|
---|
549 | # Only match Desktop Entry group
|
---|
550 | if [ -n "${desktop_entry}" ]
|
---|
551 | then
|
---|
552 | echo "${line}" | cut -d= -f 2-
|
---|
553 | fi
|
---|
554 | esac
|
---|
555 | done < "${file}"
|
---|
556 | IFS="${IFS_}"
|
---|
557 | }
|
---|
558 |
|
---|
559 | # Returns true if argument is a file:// URL or path
|
---|
560 | is_file_url_or_path()
|
---|
561 | {
|
---|
562 | if echo "$1" | grep -q '^file://' \
|
---|
563 | || ! echo "$1" | egrep -q '^[[:alpha:]+\.\-]+:'; then
|
---|
564 | return 0
|
---|
565 | else
|
---|
566 | return 1
|
---|
567 | fi
|
---|
568 | }
|
---|
569 |
|
---|
570 | # If argument is a file URL, convert it to a (percent-decoded) path.
|
---|
571 | # If not, leave it as it is.
|
---|
572 | file_url_to_path()
|
---|
573 | {
|
---|
574 | local file="$1"
|
---|
575 | if echo "$file" | grep -q '^file:///'; then
|
---|
576 | file=${file#file://}
|
---|
577 | file=${file%%#*}
|
---|
578 | file=$(echo "$file" | sed -r 's/\?.*$//')
|
---|
579 | local printf=printf
|
---|
580 | if [ -x /usr/bin/printf ]; then
|
---|
581 | printf=/usr/bin/printf
|
---|
582 | fi
|
---|
583 | file=$($printf "$(echo "$file" | sed -e 's@%\([a-f0-9A-F]\{2\}\)@\\x\1@g')")
|
---|
584 | fi
|
---|
585 | echo "$file"
|
---|
586 | }
|
---|
587 |
|
---|
588 | open_cygwin()
|
---|
589 | {
|
---|
590 | cygstart "$1"
|
---|
591 |
|
---|
592 | if [ $? -eq 0 ]; then
|
---|
593 | exit_success
|
---|
594 | else
|
---|
595 | exit_failure_operation_failed
|
---|
596 | fi
|
---|
597 | }
|
---|
598 |
|
---|
599 | open_darwin()
|
---|
600 | {
|
---|
601 | open "$1"
|
---|
602 |
|
---|
603 | if [ $? -eq 0 ]; then
|
---|
604 | exit_success
|
---|
605 | else
|
---|
606 | exit_failure_operation_failed
|
---|
607 | fi
|
---|
608 | }
|
---|
609 |
|
---|
610 | open_kde()
|
---|
611 | {
|
---|
612 | if [ -n "${KDE_SESSION_VERSION}" ]; then
|
---|
613 | case "${KDE_SESSION_VERSION}" in
|
---|
614 | 4)
|
---|
615 | kde-open "$1"
|
---|
616 | ;;
|
---|
617 | 5)
|
---|
618 | kde-open${KDE_SESSION_VERSION} "$1"
|
---|
619 | ;;
|
---|
620 | esac
|
---|
621 | else
|
---|
622 | kfmclient exec "$1"
|
---|
623 | kfmclient_fix_exit_code $?
|
---|
624 | fi
|
---|
625 |
|
---|
626 | if [ $? -eq 0 ]; then
|
---|
627 | exit_success
|
---|
628 | else
|
---|
629 | exit_failure_operation_failed
|
---|
630 | fi
|
---|
631 | }
|
---|
632 |
|
---|
633 | open_dde()
|
---|
634 | {
|
---|
635 | if dde-open -version >/dev/null 2>&1; then
|
---|
636 | dde-open "$1"
|
---|
637 | else
|
---|
638 | open_generic "$1"
|
---|
639 | fi
|
---|
640 |
|
---|
641 | if [ $? -eq 0 ]; then
|
---|
642 | exit_success
|
---|
643 | else
|
---|
644 | exit_failure_operation_failed
|
---|
645 | fi
|
---|
646 | }
|
---|
647 |
|
---|
648 | open_gnome3()
|
---|
649 | {
|
---|
650 | if gio help open 2>/dev/null 1>&2; then
|
---|
651 | gio open "$1"
|
---|
652 | elif gvfs-open --help 2>/dev/null 1>&2; then
|
---|
653 | gvfs-open "$1"
|
---|
654 | else
|
---|
655 | open_generic "$1"
|
---|
656 | fi
|
---|
657 |
|
---|
658 | if [ $? -eq 0 ]; then
|
---|
659 | exit_success
|
---|
660 | else
|
---|
661 | exit_failure_operation_failed
|
---|
662 | fi
|
---|
663 | }
|
---|
664 |
|
---|
665 | open_gnome()
|
---|
666 | {
|
---|
667 | if gio help open 2>/dev/null 1>&2; then
|
---|
668 | gio open "$1"
|
---|
669 | elif gvfs-open --help 2>/dev/null 1>&2; then
|
---|
670 | gvfs-open "$1"
|
---|
671 | elif gnome-open --help 2>/dev/null 1>&2; then
|
---|
672 | gnome-open "$1"
|
---|
673 | else
|
---|
674 | open_generic "$1"
|
---|
675 | fi
|
---|
676 |
|
---|
677 | if [ $? -eq 0 ]; then
|
---|
678 | exit_success
|
---|
679 | else
|
---|
680 | exit_failure_operation_failed
|
---|
681 | fi
|
---|
682 | }
|
---|
683 |
|
---|
684 | open_mate()
|
---|
685 | {
|
---|
686 | if gio help open 2>/dev/null 1>&2; then
|
---|
687 | gio open "$1"
|
---|
688 | elif gvfs-open --help 2>/dev/null 1>&2; then
|
---|
689 | gvfs-open "$1"
|
---|
690 | elif mate-open --help 2>/dev/null 1>&2; then
|
---|
691 | mate-open "$1"
|
---|
692 | else
|
---|
693 | open_generic "$1"
|
---|
694 | fi
|
---|
695 |
|
---|
696 | if [ $? -eq 0 ]; then
|
---|
697 | exit_success
|
---|
698 | else
|
---|
699 | exit_failure_operation_failed
|
---|
700 | fi
|
---|
701 | }
|
---|
702 |
|
---|
703 | open_xfce()
|
---|
704 | {
|
---|
705 | if exo-open --help 2>/dev/null 1>&2; then
|
---|
706 | exo-open "$1"
|
---|
707 | elif gio help open 2>/dev/null 1>&2; then
|
---|
708 | gio open "$1"
|
---|
709 | elif gvfs-open --help 2>/dev/null 1>&2; then
|
---|
710 | gvfs-open "$1"
|
---|
711 | else
|
---|
712 | open_generic "$1"
|
---|
713 | fi
|
---|
714 |
|
---|
715 | if [ $? -eq 0 ]; then
|
---|
716 | exit_success
|
---|
717 | else
|
---|
718 | exit_failure_operation_failed
|
---|
719 | fi
|
---|
720 | }
|
---|
721 |
|
---|
722 | open_enlightenment()
|
---|
723 | {
|
---|
724 | if enlightenment_open --help 2>/dev/null 1>&2; then
|
---|
725 | enlightenment_open "$1"
|
---|
726 | else
|
---|
727 | open_generic "$1"
|
---|
728 | fi
|
---|
729 |
|
---|
730 | if [ $? -eq 0 ]; then
|
---|
731 | exit_success
|
---|
732 | else
|
---|
733 | exit_failure_operation_failed
|
---|
734 | fi
|
---|
735 | }
|
---|
736 |
|
---|
737 | open_flatpak()
|
---|
738 | {
|
---|
739 | gdbus call --session \
|
---|
740 | --dest org.freedesktop.portal.Desktop \
|
---|
741 | --object-path /org/freedesktop/portal/desktop \
|
---|
742 | --method org.freedesktop.portal.OpenURI.OpenURI \
|
---|
743 | "" "$1" {}
|
---|
744 |
|
---|
745 | if [ $? -eq 0 ]; then
|
---|
746 | exit_success
|
---|
747 | else
|
---|
748 | exit_failure_operation_failed
|
---|
749 | fi
|
---|
750 | }
|
---|
751 |
|
---|
752 | #-----------------------------------------
|
---|
753 | # Recursively search .desktop file
|
---|
754 |
|
---|
755 | search_desktop_file()
|
---|
756 | {
|
---|
757 | local default="$1"
|
---|
758 | local dir="$2"
|
---|
759 | local target="$3"
|
---|
760 |
|
---|
761 | local file=""
|
---|
762 | # look for both vendor-app.desktop, vendor/app.desktop
|
---|
763 | if [ -r "$dir/$default" ]; then
|
---|
764 | file="$dir/$default"
|
---|
765 | elif [ -r "$dir/`echo $default | sed -e 's|-|/|'`" ]; then
|
---|
766 | file="$dir/`echo $default | sed -e 's|-|/|'`"
|
---|
767 | fi
|
---|
768 |
|
---|
769 | if [ -r "$file" ] ; then
|
---|
770 | command="$(get_key "${file}" "Exec" | first_word)"
|
---|
771 | command_exec=`which $command 2>/dev/null`
|
---|
772 | icon="$(get_key "${file}" "Icon")"
|
---|
773 | # FIXME: Actually LC_MESSAGES should be used as described in
|
---|
774 | # http://standards.freedesktop.org/desktop-entry-spec/latest/ar01s04.html
|
---|
775 | localised_name="$(get_key "${file}" "Name")"
|
---|
776 | set -- $(get_key "${file}" "Exec" | last_word)
|
---|
777 | # We need to replace any occurrence of "%f", "%F" and
|
---|
778 | # the like by the target file. We examine each
|
---|
779 | # argument and append the modified argument to the
|
---|
780 | # end then shift.
|
---|
781 | local args=$#
|
---|
782 | local replaced=0
|
---|
783 | while [ $args -gt 0 ]; do
|
---|
784 | case $1 in
|
---|
785 | %[c])
|
---|
786 | replaced=1
|
---|
787 | arg="${localised_name}"
|
---|
788 | shift
|
---|
789 | set -- "$@" "$arg"
|
---|
790 | ;;
|
---|
791 | %[fFuU])
|
---|
792 | replaced=1
|
---|
793 | arg="$target"
|
---|
794 | shift
|
---|
795 | set -- "$@" "$arg"
|
---|
796 | ;;
|
---|
797 | %[i])
|
---|
798 | replaced=1
|
---|
799 | shift
|
---|
800 | set -- "$@" "--icon" "$icon"
|
---|
801 | ;;
|
---|
802 | *)
|
---|
803 | arg="$1"
|
---|
804 | shift
|
---|
805 | set -- "$@" "$arg"
|
---|
806 | ;;
|
---|
807 | esac
|
---|
808 | args=$(( $args - 1 ))
|
---|
809 | done
|
---|
810 | [ $replaced -eq 1 ] || set -- "$@" "$target"
|
---|
811 | "$command_exec" "$@"
|
---|
812 |
|
---|
813 | if [ $? -eq 0 ]; then
|
---|
814 | exit_success
|
---|
815 | fi
|
---|
816 | fi
|
---|
817 |
|
---|
818 | for d in $dir/*/; do
|
---|
819 | [ -d "$d" ] && search_desktop_file "$default" "$d" "$target"
|
---|
820 | done
|
---|
821 | }
|
---|
822 |
|
---|
823 |
|
---|
824 | open_generic_xdg_mime()
|
---|
825 | {
|
---|
826 | filetype="$2"
|
---|
827 | default=`xdg-mime query default "$filetype"`
|
---|
828 | if [ -n "$default" ] ; then
|
---|
829 | xdg_user_dir="$XDG_DATA_HOME"
|
---|
830 | [ -n "$xdg_user_dir" ] || xdg_user_dir="$HOME/.local/share"
|
---|
831 |
|
---|
832 | xdg_system_dirs="$XDG_DATA_DIRS"
|
---|
833 | [ -n "$xdg_system_dirs" ] || xdg_system_dirs=/usr/local/share/:/usr/share/
|
---|
834 |
|
---|
835 | DEBUG 3 "$xdg_user_dir:$xdg_system_dirs"
|
---|
836 | for x in `echo "$xdg_user_dir:$xdg_system_dirs" | sed 's/:/ /g'`; do
|
---|
837 | search_desktop_file "$default" "$x/applications/" "$1"
|
---|
838 | done
|
---|
839 | fi
|
---|
840 | }
|
---|
841 |
|
---|
842 | open_generic_xdg_file_mime()
|
---|
843 | {
|
---|
844 | filetype=`xdg-mime query filetype "$1" | sed "s/;.*//"`
|
---|
845 | open_generic_xdg_mime "$1" "$filetype"
|
---|
846 | }
|
---|
847 |
|
---|
848 | open_generic_xdg_x_scheme_handler()
|
---|
849 | {
|
---|
850 | scheme="`echo $1 | sed -n 's/\(^[[:alnum:]+\.-]*\):.*$/\1/p'`"
|
---|
851 | if [ -n $scheme ]; then
|
---|
852 | filetype="x-scheme-handler/$scheme"
|
---|
853 | open_generic_xdg_mime "$1" "$filetype"
|
---|
854 | fi
|
---|
855 | }
|
---|
856 |
|
---|
857 | has_single_argument()
|
---|
858 | {
|
---|
859 | test $# = 1
|
---|
860 | }
|
---|
861 |
|
---|
862 | open_envvar()
|
---|
863 | {
|
---|
864 | local oldifs="$IFS"
|
---|
865 | local browser browser_with_arg
|
---|
866 |
|
---|
867 | IFS=":"
|
---|
868 | for browser in $BROWSER; do
|
---|
869 | IFS="$oldifs"
|
---|
870 |
|
---|
871 | if [ -z "$browser" ]; then
|
---|
872 | continue
|
---|
873 | fi
|
---|
874 |
|
---|
875 | if echo "$browser" | grep -q %s; then
|
---|
876 | # Avoid argument injection.
|
---|
877 | # See https://bugs.freedesktop.org/show_bug.cgi?id=103807
|
---|
878 | # URIs don't have IFS characters spaces anyway.
|
---|
879 | has_single_argument $1 && $(printf "$browser" "$1")
|
---|
880 | else
|
---|
881 | $browser "$1"
|
---|
882 | fi
|
---|
883 |
|
---|
884 | if [ $? -eq 0 ]; then
|
---|
885 | exit_success
|
---|
886 | fi
|
---|
887 | done
|
---|
888 | }
|
---|
889 |
|
---|
890 | open_generic()
|
---|
891 | {
|
---|
892 | if is_file_url_or_path "$1"; then
|
---|
893 | local file="$(file_url_to_path "$1")"
|
---|
894 |
|
---|
895 | check_input_file "$file"
|
---|
896 |
|
---|
897 | if has_display; then
|
---|
898 | filetype=`xdg-mime query filetype "$file" | sed "s/;.*//"`
|
---|
899 | open_generic_xdg_mime "$file" "$filetype"
|
---|
900 | fi
|
---|
901 |
|
---|
902 | if which run-mailcap 2>/dev/null 1>&2; then
|
---|
903 | run-mailcap --action=view "$file"
|
---|
904 | if [ $? -eq 0 ]; then
|
---|
905 | exit_success
|
---|
906 | fi
|
---|
907 | fi
|
---|
908 |
|
---|
909 | if has_display && mimeopen -v 2>/dev/null 1>&2; then
|
---|
910 | mimeopen -L -n "$file"
|
---|
911 | if [ $? -eq 0 ]; then
|
---|
912 | exit_success
|
---|
913 | fi
|
---|
914 | fi
|
---|
915 | fi
|
---|
916 |
|
---|
917 | if has_display; then
|
---|
918 | open_generic_xdg_x_scheme_handler "$1"
|
---|
919 | fi
|
---|
920 |
|
---|
921 | if [ -n "$BROWSER" ]; then
|
---|
922 | open_envvar "$1"
|
---|
923 | fi
|
---|
924 |
|
---|
925 | # if BROWSER variable is not set, check some well known browsers instead
|
---|
926 | if [ x"$BROWSER" = x"" ]; then
|
---|
927 | BROWSER=www-browser:links2:elinks:links:lynx:w3m
|
---|
928 | if has_display; then
|
---|
929 | BROWSER=x-www-browser:firefox:iceweasel:seamonkey:mozilla:epiphany:konqueror:chromium:chromium-browser:google-chrome:$BROWSER
|
---|
930 | fi
|
---|
931 | fi
|
---|
932 |
|
---|
933 | open_envvar "$1"
|
---|
934 |
|
---|
935 | exit_failure_operation_impossible "no method available for opening '$1'"
|
---|
936 | }
|
---|
937 |
|
---|
938 | open_lxde()
|
---|
939 | {
|
---|
940 |
|
---|
941 | # pcmanfm only knows how to handle file:// urls and filepaths, it seems.
|
---|
942 | if pcmanfm --help >/dev/null 2>&1 && is_file_url_or_path "$1"; then
|
---|
943 | local file="$(file_url_to_path "$1")"
|
---|
944 |
|
---|
945 | # handle relative paths
|
---|
946 | if ! echo "$file" | grep -q ^/; then
|
---|
947 | file="$(pwd)/$file"
|
---|
948 | fi
|
---|
949 |
|
---|
950 | pcmanfm "$file"
|
---|
951 | else
|
---|
952 | open_generic "$1"
|
---|
953 | fi
|
---|
954 |
|
---|
955 | if [ $? -eq 0 ]; then
|
---|
956 | exit_success
|
---|
957 | else
|
---|
958 | exit_failure_operation_failed
|
---|
959 | fi
|
---|
960 | }
|
---|
961 |
|
---|
962 | open_lxqt()
|
---|
963 | {
|
---|
964 | open_generic "$1"
|
---|
965 | }
|
---|
966 |
|
---|
967 | [ x"$1" != x"" ] || exit_failure_syntax
|
---|
968 |
|
---|
969 | url=
|
---|
970 | while [ $# -gt 0 ] ; do
|
---|
971 | parm="$1"
|
---|
972 | shift
|
---|
973 |
|
---|
974 | case "$parm" in
|
---|
975 | -*)
|
---|
976 | exit_failure_syntax "unexpected option '$parm'"
|
---|
977 | ;;
|
---|
978 |
|
---|
979 | *)
|
---|
980 | if [ -n "$url" ] ; then
|
---|
981 | exit_failure_syntax "unexpected argument '$parm'"
|
---|
982 | fi
|
---|
983 | url="$parm"
|
---|
984 | ;;
|
---|
985 | esac
|
---|
986 | done
|
---|
987 |
|
---|
988 | if [ -z "${url}" ] ; then
|
---|
989 | exit_failure_syntax "file or URL argument missing"
|
---|
990 | fi
|
---|
991 |
|
---|
992 | detectDE
|
---|
993 |
|
---|
994 | if [ x"$DE" = x"" ]; then
|
---|
995 | DE=generic
|
---|
996 | fi
|
---|
997 |
|
---|
998 | DEBUG 2 "Selected DE $DE"
|
---|
999 |
|
---|
1000 | # sanitize BROWSER (avoid caling ourselves in particular)
|
---|
1001 | case "${BROWSER}" in
|
---|
1002 | *:"xdg-open"|"xdg-open":*)
|
---|
1003 | BROWSER=$(echo $BROWSER | sed -e 's|:xdg-open||g' -e 's|xdg-open:||g')
|
---|
1004 | ;;
|
---|
1005 | "xdg-open")
|
---|
1006 | BROWSER=
|
---|
1007 | ;;
|
---|
1008 | esac
|
---|
1009 |
|
---|
1010 | case "$DE" in
|
---|
1011 | kde)
|
---|
1012 | open_kde "$url"
|
---|
1013 | ;;
|
---|
1014 |
|
---|
1015 | dde)
|
---|
1016 | open_dde "$url"
|
---|
1017 | ;;
|
---|
1018 |
|
---|
1019 | gnome3|cinnamon)
|
---|
1020 | open_gnome3 "$url"
|
---|
1021 | ;;
|
---|
1022 |
|
---|
1023 | gnome)
|
---|
1024 | open_gnome "$url"
|
---|
1025 | ;;
|
---|
1026 |
|
---|
1027 | mate)
|
---|
1028 | open_mate "$url"
|
---|
1029 | ;;
|
---|
1030 |
|
---|
1031 | xfce)
|
---|
1032 | open_xfce "$url"
|
---|
1033 | ;;
|
---|
1034 |
|
---|
1035 | lxde)
|
---|
1036 | open_lxde "$url"
|
---|
1037 | ;;
|
---|
1038 |
|
---|
1039 | lxqt)
|
---|
1040 | open_lxqt "$url"
|
---|
1041 | ;;
|
---|
1042 |
|
---|
1043 | enlightenment)
|
---|
1044 | open_enlightenment "$url"
|
---|
1045 | ;;
|
---|
1046 |
|
---|
1047 | cygwin)
|
---|
1048 | open_cygwin "$url"
|
---|
1049 | ;;
|
---|
1050 |
|
---|
1051 | darwin)
|
---|
1052 | open_darwin "$url"
|
---|
1053 | ;;
|
---|
1054 |
|
---|
1055 | flatpak)
|
---|
1056 | open_flatpak "$url"
|
---|
1057 | ;;
|
---|
1058 |
|
---|
1059 | generic)
|
---|
1060 | open_generic "$url"
|
---|
1061 | ;;
|
---|
1062 |
|
---|
1063 | *)
|
---|
1064 | exit_failure_operation_impossible "no method available for opening '$url'"
|
---|
1065 | ;;
|
---|
1066 | esac
|
---|