What are URL Schemes?
URL Schemes are custom URLs which an app responds to. Typically, you use "myapp://" instead of "http://" and provide a specific path like "action?param1=value1¶m2=value2"
Ecoute's URL scheme is ecoute://
Ecoute can execute 3 actions :
For each of these actions, there is a required parameter named "terms"
Let's start with a simple action. Let's search for the track "Enter sandman" by "Metallica" :
ecoute://search?terms=Metallica%20Enter%20Sandman (Please notice that "%20" replaces the space character)
As you can see, there is no need to separate artist/album/track arguments. Just provide any terms you want.
Now that you understand how the search action works, you can also use the play and shuffle actions too. They just work as the search action does, except that they do not show you the results, but automatically plays them.
Optional parameters for Play & Shuffle
These actions also support optional parameters :
- shuffle : 0/1 OR off/songs/on/albums
- repeat : 0/1/2 OR off/all/one
Let's use them :
This one plays all songs matching metallica, shuffles them by albums and repeats all
We recommend using Launch Center Pro
Launch Center Pro manages custom schemes for you, and adds awesome shortcuts to different actions. We suggest you to take a look at it right now!