| 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 |