From d7412fd0e70acb37f7fcd0c2858bcb6e4115dc9d Mon Sep 17 00:00:00 2001 From: Jason Herskowitz Date: Tue, 1 Dec 2015 16:02:15 -0500 Subject: [PATCH] Updated Tomahawk Links (markdown) --- Tomahawk-Links.md | 227 ++++++++++++++++++++++++++++------------------ 1 file changed, 141 insertions(+), 86 deletions(-) diff --git a/Tomahawk-Links.md b/Tomahawk-Links.md index aca6c59..8f7e5d7 100644 --- a/Tomahawk-Links.md +++ b/Tomahawk-Links.md @@ -1,116 +1,171 @@ -Playlist -Import Playlist -tomahawk://playlist/import/?xspf=&title= [LEGACY] -tomahawk://import/playlist?xspf=&title= -http://toma.hk/import/playlist?xspf=&title= -Load/Play Playlist -tomahawk://open/playlist/?xspf= +# Playlist +## Import Playlist + + tomahawk://playlist/import/?xspf=&title= [LEGACY] + tomahawk://import/playlist?xspf=&title= + http://toma.hk/import/playlist?xspf=&title= + +## Load/Play Playlist + + tomahawk://open/playlist/?xspf= + +## New Playlist + + tomahawk://playlist/new/?title=<> + +## Generate XSPF + + http://toma.hk/playlistgen.php?title={PLAYLIST_TITLE}&artists[]={ARTIST_ONE}&titles[]={TITLE_ONE}&artists[]={ARTIST_TWO}&titles[]={TITLE_TWO} + +## Add Track to Playlist - NOT YET IMPLEMENTED + + tomahawk://playlist/add/track/?playlistid=<>&artist=&title= -New Playlist -tomahawk://playlist/new/?title=<> -Generate XSPF -http://toma.hk/playlistgen.php?title={PLAYLIST_TITLE}&artists[]={ARTIST_ONE}&titles[]={TITLE_ONE}&artists[]={ARTIST_TWO}&titles[]={TITLE_TWO} -Add Track to Playlist - NOT YET IMPLEMENTED -tomahawk://playlist/add/track/?playlistid=<>&artist=&title= how to add multiple tracks to a playlist with a single URL? how to get playlist ID? -Library -Add local tracks to library - NOT YET IMPLEMENTED -tomahawk://add/collection/track/?file= -Add hosted tracks to library - NOT YET IMPLEMENTED -tomahawk://add/collection/track/?url=&url=... + +# Library +## Add local tracks to library - NOT YET IMPLEMENTED + + tomahawk://add/collection/track/?file= + +## Add hosted tracks to library - NOT YET IMPLEMENTED + + tomahawk://add/collection/track/?url=&url=... + Would be nice to handle both "file" and "url" in a single URL - NOT YET IMPLEMENTED -tomahawk://add/collection/track/?file=&url=... -Artist and Album pages + + tomahawk://add/collection/track/?file=&url=... + +# Artist and Album pages You can direct tomahawk to automatically load an artist or album page by using the following links: -tomahawk://view/artist?name= -tomahawk://view/album?name=&artist= -Create Station or Automatic Playlist + + tomahawk://view/artist?name= + tomahawk://view/album?name=&artist= + +# Create Station or Automatic Playlist Create a station or automatic playlist based on one or more seeds/parameters. See the echonest playlist page for more information about these parameters and what they mean -Currently only The Echo Nest is supported. Below are the parameters required -type= echonest required -title= the title of the playlist -At least one of 'artist', 'artist_limitto', or 'description' parameter is needed. A single playlist cannot mix artist, artist_limitto, and description elements--one or more of one type only are required. +Currently only The Echo Nest is supported. Below are the parameters required: + + type= echonest required + title= the title of the playlist + At least one of 'artist', 'artist_limitto', or 'description' parameter is needed. A single playlist cannot mix artist, artist_limitto, and description elements--one or more of one type only are required. artist= Tracks similar to the given artist, e.g. "Foo Fighters" artist_limitto= Tracks only by the given artist, e.g. "Foo Fighters" description= Genre or similar description, for example "indie" "rap" "70s slowcore fubar" + The following limit the playlist to "at least": -variety= double from 0 to 1 -tempo= int from 0 to 500 bpm -duration= int from 0 to 3600 secs -loudness= int from -100 to 100 dB -danceability= double from 0 to 1 -energy= double from 0 to 1 -artist_familiarity= double from 0 to 1 -artist_hotttnesss= double from 0 to 1 -song_hotttnesss= double from 0 to 1 -longitude= int from -180 to 180deg -latitude= int from -180 to 180deg -mode= int which is 0 or 1 (major or minor) -key= int from 0 to 11 (see http://developer.echonest.com/docs/v4/playlist.html#static for info) + + variety= double from 0 to 1 + tempo= int from 0 to 500 bpm + duration= int from 0 to 3600 secs + loudness= int from -100 to 100 dB + danceability= double from 0 to 1 + energy= double from 0 to 1 + artist_familiarity= double from 0 to 1 + artist_hotttnesss= double from 0 to 1 + song_hotttnesss= double from 0 to 1 + longitude= int from -180 to 180deg + latitude= int from -180 to 180deg + mode= int which is 0 or 1 (major or minor) + key= int from 0 to 11 (see http://developer.echonest.com/docs/v4/playlist.html#static for info) + It is possible to switch the meaning of the above controls by appending a "_max" to the name. So instead of "tempo", "tempo_max". Note that this is not valid for variety or mode. -tomahawk://station/create/?type=echonest&title=<>&artist=U2&song_hotttnesss=0.657&tempo=120... -tomahawk://autoplaylist/create/?type=echonest&title=<>&artist=U2&song_hotttnesss=0.657&tempo=120... -Search + tomahawk://station/create/?type=echonest&title=<>&artist=U2&song_hotttnesss=0.657&tempo=120... + tomahawk://autoplaylist/create/?type=echonest&title=<>&artist=U2&song_hotttnesss=0.657&tempo=120... + +# Search Search for track, album (all tracks from album) or artist (all tracks from artist) -tomahawk://search/?artist= (may also include &title=<>, & album=<>) -tomahawk://search/?query= -Lookup (by URL) -http://toma.hk/search.php?q=http://open.spotify.com/track/0GuYC53LUD7hS8BVHZiqt0 + tomahawk://search/?artist= (may also include &title=<>, & album=<>) + tomahawk://search/?query= + +# Lookup (by URL) + + http://toma.hk/search.php?q=http://open.spotify.com/track/0GuYC53LUD7hS8BVHZiqt0 A hack that lets you create a Tomahawk embed directly from a Spotify/Deezer/Rdio track link: http://pipes.yahoo.com/jherskowitz/tomahawkembed -Open + +# Open Does "the right thing" given a query or link. If the user is currently playing a song, the song is queued; otherwise the song starts playing. This is a reasonable default link that should be used by most external apps, since it is user-configurable and will most likely do what the user expects. -tomahawk://open/track/?artist=&title=&album=&url= + + tomahawk://open/track/?artist=&title=&album=&url= tries to resolve and play... if can't resolve then need some error messaging/handling + You can also open a playlist, which will cause the contents of the supplied xspf or jspf playlist to be queued and played directly. No permanent playlist will be created. -tomahawk://open/playlist?xspf=http://some.website/test.xspf -tomahawk://open/playlist?jspf=http://some.website/test.jspf -Spotify Urls + + tomahawk://open/playlist?xspf=http://some.website/test.xspf + tomahawk://open/playlist?jspf=http://some.website/test.jspf + +# Spotify Urls All track commands also alternatively accept a spotifyURL= argument with a spotify track url instead of artist/title/album: -tomahawk://open/track/?spotifyURL=http://open.spotify.com/track/0GuYC53LUD7hS8BVHZiqt0 -http://toma.k/open/track/?spotifyURL=http://open.spotify.com/track/0GuYC53LUD7hS8BVHZiqt0 -tomahawk://open/track/?spotifyURI=spotify:track:0GuYC53LUD7hS8BVHZiqt0 -http://toma.hk/open/track/?spotifyURI=spotify:track:0GuYC53LUD7hS8BVHZiqt0 -Rdio Urls + + tomahawk://open/track/?spotifyURL=http://open.spotify.com/track/0GuYC53LUD7hS8BVHZiqt0 + http://toma.k/open/track/?spotifyURL=http://open.spotify.com/track/0GuYC53LUD7hS8BVHZiqt0 + tomahawk://open/track/?spotifyURI=spotify:track:0GuYC53LUD7hS8BVHZiqt0 + http://toma.hk/open/track/?spotifyURI=spotify:track:0GuYC53LUD7hS8BVHZiqt0 + +# Rdio Urls Like spotify, Tomahawk accepts rdio urls wherever a spotify url is accepted. -http://www.rdio.com/#/artist/Jonathan_Coulton/album/Best._Concert._Ever./track/Still_Alive/ -http://rd.io/x/QVqdJzd-rqg -tomahawk://open/track/?rdioURL=http://rd.io/x/QVqdJzd-rqg -http://toma.hk/open/track/?rdioURL=http://rd.io/x/QVqdJzd-rqg -Play + + http://www.rdio.com/#/artist/Jonathan_Coulton/album/Best._Concert._Ever./track/Still_Alive/ + http://rd.io/x/QVqdJzd-rqg + tomahawk://open/track/?rdioURL=http://rd.io/x/QVqdJzd-rqg + http://toma.hk/open/track/?rdioURL=http://rd.io/x/QVqdJzd-rqg + +# Play Start playing an item or list immediately (like clicking play button). It will interrupt what the user is listening to. Be careful with this. -tomahawk://play/track/?artist=&title=&album=&url= + + tomahawk://play/track/?artist=&title=&album=&url= + tries to resolve and play... if can't resolve then need some error messaging/handling -Queue + +# Queue Add local or remote track with metadata to queue. Url is optional, must be a remote url. The track will be resolved. -tomahawk://queue/add/track/?artist=&title=&album=&url= + + tomahawk://queue/add/track/?artist=&title=&album=&url= + Add local or remote track to queue. Url can be a local or remote path -tomahawk://queue/add/track/?url=&url=&... + + tomahawk://queue/add/track/?url=&url=&... + Add list to queue -- PENDING how to get playlist id? does it matter? - NOT YET IMPLEMENTED -tomahawk://queue/add/playlist?id=<> -Toma.hk + + tomahawk://queue/add/playlist?id=<> -Toma.hk Links +#Toma.hk +## Toma.hk Links +### Track Links -Track Links -http://toma.hk/?artist=&title= -Artist Links -http://toma.hk/artist/ -Album Links -http://toma.hk/album// -XSPFs -get the xspf by replacing /p/ through /xspf/ http://toma.hk/xspf/F7i2222M -Toma.hk Embeddable Players + http://toma.hk/?artist=&title= + +### Artist Links + + http://toma.hk/artist/ + +### Album Links + + http://toma.hk/album// + +### XSPFs + + get the xspf by replacing /p/ through /xspf/ http://toma.hk/xspf/F7i2222M + +## Toma.hk Embeddable Players +### Single Track + + -Single Track - You can also add &autoplay=true onto the end of the url to make the player play as soon as loaded -note you can also use a player (hidden in a div) to power playaback in other apps (e.g.: http://syddev.com/thiswasmyjam/) -{{#widget:Iframe |url=http://toma.hk/embed.php?artist=Fridge&title=Long+Singing |width=200 |height=200 |scrolling=no |allowtransparency=true |border=0 }} -Playlist - -Album - \ No newline at end of file +note you can also use a player (hidden in a div) to power playaback in other apps (e.g.: http://syddev.com/thiswasmyjam/): + + {{#widget:Iframe |url=http://toma.hk/embed.php?artist=Fridge&title=Long+Singing |width=200 |height=200 |scrolling=no |allowtransparency=true |border=0 }} + +### Playlist + + + +### Album + + \ No newline at end of file