XMPP URIs

From XMPP WIKI
Revision as of 15:44, 27 June 2006 by Nyco (talk | contribs) (reorg., struct.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

An XMPP URI is a Uniform Resource Identifier that makes a Jabber ID "clickable" in web browsers and such. Unfortunately, support for XMPP URIs is not (yet!) common in popular software applications, so you need to set it up manually. This page describes how...

Formal Definition

For those interested in a formal definition of XMPP URIs, read draft-saintandre-xmpp-iri and JEP-0147.

Web browsers

Firefox

To XMPP URIs clickable in the Firefox web browser, do this:

  1. Type "about:config" in the url bar
  2. Right-click and select New->String
  3. Enter "network.protocol-handler.app.xmpp" as the preference name
  4. Enter the application to run

Opera

To make XMPP URIs clickable in the Opera web browser, do this:

  1. Open your opera6.ini file
  2. find (or except add) "Trusted Protocols" section
  3. add "xmpp=0,0,<application to run>" to the "Trusted Protocols" section
  4. Note: on older versions it's "xmpp=<application to run>"

Operating systems

Linux

To follow.

Mac OS X

Install the XMPP-IRI helper application linked to from here.

Windows

Paste the following in Notepad and save to a file with an ".reg" extension. Then double-click on it and answer yes to the prompt to import the settings into your registry. Be sure to enter the path to your XMPP-URI capable Jabber client. See the Registering an Application to a URL Protocol article in MSDN for more details.

Windows Registry Editor Version 5.00
[HKEY_CLASSES_ROOT\xmpp]
@="URL:XMPP Protocol"
"EditFlags"=dword:00000002
"URL Protocol"=""
[HKEY_CLASSES_ROOT\xmpp\shell]
[HKEY_CLASSES_ROOT\xmpp\shell\open]
[HKEY_CLASSES_ROOT\xmpp\shell\open\command]
@="<application to execute> %l"

Jabber Clients

List clients supporting XMPP URIs here.

jabber.el

The CVS version of jabber.el supports XMPP URIs as of 2006-06-22. How to set it up is described in the documentation.

Gajim

Using Firefox, set the string for network.protocol-handler.app.xmpp to 'gajim-remote open_chat' in about:config. For Opera add 'xmpp=0,0,gajim-remote open_chat' under [Trusted Protocols] (I had to add Trusted Protocols at the bottom) in opera6.ini.