🚀 App Protocols and Deeplinks

How to use custom protocol links to launch your app built with ToDesktop.

What are App Protocols?

You've probably seen app protocols before. Perhaps you've seen them with iTunes (itmss://) or Spotify (spotify://) or Slack (slack://). App protocols provide an easy way for you to launch your application from inside another application.

One common use-cases is to launch a desktop application from a website.

<a href="spotify://">Open Spotify App</a>

We can also add more information to go to a specific part of a desktop application. We call this a ‘deeplink’.

<a href="spotify://track:1mIBixqmt8vbDNXiKqLTGJ">
Play “Broken Together” by “Mani Obeya” on Spotify
</a>

App Protocols and ToDesktop

Enabling App Protocols

You can enable App Protocols for your app by selecting the “Support App Protocol (deeplink)” option in the “App Options” box. You can then type the App Protocol that you wish to use. In the example below, we have chosen interplay:// as the app protocol.

Using App Protocols

Let's use the app protocol of interplay:// in our examples below.

Simple App Protocol

interplay://https://app.interplay.io

This will open Interplay app at the default location. If the app is already opened then the window will gain focus.

interplay://foo/barhttps://app.interplay.io/foo/bar

Deeplinks allow you to specify a path to navigate to in your app. This will open Interplay app at the foo/bar path.

Example

So, if you wanted to link from a website to a deeplink within Interplay app then you could do something like this:

<a href="interplay://foo/bar">Open FooBar on Interplay app</a>

Video