Namespaces

Variants
Actions

Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries over the next few weeks. Thanks for all your past and future contributions.

Revision as of 15:51, 11 June 2014 by hermitdave (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

URI Association Schemes List

From Wiki
Jump to: navigation, search

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: hermitdave (11 Jun 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!)

URI App name Description/Link to documentation
AroundMe AroundMe Launches app to search for pictures at a specific locations
melodia melodia Alerts for Windows Phone 8.1, each app will need one.
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
pocketbrain pocketBRAIN A beautiful and light-weight note-taking app.

App launch: pocketbrain:
Create a new note: pocketbrain:newNote?title=...&text=...
Create a note with image attachement: pocketbrain:newNote?title={...}&text={...}&mediaLibIndex={index}

noteplus Note+ Launches MainPage. A simple yet delightful note-taking app.
stopwatchplus Stopwatch+ Launches MainPage. A simple yet delightful time-keeping app.
counterplus Counter+ Launches MainPage. A simple yet delightful tally counter app.
Foundbite Foundbite Foundbite URI Scheme
GeoPhoto GeoPhoto Launch to show photos on map
photoinfo Photo-Info A beautiful photo-hub extension app for image information

App launch: photoinfo:
Show image information: photoinfo:show?mediaLibIndex={index}

instagraph Instagraph Instagraph (Instagram™ sharing app) custom URI schema
wpcentral WPCentral Windows Phone Central direct URI schema
metrotour MetroTour MetroTour URI Protocol
spotify Spotify Linking to Spotify
mehdoh Mehdoh Mehdoh URI schema
flitsnav Flitsservice FlitsNav Launches Flitsservice FlitsNav (no parameters available yet).
pictureslab Pictures Lab Pictures Lab URI schema
gmaps gMaps gMaps URI schema
Geosense Geosense Geo URI schema
ts-keyring Keyring Keyring URI schema - your private password safe on your phone, doesn't need a data connection so no one can spoof - 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. Also supports the common wp-podcast URI scheme for play/pause/skip next/skip previous control, available on NuGet and GitHub.
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.net/?p=3842
ProShot ProShot Documentation
BringCast BringCast Supports the common wp-podcast URI scheme for play/pause/skip next/skip previous control, available on NuGet and GitHub.
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"
I'm Here I'm Here Launch app "imhere:", launch and share options "imhere://share/text", "imhere://share/email", "imhere://share/social", "imhere://share/whatsapp"
enlesssoft-battery Battery Documentation
enlesssoft-flashlight Flashlight Documentation
enlesssoft-birthdays Birthdays Documentation
enlesssoft-history History Documentation
enlesssoft-holidays Holidays Documentation
conference-calleague Conference Calleague Documentation Parse meeting invites for conference call dial-in information and initiate dialing
GPS monitor GPS monitor Documentation Show webcam retrieved through webcams-travel. Through the schema uri, you can open the apps, and see webcam nearby a point.
mxm musiXmatch lyrics player Documentation
Cineworld cineworld cinemas app The following Uri schemas are supported.

cineworld:film?12345
cineworld:cinema?22
cineworld?search?xmen
the film requires use of cineword EDI

Community Schemes

This section is for URI schemes that are used by more then one app, usually apps that share some similar functionality. These schemes should be well documented.

URI Apps Description/Link to documentation
Pocket Squirrel Poki Pouch OwlReader Pock8 Common uri scheme to use for adding links to Pocket. Learn more: http://metronuggets.com/2013/12/15/sharing-links-to-pocket-formerly-read-it-later/

Package: https://github.com/ScottIsAFool/PocketWP

wp-podcast BringCast

P Cast

The common wp-podcast URI scheme for play/pause/skip next/skip previous control, available on NuGet and GitHub.

Unofficial schemes

This page 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.


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.
nokia-xpress: Nokia Xpress (min v1.5.1.773) This URI allows 3rd party apps to start the Nokia Xpress browser. If the browser is started for the first time, the user is presented with an End User License Agreement (EULA) which the user must accept, after which the app loads its home page.
nokia-xpress:Pageload?Url= Nokia Xpress (min v1.5.1.773) The "page load" protocol implemented on top of the Nokia Xpress URI allows 3rd party applications to start the browser in order to load the specified URL. The URL of the page to be loaded may include the http:// specifier or omit it. You can also specify https:// if needed.

If the provided URL does not appear to be valid (contains invalid characters, out of IP range(sorry, no IPV6 yet), no domain suffix, etc.), Nokia Xpress will perform a search based on user settings.

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 -
This page was last modified on 11 June 2014, at 15:51.
1612 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×