How do I register a custom protocol with Windows so that when clicking a link in an email or on a web page my application is opened and the parameters from the URL are passed to it?
-
Possible duplicate of how do I create my own URL protocol? (e.g. so://...)– phuclvApr 30, 2017 at 8:07
3 Answers
Go to
Start
then inFind
typeregedit
-> it should open Registry editorClick Right Mouse on
HKEY_CLASSES_ROOT
thenNew
->Key
- In the Key give the lowercase name by which you want urls to be called (in my case it will be
testus://sdfsdfsdf
) then Click Right Mouse ontestus
-> thenNew
->String Value
and addURL Protocol
without value.
- Then add more entries like you did with protocol ( Right Mouse
New
->Key
) and create hierarchy liketestus
->shell
->open
->command
and insidecommand
change(Default)
to the path where.exe
you want to launch is, if you want to pass parameters to your exe then wrap path to exe in""
and add"%1"
to look like:"c:\testing\test.exe" "%1"
- To test if it works go to Internet Explorer (not Chrome or Firefox) and enter
testus:have_you_seen_this_man
this should fire your.exe
(give you some prompts that you want to do this - say Yes) and pass into argstestus://have_you_seen_this_man
.
Here's sample console app to test:
using System;
namespace Testing
{
class Program
{
static void Main(string[] args)
{
if (args!= null && args.Length > 0)
Console.WriteLine(args[0]);
Console.ReadKey();
}
}
}
Hope this saves you some time.
-
3
-
-
@MatasVaitkevicius can I specify "working directory for the application to run from" in registry(within custom URL protocol entry). Ex. for triggering a Batch file if I create a custom Url registry entry, the batch file runs from system32 when launched from browser irrespective of the location of the batch file, whereas if I run the batch file by double clicking it, then the working directory remains its current directory. Jul 30, 2021 at 5:45
-
-
1@MatasVaitkevicius Thanks. yeah found the answer. posting here-may be usefull for someone else. stackoverflow.com/questions/68577785/… Aug 4, 2021 at 12:34
The MSDN link is nice, but the security information there isn't complete. The handler registration should contain "%1", not %1. This is a security measure, because some URL sources incorrectly decode %20 before invoking your custom protocol handler.
PS. You'll get the entire URL, not just the URL parameters. But the URL might be subject to some mistreatment, besides the already mentioned %20->space conversion. It helps to be conservative in your URL syntax design. Don't throw in random // or you'll get into the mess that file:// is.
-
-
6There's no formal mapping of file: URLs to local paths. There's not even a consensus on the use of two or three leading slashes, or the use of forward versus backward slashes when the path refers to a Windows directory.– MSaltersMay 1, 2009 at 12:51
-
Late comment, I know. But is it also possible to somehow access the URL parameters only, without the protocol handler? May 12, 2010 at 11:10
-
2That sounds like a separate question. Please do get your terms straight, though. The protocol handler is the program that receives the URL. "Without the protocol handler" there's nobody to parse the URL and access the URL parameters.– MSaltersMay 14, 2010 at 8:01
-
1@WiiLF: Correct, the registry treats it as just a
REG_SZ
. And internally, Windows doesn't parse command lines so spaces are preserved as well. But any language runtime that parses a command line (such as C'sargv[]
parsing) will break on an unquoted space.– MSaltersDec 20, 2021 at 9:10
There is an npm module for this purpose.
link :https://www.npmjs.com/package/protocol-registry
So to do this in nodejs you just need to run the code below:
First Install it
npm i protocol-registry
Then use the code below to register you entry file.
const path = require('path');
const ProtocolRegistry = require('protocol-registry');
console.log('Registering...');
// Registers the Protocol
ProtocolRegistry.register({
protocol: 'testproto', // sets protocol for your command , testproto://**
command: `node ${path.join(__dirname, './index.js')} $_URL_`, // $_URL_ will the replaces by the url used to initiate it
override: true, // Use this with caution as it will destroy all previous Registrations on this protocol
terminal: true, // Use this to run your command inside a terminal
script: false
}).then(async () => {
console.log('Successfully registered');
});
Then suppose someone opens testproto://test then a new terminal will be launched executing :
node yourapp/index.js testproto://test
It also supports all other operating system.