patchright-bun-core 1.58.0 → 1.58.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (358) hide show
  1. package/README.md +2 -2
  2. package/ThirdPartyNotices.txt +4075 -4075
  3. package/bin/install_media_pack.ps1 +5 -5
  4. package/bin/install_webkit_wsl.ps1 +32 -32
  5. package/bin/reinstall_chrome_beta_linux.sh +42 -42
  6. package/bin/reinstall_chrome_beta_mac.sh +13 -13
  7. package/bin/reinstall_chrome_beta_win.ps1 +24 -24
  8. package/bin/reinstall_chrome_stable_linux.sh +42 -42
  9. package/bin/reinstall_chrome_stable_mac.sh +12 -12
  10. package/bin/reinstall_chrome_stable_win.ps1 +24 -24
  11. package/bin/reinstall_msedge_beta_linux.sh +48 -48
  12. package/bin/reinstall_msedge_beta_mac.sh +11 -11
  13. package/bin/reinstall_msedge_beta_win.ps1 +23 -23
  14. package/bin/reinstall_msedge_dev_linux.sh +48 -48
  15. package/bin/reinstall_msedge_dev_mac.sh +11 -11
  16. package/bin/reinstall_msedge_dev_win.ps1 +23 -23
  17. package/bin/reinstall_msedge_stable_linux.sh +48 -48
  18. package/bin/reinstall_msedge_stable_mac.sh +11 -11
  19. package/bin/reinstall_msedge_stable_win.ps1 +23 -23
  20. package/browsers.json +79 -79
  21. package/cli.js +18 -18
  22. package/index.d.ts +17 -17
  23. package/index.js +32 -32
  24. package/index.mjs +28 -28
  25. package/lib/androidServerImpl.js +65 -65
  26. package/lib/browserServerImpl.js +120 -120
  27. package/lib/cli/driver.js +97 -97
  28. package/lib/cli/program.js +589 -589
  29. package/lib/cli/programWithTestStub.js +74 -74
  30. package/lib/client/android.js +361 -361
  31. package/lib/client/api.js +137 -137
  32. package/lib/client/artifact.js +79 -79
  33. package/lib/client/browser.js +161 -161
  34. package/lib/client/browserContext.js +582 -582
  35. package/lib/client/browserType.js +185 -185
  36. package/lib/client/cdpSession.js +51 -51
  37. package/lib/client/channelOwner.js +194 -194
  38. package/lib/client/clientHelper.js +64 -64
  39. package/lib/client/clientInstrumentation.js +55 -55
  40. package/lib/client/clientStackTrace.js +69 -69
  41. package/lib/client/clock.js +68 -68
  42. package/lib/client/connection.js +318 -318
  43. package/lib/client/consoleMessage.js +58 -58
  44. package/lib/client/coverage.js +44 -44
  45. package/lib/client/dialog.js +56 -56
  46. package/lib/client/download.js +62 -62
  47. package/lib/client/electron.js +138 -138
  48. package/lib/client/elementHandle.js +284 -284
  49. package/lib/client/errors.js +77 -77
  50. package/lib/client/eventEmitter.js +314 -314
  51. package/lib/client/events.js +103 -103
  52. package/lib/client/fetch.js +368 -368
  53. package/lib/client/fileChooser.js +46 -46
  54. package/lib/client/fileUtils.js +34 -34
  55. package/lib/client/frame.js +409 -409
  56. package/lib/client/harRouter.js +87 -87
  57. package/lib/client/input.js +84 -84
  58. package/lib/client/jsHandle.js +109 -109
  59. package/lib/client/jsonPipe.js +39 -39
  60. package/lib/client/localUtils.js +60 -60
  61. package/lib/client/locator.js +369 -369
  62. package/lib/client/network.js +747 -747
  63. package/lib/client/page.js +745 -745
  64. package/lib/client/pageAgent.js +64 -64
  65. package/lib/client/platform.js +77 -77
  66. package/lib/client/playwright.js +71 -71
  67. package/lib/client/selectors.js +55 -55
  68. package/lib/client/stream.js +39 -39
  69. package/lib/client/timeoutSettings.js +79 -79
  70. package/lib/client/tracing.js +119 -119
  71. package/lib/client/types.js +28 -28
  72. package/lib/client/video.js +59 -59
  73. package/lib/client/waiter.js +142 -142
  74. package/lib/client/webError.js +39 -39
  75. package/lib/client/webSocket.js +93 -93
  76. package/lib/client/worker.js +85 -85
  77. package/lib/client/writableStream.js +39 -39
  78. package/lib/generated/bindingsControllerSource.js +28 -28
  79. package/lib/generated/clockSource.js +28 -28
  80. package/lib/generated/injectedScriptSource.js +28 -28
  81. package/lib/generated/pollingRecorderSource.js +28 -28
  82. package/lib/generated/storageScriptSource.js +28 -28
  83. package/lib/generated/utilityScriptSource.js +28 -28
  84. package/lib/generated/webSocketMockSource.js +336 -336
  85. package/lib/inProcessFactory.js +60 -60
  86. package/lib/inprocess.js +3 -3
  87. package/lib/mcpBundle.js +84 -84
  88. package/lib/mcpBundleImpl/index.js +147 -147
  89. package/lib/outofprocess.js +76 -76
  90. package/lib/protocol/serializers.js +197 -197
  91. package/lib/protocol/validator.js +2969 -2969
  92. package/lib/protocol/validatorPrimitives.js +193 -193
  93. package/lib/remote/playwrightConnection.js +129 -129
  94. package/lib/remote/playwrightServer.js +334 -334
  95. package/lib/server/agent/actionRunner.js +335 -335
  96. package/lib/server/agent/actions.js +128 -128
  97. package/lib/server/agent/codegen.js +111 -111
  98. package/lib/server/agent/context.js +150 -150
  99. package/lib/server/agent/expectTools.js +156 -156
  100. package/lib/server/agent/pageAgent.js +204 -204
  101. package/lib/server/agent/performTools.js +262 -262
  102. package/lib/server/agent/tool.js +109 -109
  103. package/lib/server/android/android.js +465 -465
  104. package/lib/server/android/backendAdb.js +177 -177
  105. package/lib/server/artifact.js +127 -127
  106. package/lib/server/bidi/bidiBrowser.js +549 -549
  107. package/lib/server/bidi/bidiChromium.js +149 -148
  108. package/lib/server/bidi/bidiConnection.js +213 -213
  109. package/lib/server/bidi/bidiDeserializer.js +116 -116
  110. package/lib/server/bidi/bidiExecutionContext.js +267 -267
  111. package/lib/server/bidi/bidiFirefox.js +128 -128
  112. package/lib/server/bidi/bidiInput.js +146 -146
  113. package/lib/server/bidi/bidiNetworkManager.js +383 -383
  114. package/lib/server/bidi/bidiOverCdp.js +102 -102
  115. package/lib/server/bidi/bidiPage.js +583 -583
  116. package/lib/server/bidi/bidiPdf.js +106 -106
  117. package/lib/server/bidi/third_party/bidiCommands.d.js +22 -22
  118. package/lib/server/bidi/third_party/bidiKeyboard.js +256 -256
  119. package/lib/server/bidi/third_party/bidiProtocol.js +24 -24
  120. package/lib/server/bidi/third_party/bidiProtocolCore.js +180 -180
  121. package/lib/server/bidi/third_party/bidiProtocolPermissions.js +42 -42
  122. package/lib/server/bidi/third_party/bidiSerializer.js +148 -148
  123. package/lib/server/bidi/third_party/firefoxPrefs.js +259 -259
  124. package/lib/server/browser.js +149 -149
  125. package/lib/server/browserContext.js +702 -702
  126. package/lib/server/browserType.js +336 -336
  127. package/lib/server/callLog.js +82 -82
  128. package/lib/server/chromium/chromium.js +397 -395
  129. package/lib/server/chromium/chromiumSwitches.js +104 -104
  130. package/lib/server/chromium/crBrowser.js +520 -511
  131. package/lib/server/chromium/crConnection.js +197 -197
  132. package/lib/server/chromium/crCoverage.js +235 -235
  133. package/lib/server/chromium/crDevTools.js +111 -111
  134. package/lib/server/chromium/crDragDrop.js +131 -131
  135. package/lib/server/chromium/crExecutionContext.js +146 -146
  136. package/lib/server/chromium/crInput.js +187 -187
  137. package/lib/server/chromium/crNetworkManager.js +707 -707
  138. package/lib/server/chromium/crPage.js +1001 -1001
  139. package/lib/server/chromium/crPdf.js +121 -121
  140. package/lib/server/chromium/crProtocolHelper.js +145 -145
  141. package/lib/server/chromium/crServiceWorker.js +136 -136
  142. package/lib/server/chromium/defaultFontFamilies.js +162 -162
  143. package/lib/server/chromium/protocol.d.js +16 -16
  144. package/lib/server/clock.js +149 -149
  145. package/lib/server/codegen/csharp.js +327 -327
  146. package/lib/server/codegen/java.js +274 -274
  147. package/lib/server/codegen/javascript.js +247 -247
  148. package/lib/server/codegen/jsonl.js +52 -52
  149. package/lib/server/codegen/language.js +132 -132
  150. package/lib/server/codegen/languages.js +68 -68
  151. package/lib/server/codegen/python.js +279 -279
  152. package/lib/server/codegen/types.js +16 -16
  153. package/lib/server/console.js +57 -57
  154. package/lib/server/cookieStore.js +206 -206
  155. package/lib/server/debugController.js +191 -191
  156. package/lib/server/debugger.js +119 -119
  157. package/lib/server/deviceDescriptors.js +39 -39
  158. package/lib/server/deviceDescriptorsSource.json +1778 -1778
  159. package/lib/server/dialog.js +116 -116
  160. package/lib/server/dispatchers/androidDispatcher.js +325 -325
  161. package/lib/server/dispatchers/artifactDispatcher.js +118 -118
  162. package/lib/server/dispatchers/browserContextDispatcher.js +384 -384
  163. package/lib/server/dispatchers/browserDispatcher.js +118 -118
  164. package/lib/server/dispatchers/browserTypeDispatcher.js +64 -64
  165. package/lib/server/dispatchers/cdpSessionDispatcher.js +44 -44
  166. package/lib/server/dispatchers/debugControllerDispatcher.js +78 -78
  167. package/lib/server/dispatchers/dialogDispatcher.js +47 -47
  168. package/lib/server/dispatchers/dispatcher.js +364 -364
  169. package/lib/server/dispatchers/electronDispatcher.js +89 -89
  170. package/lib/server/dispatchers/elementHandlerDispatcher.js +181 -181
  171. package/lib/server/dispatchers/frameDispatcher.js +227 -227
  172. package/lib/server/dispatchers/jsHandleDispatcher.js +85 -85
  173. package/lib/server/dispatchers/jsonPipeDispatcher.js +58 -58
  174. package/lib/server/dispatchers/localUtilsDispatcher.js +149 -149
  175. package/lib/server/dispatchers/networkDispatchers.js +213 -213
  176. package/lib/server/dispatchers/pageAgentDispatcher.js +96 -96
  177. package/lib/server/dispatchers/pageDispatcher.js +393 -393
  178. package/lib/server/dispatchers/playwrightDispatcher.js +108 -108
  179. package/lib/server/dispatchers/streamDispatcher.js +67 -67
  180. package/lib/server/dispatchers/tracingDispatcher.js +68 -68
  181. package/lib/server/dispatchers/webSocketRouteDispatcher.js +165 -165
  182. package/lib/server/dispatchers/writableStreamDispatcher.js +79 -79
  183. package/lib/server/dom.js +815 -815
  184. package/lib/server/download.js +70 -70
  185. package/lib/server/electron/electron.js +273 -273
  186. package/lib/server/electron/loader.js +29 -29
  187. package/lib/server/errors.js +69 -69
  188. package/lib/server/fetch.js +621 -621
  189. package/lib/server/fileChooser.js +43 -43
  190. package/lib/server/fileUploadUtils.js +84 -84
  191. package/lib/server/firefox/ffBrowser.js +418 -418
  192. package/lib/server/firefox/ffConnection.js +142 -142
  193. package/lib/server/firefox/ffExecutionContext.js +150 -150
  194. package/lib/server/firefox/ffInput.js +159 -159
  195. package/lib/server/firefox/ffNetworkManager.js +256 -256
  196. package/lib/server/firefox/ffPage.js +497 -497
  197. package/lib/server/firefox/firefox.js +114 -114
  198. package/lib/server/firefox/protocol.d.js +16 -16
  199. package/lib/server/formData.js +147 -147
  200. package/lib/server/frameSelectors.js +160 -160
  201. package/lib/server/frames.js +1471 -1471
  202. package/lib/server/har/harRecorder.js +147 -147
  203. package/lib/server/har/harTracer.js +607 -607
  204. package/lib/server/harBackend.js +157 -157
  205. package/lib/server/helper.js +96 -96
  206. package/lib/server/index.js +58 -58
  207. package/lib/server/input.js +277 -277
  208. package/lib/server/instrumentation.js +72 -72
  209. package/lib/server/javascript.js +291 -291
  210. package/lib/server/launchApp.js +128 -128
  211. package/lib/server/localUtils.js +214 -214
  212. package/lib/server/macEditingCommands.js +143 -143
  213. package/lib/server/network.js +667 -667
  214. package/lib/server/page.js +830 -830
  215. package/lib/server/pipeTransport.js +89 -89
  216. package/lib/server/playwright.js +69 -69
  217. package/lib/server/progress.js +132 -132
  218. package/lib/server/protocolError.js +52 -52
  219. package/lib/server/recorder/chat.js +161 -161
  220. package/lib/server/recorder/recorderApp.js +366 -366
  221. package/lib/server/recorder/recorderRunner.js +138 -138
  222. package/lib/server/recorder/recorderSignalProcessor.js +83 -83
  223. package/lib/server/recorder/recorderUtils.js +157 -157
  224. package/lib/server/recorder/throttledFile.js +57 -57
  225. package/lib/server/recorder.js +499 -499
  226. package/lib/server/registry/browserFetcher.js +177 -177
  227. package/lib/server/registry/dependencies.js +371 -371
  228. package/lib/server/registry/index.js +1422 -1422
  229. package/lib/server/registry/nativeDeps.js +1280 -1280
  230. package/lib/server/registry/oopDownloadBrowserMain.js +127 -127
  231. package/lib/server/screencast.js +190 -190
  232. package/lib/server/screenshotter.js +333 -333
  233. package/lib/server/selectors.js +112 -112
  234. package/lib/server/socksClientCertificatesInterceptor.js +383 -383
  235. package/lib/server/socksInterceptor.js +95 -95
  236. package/lib/server/trace/recorder/snapshotter.js +147 -147
  237. package/lib/server/trace/recorder/snapshotterInjected.js +561 -561
  238. package/lib/server/trace/recorder/tracing.js +604 -604
  239. package/lib/server/trace/viewer/traceParser.js +72 -72
  240. package/lib/server/trace/viewer/traceViewer.js +245 -245
  241. package/lib/server/transport.js +254 -254
  242. package/lib/server/types.js +28 -28
  243. package/lib/server/usKeyboardLayout.js +145 -145
  244. package/lib/server/utils/ascii.js +44 -44
  245. package/lib/server/utils/comparators.js +139 -139
  246. package/lib/server/utils/crypto.js +216 -216
  247. package/lib/server/utils/debug.js +42 -42
  248. package/lib/server/utils/debugLogger.js +122 -122
  249. package/lib/server/utils/env.js +73 -73
  250. package/lib/server/utils/eventsHelper.js +39 -39
  251. package/lib/server/utils/expectUtils.js +123 -123
  252. package/lib/server/utils/fileUtils.js +191 -191
  253. package/lib/server/utils/happyEyeballs.js +207 -207
  254. package/lib/server/utils/hostPlatform.js +138 -123
  255. package/lib/server/utils/httpServer.js +203 -203
  256. package/lib/server/utils/imageUtils.js +141 -141
  257. package/lib/server/utils/image_tools/colorUtils.js +89 -89
  258. package/lib/server/utils/image_tools/compare.js +109 -109
  259. package/lib/server/utils/image_tools/imageChannel.js +78 -78
  260. package/lib/server/utils/image_tools/stats.js +102 -102
  261. package/lib/server/utils/linuxUtils.js +71 -71
  262. package/lib/server/utils/network.js +242 -242
  263. package/lib/server/utils/nodePlatform.js +154 -154
  264. package/lib/server/utils/pipeTransport.js +84 -84
  265. package/lib/server/utils/processLauncher.js +241 -241
  266. package/lib/server/utils/profiler.js +65 -65
  267. package/lib/server/utils/socksProxy.js +511 -511
  268. package/lib/server/utils/spawnAsync.js +41 -41
  269. package/lib/server/utils/task.js +51 -51
  270. package/lib/server/utils/userAgent.js +98 -98
  271. package/lib/server/utils/wsServer.js +121 -121
  272. package/lib/server/utils/zipFile.js +74 -74
  273. package/lib/server/utils/zones.js +57 -57
  274. package/lib/server/videoRecorder.js +124 -124
  275. package/lib/server/webkit/protocol.d.js +16 -16
  276. package/lib/server/webkit/webkit.js +108 -108
  277. package/lib/server/webkit/wkBrowser.js +335 -335
  278. package/lib/server/webkit/wkConnection.js +144 -144
  279. package/lib/server/webkit/wkExecutionContext.js +154 -154
  280. package/lib/server/webkit/wkInput.js +181 -181
  281. package/lib/server/webkit/wkInterceptableRequest.js +197 -197
  282. package/lib/server/webkit/wkPage.js +1159 -1158
  283. package/lib/server/webkit/wkProvisionalPage.js +83 -83
  284. package/lib/server/webkit/wkWorkers.js +105 -105
  285. package/lib/third_party/pixelmatch.js +255 -255
  286. package/lib/utils/isomorphic/ariaSnapshot.js +455 -455
  287. package/lib/utils/isomorphic/assert.js +31 -31
  288. package/lib/utils/isomorphic/colors.js +72 -72
  289. package/lib/utils/isomorphic/cssParser.js +245 -245
  290. package/lib/utils/isomorphic/cssTokenizer.js +1051 -1051
  291. package/lib/utils/isomorphic/headers.js +53 -53
  292. package/lib/utils/isomorphic/locatorGenerators.js +689 -689
  293. package/lib/utils/isomorphic/locatorParser.js +176 -176
  294. package/lib/utils/isomorphic/locatorUtils.js +81 -81
  295. package/lib/utils/isomorphic/lruCache.js +51 -51
  296. package/lib/utils/isomorphic/manualPromise.js +114 -114
  297. package/lib/utils/isomorphic/mimeType.js +459 -459
  298. package/lib/utils/isomorphic/multimap.js +80 -80
  299. package/lib/utils/isomorphic/protocolFormatter.js +81 -81
  300. package/lib/utils/isomorphic/protocolMetainfo.js +330 -330
  301. package/lib/utils/isomorphic/rtti.js +43 -43
  302. package/lib/utils/isomorphic/selectorParser.js +386 -386
  303. package/lib/utils/isomorphic/semaphore.js +54 -54
  304. package/lib/utils/isomorphic/stackTrace.js +158 -158
  305. package/lib/utils/isomorphic/stringUtils.js +204 -204
  306. package/lib/utils/isomorphic/time.js +49 -49
  307. package/lib/utils/isomorphic/timeoutRunner.js +66 -66
  308. package/lib/utils/isomorphic/trace/entries.js +16 -16
  309. package/lib/utils/isomorphic/trace/snapshotRenderer.js +499 -499
  310. package/lib/utils/isomorphic/trace/snapshotServer.js +120 -120
  311. package/lib/utils/isomorphic/trace/snapshotStorage.js +89 -89
  312. package/lib/utils/isomorphic/trace/traceLoader.js +131 -131
  313. package/lib/utils/isomorphic/trace/traceModel.js +365 -365
  314. package/lib/utils/isomorphic/trace/traceModernizer.js +400 -400
  315. package/lib/utils/isomorphic/trace/versions/traceV3.js +16 -16
  316. package/lib/utils/isomorphic/trace/versions/traceV4.js +16 -16
  317. package/lib/utils/isomorphic/trace/versions/traceV5.js +16 -16
  318. package/lib/utils/isomorphic/trace/versions/traceV6.js +16 -16
  319. package/lib/utils/isomorphic/trace/versions/traceV7.js +16 -16
  320. package/lib/utils/isomorphic/trace/versions/traceV8.js +16 -16
  321. package/lib/utils/isomorphic/traceUtils.js +58 -58
  322. package/lib/utils/isomorphic/types.js +16 -16
  323. package/lib/utils/isomorphic/urlMatch.js +190 -190
  324. package/lib/utils/isomorphic/utilityScriptSerializers.js +251 -251
  325. package/lib/utils/isomorphic/yaml.js +84 -84
  326. package/lib/utils.js +111 -111
  327. package/lib/utilsBundle.js +109 -109
  328. package/lib/utilsBundleImpl/index.js +218 -218
  329. package/lib/utilsBundleImpl/xdg-open +1066 -1066
  330. package/lib/vite/htmlReport/index.html +84 -84
  331. package/lib/vite/recorder/assets/codeMirrorModule-DYBRYzYX.css +1 -1
  332. package/lib/vite/recorder/assets/codeMirrorModule-DadYNm1I.js +32 -32
  333. package/lib/vite/recorder/assets/index-BSjZa4pk.css +1 -1
  334. package/lib/vite/recorder/assets/index-BhTWtUlo.js +193 -193
  335. package/lib/vite/recorder/index.html +29 -29
  336. package/lib/vite/recorder/playwright-logo.svg +9 -9
  337. package/lib/vite/traceViewer/assets/codeMirrorModule-a5XoALAZ.js +32 -32
  338. package/lib/vite/traceViewer/assets/defaultSettingsView-CJSZINFr.js +266 -266
  339. package/lib/vite/traceViewer/assets/xtermModule-CsJ4vdCR.js +9 -9
  340. package/lib/vite/traceViewer/codeMirrorModule.DYBRYzYX.css +1 -1
  341. package/lib/vite/traceViewer/defaultSettingsView.7ch9cixO.css +1 -1
  342. package/lib/vite/traceViewer/{index.Bk2uYQRV.js → index.BDwrLSGN.js} +2 -2
  343. package/lib/vite/traceViewer/index.BVu7tZDe.css +1 -1
  344. package/lib/vite/traceViewer/index.html +43 -43
  345. package/lib/vite/traceViewer/manifest.webmanifest +16 -16
  346. package/lib/vite/traceViewer/playwright-logo.svg +9 -9
  347. package/lib/vite/traceViewer/snapshot.html +21 -21
  348. package/lib/vite/traceViewer/sw.bundle.js +5 -5
  349. package/lib/vite/traceViewer/uiMode.Btcz36p_.css +1 -1
  350. package/lib/vite/traceViewer/uiMode.CQJ9SCIQ.js +5 -5
  351. package/lib/vite/traceViewer/uiMode.html +17 -17
  352. package/lib/vite/traceViewer/xtermModule.DYP7pi_n.css +32 -32
  353. package/lib/zipBundle.js +34 -34
  354. package/lib/zipBundleImpl.js +5 -5
  355. package/package.json +1 -1
  356. package/types/protocol.d.ts +23824 -23824
  357. package/types/structs.d.ts +45 -45
  358. package/types/types.d.ts +22843 -22843
@@ -1,1066 +1,1066 @@
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:microsoft-edge:$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
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:microsoft-edge:$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