×
Namespaces

Variants
Actions
(Difference between revisions)

URI Association Schemes List

From Nokia Developer Wiki
Jump to: navigation, search
MSiccDev (Talk | contribs)
(MSiccDev - - Developer-supported schemes)
Dean McCrae (Talk | contribs)
(Dean McCrae - - Developer-supported schemes)
Line 107: Line 107:
 
|BringCast{{Anchor|BringCast}} ||[http://www.windowsphone.com/en-us/store/app/bringcast/e5abef38-d413-e011-9264-00237de2db9e BringCast] || Launch with "bringcast:Play", "bringcast:Pause", "bringcast:SkipNext" or "bringcast:SkipPrevious" to control playback
 
|BringCast{{Anchor|BringCast}} ||[http://www.windowsphone.com/en-us/store/app/bringcast/e5abef38-d413-e011-9264-00237de2db9e BringCast] || Launch with "bringcast:Play", "bringcast:Pause", "bringcast:SkipNext" or "bringcast:SkipPrevious" to control playback
 
|-
 
|-
|weathertogo{{Anchor|Weather To-Go}}||[http://www.windowsphone.com/s?appId=347fea01-a5a6-48ae-afb4-892ecf6a5320 Weather To-Go] || Launch: "weathertogo:"; Select layout: "weathertogo:weather?layout=[0-1]" Settings: "weathertogo:settings"
+
|weathertogo{{Anchor|Weather To-Go}}||[http://www.windowsphone.com/s?appId=347fea01-a5a6-48ae-afb4-892ecf6a5320 Weather To-Go] || Launch: "weathertogo:"; Select layout: "weathertogo:weather?layout=[0-1]"; Settings: "weathertogo:settings"
 
|-
 
|-
 
|settingstogo{{Anchor|Settings To-Go}}||[http://www.windowsphone.com/s?appid=a26c8cc5-f805-46a0-a2a4-e4dc2b648d25 Settings To-Go] || Launch: "settingstogo:"; Open setting: "settingstogo:open?setting[1-9]"; Open flashlight: "settingstogo:open?setting=100"
 
|settingstogo{{Anchor|Settings To-Go}}||[http://www.windowsphone.com/s?appid=a26c8cc5-f805-46a0-a2a4-e4dc2b648d25 Settings To-Go] || Launch: "settingstogo:"; Open setting: "settingstogo:open?setting[1-9]"; Open flashlight: "settingstogo:open?setting=100"

Revision as of 11:09, 10 January 2014

This article provides a catalog of known URI schema and associations.

Tip.pngTip: Add the schemes for your own apps below! If your app URI is used it boosts discovery of your app and results in more downloads and users.

WP Metro Icon File.png
WP Metro Icon WP8.png
Article Metadata
Compatibility
Platform(s):
Windows Phone 8
Article
Created: hamishwillee (06 May 2013)
Last edited: Dean McCrae (10 Jan 2014)

Contents

Introduction

Apps that register to handle (are associated with) a particular URI scheme can be launched from email, NFC tags, and other apps using the URI. Apps can additionally use parameters specified with their URI to open with additional context - for example a calendar app might open in the view for a specific month, a map app might open at a specific location, or a music app might open with song for a particular artist.

At time of writing the URI-to-app associations for the inbuilt apps and operating system have been documented. However there is no central registry for finding out URI associations and parameters for marketplace applications.

This article is intended as a place where developers can both find out URI schemes for other apps, and also link to the documentation for their own app schema.

Marketplace app schemes

Developer-supported schemes

This section is for URI schemes that developers have documented and committed to maintain. Add schemes with official documentation (and your own apps!)

Unofficial schemes

This section is for schemes where the support of the developer has not been verified (for example, a scheme found on the Internet). Note that these are used at your own risk, and may change without notice.

URI App name Description/Link to documentation
AroundMe AroundMe Launches app to search for pictures at a specific locations
super8 Super 8 More than 50 tools in one, and start menu is back.
cooltiles Cool Tiles More than 40 tools in one, and you can design tiles for tools.
metrotube Metrotube Launch Metrotube's YouTube player from within your app
GeoPhoto GeoPhoto Launch to show photos on map
instagraph Instagraph Instagraph (Instagram™ sharing app) custom URI schema
wpcentral WPCentral Windows Phone Central direct URI schema
Pouch Pouch Pouch for Windows Phone direct URI schema
metrotour MetroTour MetroTour URI Protocol
spotify Spotify Linking to Spotify
mehdoh Mehdoh Mehdoh URI schema
pictureslab Pictures Lab Pictures Lab URI schema
gmaps gMaps gMaps URI schema
Geosense Geosense Geo URI schema
ts-keyring Keyring Keyring URI schema - safely store your logins and passwords on your phone - now with NFC.
me-zeitungen Newspapers Newspapers URI schema - read newspapers around the world
sixtag 6tag How to upload a picture on instagram from your app using 6tag
reedability Reedability Reedability URI schema/protocol - unofficial Readability.com client
My 500px My 500px My 500px Free My 500px URI schema View/search/upload photos to 500px
tiwahu-lma Live Music Access Live Music Access direct URI schema/protocol - Browse, search, and stream 100K+ concert recordings from the Live Music Archive (etree) collection.
pcast P | Cast P | Cast direct URI schema/protocol - Normal or Car Mode, start or play immediately a recent or random track.
mix-play-share Mix Play & Share simple launch with no parameters of Mix Play & Share app
car-starter Car Starter Parameterless Launch URI for Windows Phone Dashboard App Car Starter
domainchecker Domain Checker Domain Checker URI schema Note: Available from version 2.0.0
podcastlounge Podcast Lounge Podcast Lounge URI Schema Note: Available from version 1.9.7 onwards
carstand CarStand Launch with parameter "carstand:?mainpage" to open startup page.
tasks Tasks Tasks Uri Schema Note: Available from version 1.81 onwards.
nfctoolkit NFC Toolkit with version 0.9.8 app allows other developers to add their app to the launch app list in profiles - version 0.9.8.1 introduces nfctoolkit:writeapp to enable writing on NFC tags from your app/ plain launch: nfctoolkit:home - documentation: http://msicc.cloudapp.net/?p=3842
ProShot ProShot Documentation
BringCast BringCast Launch with "bringcast:Play", "bringcast:Pause", "bringcast:SkipNext" or "bringcast:SkipPrevious" to control playback
weathertogo Weather To-Go Launch: "weathertogo:"; Select layout: "weathertogo:weather?layout=[0-1]"; Settings: "weathertogo:settings"
settingstogo Settings To-Go Launch: "settingstogo:"; Open setting: "settingstogo:open?setting[1-9]"; Open flashlight: "settingstogo:open?setting=100"
Pocket Squirrel Poki Pouch common uri scheme to use for adding links to Pocket (formerly read-it-later). Learn more: http://metronuggets.com/2013/12/15/sharing-links-to-pocket-formerly-read-it-later/
URI App name Description/Link to documentation
fb Facebook The "fb:" scheme as works on other platform but other details/parameters don't. No official documentation.


Tested URIs:

  • Open Facebook feed: "fb:"
  • Open Facebook to make a post: "fb:post"
  • Open Facebook to make a post with predefined text (text URI encoded): "fb:post?text=text%20to%20Post"
vnd.youtube YouTube http://www.rudyhuyn.com/blog/2013/05/23/how-to-launch-the-official-youtube-app-from-your-app/
fancy Fancy Launch app with "fancy:"
whatsapp WhatsApp Launch app with "whatsapp:"
viber Viber Launch app with "viber:" (Fails: App starts but immediately closes. )
wikipedia Wikipedia Launch app with "wikipedia:"
Battery Battery Launch app with "battery:"

Nokia URI Schemes

URI App name Description/Link to documentation
nokia-music Nokia MixRadio Launch the Nokia MixRadio app. Parameters can be used to specify artists, genre etc to be searched on open. See Nokia MixRadio app-to-app protocol for Windows Phone 8 and official documentation for the API in the Nokia Lumia Developer Library
directions HERE Maps For routing use cases. See HERE Launchers API documentation in the Nokia Lumia Developer Library.
explore-maps HERE Maps For exploring map and map services. See HERE Launchers API documentation in the Nokia Lumia Developer Library.
guidance-drive HERE Drive For drive navigation. See HERE Launchers API documentation in the Nokia Lumia Developer Library.
guidance-walk HERE Drive For walk navigation. See HERE Launchers API documentation in the Nokia Lumia Developer Library.
places HERE Maps For showing places. See HERE Launchers API documentation in the Nokia Lumia Developer Library.
public-transit HERE Transit For public transit related use cases. See HERE Launchers API documentation in the Nokia Lumia Developer Library.

Official "General" URI schemes

This is for URI schemes that are not necessarily reserved for a particular app, but which are known to be launched by them.

URI App name Description/Link to documentation
ms-drive-to:? HERE Drive + Beta How to request driving or walking directions for Windows Phone 8
ms-walk-to:? HERE Maps How to request driving or walking directions for Windows Phone 8

Reserved URL name schemes

Reserved URL names schemes for the in-built apps and operating system are documented in Reserved file and URI associations for Windows Phone 8#Reserved URI scheme names and URI schemes for launching built-in apps for Windows Phone 8 on the Dev Center. Note that when a reserved URI is launched only the built-in app or handler will launch. Any attempt to register an app with one of the following URI scheme names is ignored.

The information is reproduced below for completeness (but has been "collapsed"). We recommend you check the above links.

Reserved for built-in apps

URI Description
bing -
callto -
dtmf -
http:[URL] Launches web browser and navigates to specified URL
https:[URL] Launches web browser and navigates to specified URL
mailto:[email address] - Launches the email app and creates a new message with the specified email address on the To line. Note that the email is not sent until the user taps send.
office -
maps -
onenote -
tel -
wallet -
xbls -
zune Launches Windows Phone Store - parameters documented here
ms-excel -
ms-powerpoint -
ms-word -
ms-settings-accounts Launches Account Settings app.
ms-settings-airplanemode Launches Airplane Mode Settings app.
ms-settings-bluetooth Launches Bluetooth Settings app.
ms-settings-cellular Launches Cellular Settings app.
ms-settings-emailandaccounts Launches Email and Accounts Settings app.
ms-settings-location Launches Location Settings app.
ms-settings-lock Launches Lock Settings app.
ms-settings-power Launches the Battery Saver settings app.
ms-settings-screenrotation Launches the Screen Rotation settings app.
ms-settings-wifi Launches Wifi Settings app.

Reserved for the operating system

Custom URI Description
Jscript -
Javascript -
LDAP -
Res -
rlogin -
StickyNotes -
telnet -
tn3270 -
Vbscript -
windowsmediacenterapp -
windowsmediacenterssl -
windowsmediacenterweb -
File -
Iehistory -
Ierss -
WMP11.AssocProtocol.MMS -
Explorer.AssocActionId.BurnSelection -
Explorer.AssocActionId.CloseSession -
Explorer.AssocActionId.EraseDisc -
Explorer.AssocActionId.ZipSelection -
Explorer.AssocProtocol.search-ms -
Explorer.BurnSelection -
Explorer.CloseSession -
Explorer.EraseDisc -
Explorer.ZipSelection -
2620 page views in the last 30 days.