xdg-open - Revision history

Woozle at 00:47, 3 January 2024

2024-01-03T00:47:48Z

← Older revision		Revision as of 00:47, 3 January 2024
Line 3:		Line 3:
	==About==		==About==
	{{fmt/quote\|[[xdg-open]] is a command-line utility for opening files and URLs using the default applications as specified by the user's desktop environment.}}<ref name=chatgpt1 /> Its current implementation (as of Ubuntu-MATE 23.10) is as a [[bash]] script which determines which desktop environment (DE) is running, and then delegates to the appropriate command for that DE. In other words, it's a slightly klugey bit of glue that deals with the lack of a standard URL-opening function across different DEs.		{{fmt/quote\|[[xdg-open]] is a command-line utility for opening files and URLs using the default applications as specified by the user's desktop environment.}}<ref name=chatgpt1 /> Its current implementation (as of Ubuntu-MATE 23.10) is as a [[bash]] script which determines which desktop environment (DE) is running, and then delegates to the appropriate command for that DE. In other words, it's a slightly klugey bit of glue that deals with the lack of a standard URL-opening function across different DEs.
			==How To==
	* [[/~~notes~~]]		* [[/how to/add custom protocol\|add a custom protocol]]
	==Delegation==		==Delegation==
	Some of the commands to which [[xdg-open]] will delegate:		Some of the commands to which [[xdg-open]] will delegate:

Woozle at 17:51, 2 January 2024

2024-01-02T17:51:44Z

← Older revision		Revision as of 17:51, 2 January 2024
Line 5:		Line 5:

	* [[/notes]]		* [[/notes]]
			==Delegation==
			Some of the commands to which [[xdg-open]] will delegate:
			* {{l/cmd\|enlightenment_open}} (e)
			* {{l/cmd\|exo-open}} ([[XFCE]])
			* {{l/cmd\|gio}} open (Gnome3, [[MATE]], XFCE)
			* {{l/cmd\|gvfs-open}} (Gnome3, MATE, XFCE)
			* {{l/cmd\|kde-open}} ([[KDE]])
			* {{l/cmd\|kfmclient}} (KDE)
			* {{l/cmd\|gnome-open}} (Gnome)
			* {{l/cmd\|open_generic}} (e, Gnome, Gnome3, MATE, XFCE)
	==Footnotes==		==Footnotes==
	<references>		<references>
	<ref name=chatgpt1>'''2024-01-01''' ChatGPT 3.5, in response to "How can I add a custom protocol to xdg-open?"</ref>		<ref name=chatgpt1>'''2024-01-01''' ChatGPT 3.5, in response to "How can I add a custom protocol to xdg-open?"</ref>
	</references>		</references>

Woozle at 16:54, 2 January 2024

2024-01-02T16:54:02Z

@@ Line 2: / Line 2: @@
 [[category:open-source]]
 ==About==
-{{fmt/quote|[[xdg-open]] is a command-line utility for opening files and URLs using the default applications as specified by the user's desktop environment.}}<ref name=chatgpt1 />
+{{fmt/quote|[[xdg-open]] is a command-line utility for opening files and URLs using the default applications as specified by the user's desktop environment.}}<ref name=chatgpt1 /> Its current implementation (as of Ubuntu-MATE 23.10) is as a [[bash]] script which determines which desktop environment (DE) is running, and then delegates to the appropriate command for that DE. In other words, it's a slightly klugey bit of glue that deals with the lack of a standard URL-opening function across different DEs.
-''These instructions have not yet been verified.''
+* [[/notes]]
 ==Footnotes==
 <references>
 <ref name=chatgpt1>'''2024-01-01''' ChatGPT 3.5, in response to "How can I add a custom protocol to xdg-open?"</ref>
 </references>

Woozle at 00:25, 2 January 2024

2024-01-02T00:25:36Z

← Older revision		Revision as of 00:25, 2 January 2024
Line 6:		Line 6:
	===custom protocol<ref name=chatgpt1 />===		===custom protocol<ref name=chatgpt1 />===
	'''Q:''' How can I add a custom protocol to xdg-open?		'''Q:''' How can I add a custom protocol to xdg-open?

			''These instructions have not yet been verified.''

	<strong>Create a custom desktop file:</strong>		<strong>Create a custom desktop file:</strong>

Woozle: Created page with "category:software category:open-source ==About== {{fmt/quote|xdg-open is a command-line utility for opening files and URLs using the default applications as specif..."

2024-01-01T17:59:54Z

Created page with "category:software category:open-source ==About== {{fmt/quote|xdg-open is a command-line utility for opening files and URLs using the default applications as specif..."

New page

[[category:software]]
[[category:open-source]]
==About==
{{fmt/quote|[[xdg-open]] is a command-line utility for opening files and URLs using the default applications as specified by the user's desktop environment.}}<ref name=chatgpt1 />
==How To==
===custom protocol<ref name=chatgpt1 />===
'''Q:''' How can I add a custom protocol to xdg-open?

Create a custom desktop file:
* Create a new desktop file for your custom protocol. Desktop files usually have a <code>.desktop</code> extension and are located in the <code>/usr/share/applications/</code> directory or <code>~/.local/share/applications/</code> for user-specific settings.Example (<code>custom-protocol.desktop</code>):
<syntaxhighlight lang=ini>
[Desktop Entry]
Name=Custom Protocol Handler
Exec=/path/to/your/custom-protocol-handler %U
Terminal=false
Type=Application
MimeType=x-scheme-handler/custom-protocol;
</syntaxhighlight>
Customize the <code>Exec</code> line to point to the executable that will handle your custom protocol.
* Update MIME types:
Open the file <code>/usr/share/applications/mimeinfo.cache</code> or <code>~/.local/share/applications/mimeinfo.cache</code> and add the following line:
<blockquote>
x-scheme-handler/custom-protocol=custom-protocol.desktop;
</blockquote>
If the <code>mimeinfo.cache</code> file doesn't exist, you may need to create it.
* Update the MIME database:
Run the following command to update the MIME database:
<syntaxhighlight lang=bash>
update-desktop-database ~/.local/share/applications/
</syntaxhighlight>
If you added the desktop file to the system-wide directory (<code>/usr/share/applications/</code>), you might need to run the command with superuser privileges:
<syntaxhighlight lang=bash>
sudo update-desktop-database /usr/share/applications/
</syntaxhighlight>
* Test your custom protocol:
After completing the above steps, you should be able to use <code>xdg-open</code> with your custom protocol. For example:
<syntaxhighlight lang=bash>
xdg-open custom-protocol://example
</syntaxhighlight>
This should launch the specified handler for your custom protocol.</li></ol>Remember to replace "custom-protocol" with your actual protocol name and update file paths accordingly. Additionally, depending on your desktop environment, there may be slight variations in the steps. If your desktop environment supports <code>xdg-open</code>, these general steps should work.
==Footnotes==
<references>
<ref name=chatgpt1>'''2024-01-01''' ChatGPT 3.5, in response to "How can I add a custom protocol to xdg-open?"</ref>
</references>