Debian Codegraph @

src/xdg-open

raw
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 <[email protected]>
10 # Copyright 2009-2016, Rex Dieter <[email protected]>
11 # Copyright 2006, Kevin Krammer <[email protected]>
12 # Copyright 2006, Jeremy White <[email protected]>
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="`command -v "$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="`command -v "$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="`command -v "$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|Deepin|deepin)
416 DE=deepin;
417 ;;
418 LXDE)
419 DE=lxde;
420 ;;
421 LXQt)
422 DE=lxqt;
423 ;;
424 MATE)
425 DE=mate;
426 ;;
427 XFCE)
428 DE=xfce
429 ;;
430 X-Generic)
431 DE=generic
432 ;;
433 esac
434 fi
435
436 if [ x"$DE" = x"" ]; then
437 # classic fallbacks
438 if [ x"$KDE_FULL_SESSION" != x"" ]; then DE=kde;
439 elif [ x"$GNOME_DESKTOP_SESSION_ID" != x"" ]; then DE=gnome;
440 elif [ x"$MATE_DESKTOP_SESSION_ID" != x"" ]; then DE=mate;
441 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;
442 elif xprop -root _DT_SAVE_MODE 2> /dev/null | grep ' = \"xfce4\"$' >/dev/null 2>&1; then DE=xfce;
443 elif xprop -root 2> /dev/null | grep -i '^xfce_desktop_window' >/dev/null 2>&1; then DE=xfce
444 elif echo $DESKTOP | grep -q '^Enlightenment'; then DE=enlightenment;
445 elif [ x"$LXQT_SESSION_CONFIG" != x"" ]; then DE=lxqt;
446 fi
447 fi
448
449 if [ x"$DE" = x"" ]; then
450 # fallback to checking $DESKTOP_SESSION
451 case "$DESKTOP_SESSION" in
452 gnome)
453 DE=gnome;
454 ;;
455 LXDE|Lubuntu)
456 DE=lxde;
457 ;;
458 MATE)
459 DE=mate;
460 ;;
461 xfce|xfce4|'Xfce Session')
462 DE=xfce;
463 ;;
464 esac
465 fi
466
467 if [ x"$DE" = x"" ]; then
468 # fallback to uname output for other platforms
469 case "$(uname 2>/dev/null)" in
470 CYGWIN*)
471 DE=cygwin;
472 ;;
473 Darwin)
474 DE=darwin;
475 ;;
476 esac
477 fi
478
479 if [ x"$DE" = x"gnome" ]; then
480 # gnome-default-applications-properties is only available in GNOME 2.x
481 # but not in GNOME 3.x
482 command -v gnome-default-applications-properties > /dev/null || DE="gnome3"
483 fi
484
485 if [ -f "$XDG_RUNTIME_DIR/flatpak-info" ]; then
486 DE="flatpak"
487 fi
488 }
489
490 #----------------------------------------------------------------------------
491 # kfmclient exec/openURL can give bogus exit value in KDE <= 3.5.4
492 # It also always returns 1 in KDE 3.4 and earlier
493 # Simply return 0 in such case
494
495 kfmclient_fix_exit_code()
496 {
497 version=`LC_ALL=C.UTF-8 kde-config --version 2>/dev/null | grep '^KDE'`
498 major=`echo $version | sed 's/KDE.*: \([0-9]\).*/\1/'`
499 minor=`echo $version | sed 's/KDE.*: [0-9]*\.\([0-9]\).*/\1/'`
500 release=`echo $version | sed 's/KDE.*: [0-9]*\.[0-9]*\.\([0-9]\).*/\1/'`
501 test "$major" -gt 3 && return $1
502 test "$minor" -gt 5 && return $1
503 test "$release" -gt 4 && return $1
504 return 0
505 }
506
507 #----------------------------------------------------------------------------
508 # Returns true if there is a graphical display attached.
509
510 has_display()
511 {
512 if [ -n "$DISPLAY" ] || [ -n "$WAYLAND_DISPLAY" ]; then
513 return 0
514 else
515 return 1
516 fi
517 }
518
519 # This handles backslashes but not quote marks.
520 last_word()
521 {
522 read first rest
523 echo "$rest"
524 }
525
526 # Get the value of a key in a desktop file's Desktop Entry group.
527 # Example: Use get_key foo.desktop Exec
528 # to get the values of the Exec= key for the Desktop Entry group.
529 get_key()
530 {
531 local file="${1}"
532 local key="${2}"
533 local desktop_entry=""
534
535 IFS_="${IFS}"
536 IFS=""
537 while read line
538 do
539 case "$line" in
540 "[Desktop Entry]")
541 desktop_entry="y"
542 ;;
543 # Reset match flag for other groups
544 "["*)
545 desktop_entry=""
546 ;;
547 "${key}="*)
548 # Only match Desktop Entry group
549 if [ -n "${desktop_entry}" ]
550 then
551 echo "${line}" | cut -d= -f 2-
552 fi
553 esac
554 done < "${file}"
555 IFS="${IFS_}"
556 }
557
558 # Returns true if argument is a file:// URL or path
559 is_file_url_or_path()
560 {
561 if echo "$1" | grep -q '^file://' \
562 || ! echo "$1" | grep -Eq '^[[:alpha:]][[:alpha:][:digit:]+\.\-]*:'; then
563 return 0
564 else
565 return 1
566 fi
567 }
568
569 # If argument is a file URL, convert it to a (percent-decoded) path.
570 # If not, leave it as it is.
571 file_url_to_path()
572 {
573 local file="$1"
574 if echo "$file" | grep -q '^file://\(localhost\)\?/'; then
575 file=${file#file://localhost}
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_deepin()
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 icon="$(get_key "${file}" "Icon")"
772 # FIXME: Actually LC_MESSAGES should be used as described in
773 # http://standards.freedesktop.org/desktop-entry-spec/latest/ar01s04.html
774 localised_name="$(get_key "${file}" "Name")"
775 set -- $(get_key "${file}" "Exec" | last_word)
776 # We need to replace any occurrence of "%f", "%F" and
777 # the like by the target file. We examine each
778 # argument and append the modified argument to the
779 # end then shift.
780 local args=$#
781 local replaced=0
782 while [ $args -gt 0 ]; do
783 case $1 in
784 %[c])
785 replaced=1
786 arg="${localised_name}"
787 shift
788 set -- "$@" "$arg"
789 ;;
790 %[fFuU])
791 replaced=1
792 arg="$target"
793 shift
794 set -- "$@" "$arg"
795 ;;
796 %[i])
797 replaced=1
798 shift
799 set -- "$@" "--icon" "$icon"
800 ;;
801 *)
802 arg="$1"
803 shift
804 set -- "$@" "$arg"
805 ;;
806 esac
807 args=$(( $args - 1 ))
808 done
809 [ $replaced -eq 1 ] || set -- "$@" "$target"
810 env "$command" "$@"
811
812 if [ $? -eq 0 ]; then
813 exit_success
814 fi
815 fi
816
817 for d in "$dir/"*/; do
818 [ -d "$d" ] && search_desktop_file "$default" "$d" "$target"
819 done
820 }
821
822
823 open_generic_xdg_mime()
824 {
825 filetype="$2"
826 default=`xdg-mime query default "$filetype"`
827 if [ -n "$default" ] ; then
828 xdg_user_dir="$XDG_DATA_HOME"
829 [ -n "$xdg_user_dir" ] || xdg_user_dir="$HOME/.local/share"
830
831 xdg_system_dirs="$XDG_DATA_DIRS"
832 [ -n "$xdg_system_dirs" ] || xdg_system_dirs=/usr/local/share/:/usr/share/
833
834 DEBUG 3 "$xdg_user_dir:$xdg_system_dirs"
835 for x in `echo "$xdg_user_dir:$xdg_system_dirs" | sed 's/:/ /g'`; do
836 search_desktop_file "$default" "$x/applications/" "$1"
837 done
838 fi
839 }
840
841 open_generic_xdg_file_mime()
842 {
843 filetype=`xdg-mime query filetype "$1" | sed "s/;.*//"`
844 open_generic_xdg_mime "$1" "$filetype"
845 }
846
847 open_generic_xdg_x_scheme_handler()
848 {
849 scheme="`echo $1 | sed -n 's/\(^[[:alnum:]+\.-]*\):.*$/\1/p'`"
850 if [ -n $scheme ]; then
851 filetype="x-scheme-handler/$scheme"
852 open_generic_xdg_mime "$1" "$filetype"
853 fi
854 }
855
856 has_single_argument()
857 {
858 test $# = 1
859 }
860
861 open_envvar()
862 {
863 local oldifs="$IFS"
864 local browser browser_with_arg
865
866 IFS=":"
867 for browser in $BROWSER; do
868 IFS="$oldifs"
869
870 if [ -z "$browser" ]; then
871 continue
872 fi
873
874 if echo "$browser" | grep -q %s; then
875 # Avoid argument injection.
876 # See https://bugs.freedesktop.org/show_bug.cgi?id=103807
877 # URIs don't have IFS characters spaces anyway.
878 has_single_argument $1 && $(printf "$browser" "$1")
879 else
880 $browser "$1"
881 fi
882
883 if [ $? -eq 0 ]; then
884 exit_success
885 fi
886 done
887 }
888
889 open_generic()
890 {
891 if is_file_url_or_path "$1"; then
892 local file="$(file_url_to_path "$1")"
893
894 check_input_file "$file"
895
896 if has_display; then
897 filetype=`xdg-mime query filetype "$file" | sed "s/;.*//"`
898 open_generic_xdg_mime "$file" "$filetype"
899 fi
900
901 if command -v run-mailcap >/dev/null; then
902 run-mailcap --action=view "$file"
903 if [ $? -eq 0 ]; then
904 exit_success
905 fi
906 fi
907
908 if has_display && mimeopen -v 2>/dev/null 1>&2; then
909 mimeopen -L -n "$file"
910 if [ $? -eq 0 ]; then
911 exit_success
912 fi
913 fi
914 fi
915
916 if has_display; then
917 open_generic_xdg_x_scheme_handler "$1"
918 fi
919
920 if [ -n "$BROWSER" ]; then
921 open_envvar "$1"
922 fi
923
924 # if BROWSER variable is not set, check some well known browsers instead
925 if [ x"$BROWSER" = x"" ]; then
926 BROWSER=www-browser:links2:elinks:links:lynx:w3m
927 if has_display; then
928 BROWSER=x-www-browser:firefox:iceweasel:seamonkey:mozilla:epiphany:konqueror:chromium:chromium-browser:google-chrome:$BROWSER
929 fi
930 fi
931
932 open_envvar "$1"
933
934 exit_failure_operation_impossible "no method available for opening '$1'"
935 }
936
937 open_lxde()
938 {
939
940 # pcmanfm only knows how to handle file:// urls and filepaths, it seems.
941 if pcmanfm --help >/dev/null 2>&1 && is_file_url_or_path "$1"; then
942 local file="$(file_url_to_path "$1")"
943
944 # handle relative paths
945 if ! echo "$file" | grep -q ^/; then
946 file="$(pwd)/$file"
947 fi
948
949 pcmanfm "$file"
950 else
951 open_generic "$1"
952 fi
953
954 if [ $? -eq 0 ]; then
955 exit_success
956 else
957 exit_failure_operation_failed
958 fi
959 }
960
961 open_lxqt()
962 {
963 open_generic "$1"
964 }
965
966 [ x"$1" != x"" ] || exit_failure_syntax
967
968 url=
969 while [ $# -gt 0 ] ; do
970 parm="$1"
971 shift
972
973 case "$parm" in
974 -*)
975 exit_failure_syntax "unexpected option '$parm'"
976 ;;
977
978 *)
979 if [ -n "$url" ] ; then
980 exit_failure_syntax "unexpected argument '$parm'"
981 fi
982 url="$parm"
983 ;;
984 esac
985 done
986
987 if [ -z "${url}" ] ; then
988 exit_failure_syntax "file or URL argument missing"
989 fi
990
991 detectDE
992
993 if [ x"$DE" = x"" ]; then
994 DE=generic
995 fi
996
997 DEBUG 2 "Selected DE $DE"
998
999 # sanitize BROWSER (avoid calling ourselves in particular)
1000 case "${BROWSER}" in
1001 *:"xdg-open"|"xdg-open":*)
1002 BROWSER=$(echo $BROWSER | sed -e 's|:xdg-open||g' -e 's|xdg-open:||g')
1003 ;;
1004 "xdg-open")
1005 BROWSER=
1006 ;;
1007 esac
1008
1009 case "$DE" in
1010 kde)
1011 open_kde "$url"
1012 ;;
1013
1014 deepin)
1015 open_deepin "$url"
1016 ;;
1017
1018 gnome3|cinnamon)
1019 open_gnome3 "$url"
1020 ;;
1021
1022 gnome)
1023 open_gnome "$url"
1024 ;;
1025
1026 mate)
1027 open_mate "$url"
1028 ;;
1029
1030 xfce)
1031 open_xfce "$url"
1032 ;;
1033
1034 lxde)
1035 open_lxde "$url"
1036 ;;
1037
1038 lxqt)
1039 open_lxqt "$url"
1040 ;;
1041
1042 enlightenment)
1043 open_enlightenment "$url"
1044 ;;
1045
1046 cygwin)
1047 open_cygwin "$url"
1048 ;;
1049
1050 darwin)
1051 open_darwin "$url"
1052 ;;
1053
1054 flatpak)
1055 open_flatpak "$url"
1056 ;;
1057
1058 generic)
1059 open_generic "$url"
1060 ;;
1061
1062 *)
1063 exit_failure_operation_impossible "no method available for opening '$url'"
1064 ;;
1065 esac