1 import socket
, hmac
, urllib
, urllib2
, pprint
, md5
, uuid
, re
, hashlib
, time
, random
, os
, pickle
4 THUMB_URL
= 'http://beta.grooveshark.com/static/amazonart/'
5 THUMB_URL_DEFAULT
= 'http://grooveshark.com/webincludes/logo/Grooveshark_Logo_No-Text.png'
10 # GrooveSong constants
11 DOMAIN
= "grooveshark.com"
12 HOME_URL
= "http://listen." + DOMAIN
13 TOKEN_URL
= "http://cowbell." + DOMAIN
+ "/more.php"
14 API_URL
= "http://cowbell." + DOMAIN
+ "/more.php"
15 SERVICE_URL
= "http://cowbell." + DOMAIN
+ "/service.php"
17 CLIENT_NAME
= "gslite" #htmlshark #jsqueue
18 CLIENT_VERSION
= "20101012.37" #"20100831.25"
19 HEADERS
= {"Content-Type": "application/json",
20 "User-Agent": "Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US; rv:1.9.2.12) Gecko/20101026 Firefox/3.6.12 (.NET CLR 3.5.30729)",
21 "Referer": "http://listen.grooveshark.com/main.swf?cowbell=fe87233106a6cef919a1294fb2c3c05f"}
23 RE_SESSION
= re
.compile('"sessionID":"\s*?([A-z0-9]+)"') #re.compile('sessionID:\s*?\'([A-z0-9]+)\',')
24 RANDOM_CHARS
= "1234567890abcdef"
29 def __init__(self
, cacheDir
):
32 self
.simplejson
= simplejson
34 self
.cacheDir
= cacheDir
35 self
._lastTokenTime
= 0
36 self
.uuid
= self
._getUUID
()
37 self
.sessionID
= self
._getSession
(HOME_URL
)
38 if self
.sessionID
== None:
39 raise StandardError("Cannot get session id")
41 # The actual call to the API
42 def _callRemote(self
, method
, params
, type="default"):
45 "client": CLIENT_NAME
,
46 "clientRevision": CLIENT_VERSION
,
48 "session": self
.sessionID
},
49 "country": {"IPR":"1021", "ID":"223", "CC1":"0", "CC2":"0", "CC3":"0", "CC4":"2147483648"},
54 token
= self
._getMethodToken
(method
)
56 raise StandardError("Cannot get token")
58 postData
["header"]["token"] = token
60 url
= SERVICE_URL
+ "?" + method
62 url
= API_URL
+ "?" + method
64 postData
= self
.simplejson
.dumps(postData
)
65 print "GrooveSong URL: " + url
66 request
= urllib2
.Request(url
, postData
, HEADERS
)
68 response
= urllib2
.urlopen(request
).read()
70 response
= self
.simplejson
.loads(response
)
71 print "GrooveSong Response..."
72 pprint
.pprint(response
)
74 raise StandardError("API error: " + response
)
80 raise StandardError("API error: " + response
["fault"]["message"])
82 # Generate a random uuid
84 return str(uuid
.uuid4())
86 # Make a token ready for a request header
87 def _getMethodToken(self
, method
):
88 if (time
.time() - self
._lastTokenTime
) >= 1000:
89 self
._token
= self
._getCommunicationToken
()
90 if self
._token
== None:
92 self
._lastTokenTime
= time
.time()
95 while 6 > len(randomChars
):
96 randomChars
= randomChars
+ random
.choice(RANDOM_CHARS
)
98 token
= hashlib
.sha1(method
+ ":" + self
._token
+ ":quitStealinMahShit:" + randomChars
).hexdigest()
99 return randomChars
+ token
101 # Generate a communication token
102 def _getCommunicationToken(self
):
103 params
= {"secretKey": self
._getSecretKey
(self
.sessionID
)}
106 "client": CLIENT_NAME
,
107 "clientRevision": CLIENT_VERSION
,
109 "session": self
.sessionID
},
110 "country": {"IPR":"1021", "ID":"223", "CC1":"0", "CC2":"0", "CC3":"0", "CC4":"2147483648"},
112 "parameters": params
,
113 "method": "getCommunicationToken"}
115 postData
= self
.simplejson
.dumps(postData
)
116 request
= urllib2
.Request(TOKEN_URL
, postData
, HEADERS
)
117 response
= urllib2
.urlopen(request
).read()
119 response
= self
.simplejson
.loads(response
)
121 raise StandardError("API error: " + response
)
125 return response
["result"]
129 # Generate a secret key from a sessionID
130 def _getSecretKey(self
, sessionID
):
131 return hashlib
.md5(sessionID
).hexdigest()
133 # Get a session id from some HTML
134 def _getSession(self
, html
):
135 html
= urllib2
.urlopen(HOME_URL
).read()
136 session
= RE_SESSION
.search(html
)
138 return session
.group(1)
142 # Gets a stream key and host to get song content
143 def _getStreamDetails(self
, songID
):
148 "country": {"IPR":"1021","ID":"223", "CC1":"0", "CC2":"0", "CC3":"0", "CC4":"2147483648"}
150 response
= self
._callRemote
("getStreamKeyFromSongIDEx", params
)
151 self
._lastStreamKey
= response
["result"]["streamKey"]
152 self
._lastStreamServer
= response
["result"]["ip"]
153 self
._lastStreamServerID
= response
["result"]["streamServerID"]
155 # Tells Grooveshark you have downloaded a song
156 def _markSongDownloaded(self
, songID
):
158 "streamKey": self
._lastStreamKey
,
159 "streamServerID": self
._lastStreamServerID
,
161 self
._callRemote
("markSongDownloaded", params
)
163 # Download a song to a temporary file
164 def getSongURL(self
, songID
):
165 filename
= os
.path
.join(self
.cacheDir
, songID
+ '.mp3')
166 if os
.path
.isfile(filename
) == False:
167 self
._getStreamDetails
(songID
)
168 postData
= {"streamKey": self
._lastStreamKey
}
169 postData
= urllib
.urlencode(postData
)
170 urllib
.FancyURLopener().retrieve( "http://" + self
._lastStreamServer
+ "/stream.php", filename
, data
=postData
)
171 self
._markSongDownloaded
(songID
)
180 host
= 'api.grooveshark.com'
183 def __init__(self
, cacheDir
):
185 self
.simplejson
= simplejson
186 socket
.setdefaulttimeout(40)
187 self
.cacheDir
= cacheDir
188 self
.sessionID
= self
._getSavedSessionID
()
189 if self
.sessionID
== '':
190 self
.sessionID
= self
._getSessionID
()
191 if self
.sessionID
== '':
192 raise StandardError('Failed to get session id')
194 self
._setSavedSessionID
()
196 def _keySort(self
, d
):
197 return [(k
,d
[k
]) for k
in sorted(d
.keys())]
200 def _createMessageSig(self
, method
, params
, secret
):
201 args
= self
._keySort
(params
);
208 h
= hmac
.new(secret
, data
)
211 # The actual call to the API
212 def _callRemote(self
, method
, params
= {}):
213 url
= 'http://%s/ws/2.1/?method=%s&%s&wsKey=wordpress&sig=%s&format=json' % (self
.host
, method
, urllib
.urlencode(params
), self
._createMessageSig
(method
, params
, 'd6c59291620c6eaa5bf94da08fae0ecc'))
215 req
= urllib2
.Request(url
)
216 response
= urllib2
.urlopen(req
)
217 result
= response
.read()
218 pprint
.pprint(result
)
221 result
= self
.simplejson
.loads(result
)
227 def _getSessionID(self
):
229 result
= self
._callRemote
('startSession', params
)
230 return result
['result']['sessionID']
232 def _getSavedSessionID(self
):
234 path
= os
.path
.join(self
.cacheDir
, 'session', 'session.txt')
237 sessionID
= pickle
.load(f
)
245 def _setSavedSessionID(self
):
247 dir = os
.path
.join(self
.cacheDir
, 'session')
248 # Create the 'data' directory if it doesn't exist.
249 if not os
.path
.exists(dir):
251 path
= os
.path
.join(dir, 'session.txt')
253 pickle
.dump(self
.sessionID
, f
, protocol
=pickle
.HIGHEST_PROTOCOL
)
256 print "An error occured during save session"
259 # Make user authentication token
260 def _getUserToken(self
, username
, password
):
261 return md5
.new(username
.lower() + md5
.new(password
).hexdigest()).hexdigest()
263 # Authenticates the user for current API session
264 def _authenticateUser(self
, username
, token
):
265 params
= {'sessionID': self
.sessionID
, 'username': username
, 'token': token
}
266 result
= self
._callRemote
('authenticateUser', params
)
267 return result
['result']['UserID']
270 def login(self
, username
, password
):
271 token
= self
._getUserToken
(username
, password
)
272 self
.userID
= self
._authenticateUser
(username
, token
)
277 self
._callRemote
('logout', {'sessionID' : self
.sessionID
})
284 def getArtistSearchResults(self
, query
, limit
=ARTIST_LIMIT
):
285 result
= self
._callRemote
('getArtistSearchResults', {'query' : query
,'limit' : limit
})
286 if 'result' in result
:
287 return self
._parseArtists
(result
)
292 def getAlbumSearchResults(self
, query
, limit
=ALBUM_LIMIT
):
293 result
= self
._callRemote
('getAlbumSearchResults', {'query' : query
,'limit' : limit
})
294 if 'result' in result
:
295 return self
._parseAlbums
(result
)
300 def getSongSearchResults(self
, query
, limit
=SONG_LIMIT
):
301 result
= self
._callRemote
('getSongSearchResultsEx', {'query' : query
, 'limit' : limit
})
302 if 'result' in result
:
303 return self
._parseSongs
(result
)
307 # Gets the popular songs
308 def getPopularSongsToday(self
, limit
=SONG_LIMIT
):
309 result
= self
._callRemote
('getPopularSongsToday', {'limit' : limit
})
310 if 'result' in result
:
311 return self
._parseSongs
(result
)
315 # Gets the favorite songs of the logged-in user
316 def getUserFavoriteSongs(self
):
317 if (self
.userID
== 0):
319 result
= self
._callRemote
('getUserFavoriteSongs', {'sessionID' : self
.sessionID
})
320 if 'result' in result
:
321 return self
._parseSongs
(result
)
325 # Get the url to link to a song on Grooveshark
326 def getSongURLFromSongID(self
, songID
):
327 song
= GrooveSong(self
.cacheDir
)
328 return song
.getSongURL(songID
)
330 # Get the url to link to a song on Grooveshark
331 def getSongInfo(self
, songID
):
332 result
= self
._callRemote
('getSongInfoEx', {'songID' : songID
})
333 if 'result' in result
and 'SongID' in result
['result']:
334 info
= result
['result']
335 if 'CoverArtFilename' in info
and info
['CoverArtFilename'] != None:
336 info
['CoverArtFilename'] = THUMB_URL
+info
['CoverArtFilename'].encode('ascii', 'ignore')
338 info
['CoverArtFilename'] = THUMB_URL_DEFAULT
343 # Gets the playlists of the logged-in user
344 def getUserPlaylists(self
):
345 if (self
.userID
== 0):
347 result
= self
._callRemote
('getUserPlaylists', {'sessionID' : self
.sessionID
})
348 if 'result' in result
:
349 return self
._parsePlaylists
(result
)
353 # Creates a playlist with songs
354 def createPlaylist(self
, name
, songIDs
):
355 result
= self
._callRemote
('createPlaylist', {'name' : name
, 'songIDs' : songIDs
, 'sessionID' : self
.sessionID
})
356 if 'result' in result
and result
['result']['success'] == 'true':
357 return result
['result']['PlaylistID']
358 elif 'errors' in result
:
361 # Sets the songs for a playlist
362 def setPlaylistSongs(self
, playlistID
, songIDs
):
363 result
= self
._callRemote
('setPlaylistSongs', {'playlistID' : playlistID
, 'songIDs' : songIDs
, 'sessionID' : self
.sessionID
})
364 if 'result' in result
and result
['result']['success'] == 'true':
369 # Gets the songs of a playlist
370 def getPlaylistSongs(self
, playlistID
):
371 result
= self
._callRemote
('getPlaylistSongs', {'playlistID' : playlistID
});
372 if 'result' in result
:
373 return self
._parseSongs
(result
)
378 def _parseSongs(self
, items
):
379 if 'result' in items
:
382 if 'songs' in items
['result']:
383 l
= len(items
['result']['songs'])
385 elif 'song' in items
['result']:
389 l
= len(items
['result'])
393 s
= items
['result'][index
][i
]
394 elif index
== 'song':
395 s
= items
['result'][index
]
397 s
= items
['result'][i
]
398 if 'CoverArtFilename' not in s
:
399 info
= self
.getSongInfo(s
['SongID'])
400 coverart
= info
['CoverArtFilename']
401 elif s
['CoverArtFilename'] != None:
402 coverart
= THUMB_URL
+s
['CoverArtFilename'].encode('ascii', 'ignore')
404 coverart
= THUMB_URL_DEFAULT
405 list.append([s
['SongName'].encode('ascii', 'ignore'),\
407 s
['AlbumName'].encode('ascii', 'ignore'),\
409 s
['ArtistName'].encode('ascii', 'ignore'),\
417 # Extract artist data
418 def _parseArtists(self
, items
):
419 if 'result' in items
:
422 artists
= items
['result']['artists']
423 while(i
< len(artists
)):
425 list.append([s
['ArtistName'].encode('ascii', 'ignore'),\
433 def _parseAlbums(self
, items
):
434 if 'result' in items
:
437 albums
= items
['result']['albums']
438 while(i
< len(albums
)):
440 if 'CoverArtFilename' in s
and s
['CoverArtFilename'] != None:
441 coverart
= THUMB_URL
+s
['CoverArtFilename'].encode('ascii', 'ignore')
443 coverart
= THUMB_URL_DEFAULT
444 list.append([s
['ArtistName'].encode('ascii', 'ignore'),\
446 s
['AlbumName'].encode('ascii', 'ignore'),\
454 def _parsePlaylists(self
, items
):
455 if 'result' in items
:
458 playlists
= items
['result']
459 while(i
< len(playlists
)):
461 list.append([s
['PlaylistID'],\
462 s
['Name'].encode('ascii', 'ignore')])
473 #groovesharkApi = GrooveAPI('/tmp')
474 #res = groovesharkApi.login('stephendenham', '*******')
475 #res = groovesharkApi.getSongSearchResults('jimmy jazz', 3)
476 #res = groovesharkApi.getPopularSongsToday()
477 #res = groovesharkApi.getSongURLFromSongID('27425375')
478 #res = groovesharkApi.getAlbumSearchResults('london calling', 3)
479 #res = groovesharkApi.getArtistSearchResults('the clash', 3)
480 #res = groovesharkApi.getUserFavoriteSongs()
481 #res = groovesharkApi.getUserPlaylists()
482 #res = groovesharkApi.getSongInfo('27425375')
483 #res = groovesharkApi.getPlaylistSongs(40902662)