cl-audioscrobbler
Description
cl-audioscrobbler is a Common Lisp wrapper for the web service Audioscrobbler/Last.fm.
It is developed on Debian GNU/Linux . and licensed under a license Lisp Lesser GNU Public License. It has been tested under SBCL.
Installation
cl-audioscrobbler could be install like this :
- Load libraries :
CL-USER> (require 'asdf) CL-USER> (require 'asdf-install)
- Install cl-audioscrobbler :
CL-USER> (asdf-install:install :cl-audioscrobbler)
- Usage :
- Make a friendly output :
CL-USER> (setf cl-audioscrobbler:*print-audioscrobbler* t) T
- Get informations about an album :
CL-USER> (cl-audioscrobbler:get-album-informations "Noir+Desir" "Tostaky") Artist: Noir+Desir Album: Tostaky Release: 7 Dec 1992, 12:00am Large: http://images.amazon.com/images/P/B0000084EP.01._SCMZZZZZZZ_.jpg Medium: http://images.amazon.com/images/P/B0000084EP.01._SCMZZZZZZZ_.jpg Small: http://images.amazon.com/images/P/B0000084EP.01._SCMZZZZZZZ_.jpg Reach: 6987 Tracks: Name: Here It Comes Slowly Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Here+It+Comes+Slowly Reach: 2788 Name: Ici Paris Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Ici+Paris Reach: 3004 Name: Oublié Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Oubli%C3%A9 Reach: 2371 Name: Alice Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Alice Reach: 2518 Name: One Trip, One Noise Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/One+Trip%2C+One+Noise Reach: 1057 Name: Tostaky (le continent) Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Tostaky+%28le+continent%29 Reach: 2220 Name: Marlène Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Marl%C3%A8ne Reach: 2449 Name: Johnny colère Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Johnny+col%C3%A8re Reach: 1767 Name: 7 Minutes Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/7+Minutes Reach: 1724 Name: Sober Song Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Sober+Song Reach: 2287 Name: It Spurts Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/It+Spurts Reach: 2263 Name: Lolita nie en bloc Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Lolita+nie+en+bloc Reach: 2957
- A list of related artists :
CL-USER> (cl-audioscrobbler:get-artist-related "Noir+Desir") ( Artist: Louise Attaque Mbid: 04d25080-32e2-49a2-b638-c9ca4f3e12bd Url: 100 Image: http://static3.last.fm/storable/image/94012/small.jpg Small: - http://www.last.fm/music/Louise+Attaque% Artist: Matmatah Mbid: 276a554b-5be6-43b3-b05d-d1e6c3dadb64 Url: 78.313 Image: http://static3.last.fm/storable/image/10793/small.jpg Small: - http://www.last.fm/music/Matmatah% Artist: Renaud Mbid: de1edf40-2b3d-4ddd-873c-e4f59585ba92 Url: 77.757 Image: http://static3.last.fm/storable/image/170293/small.jpg Small: - http://www.last.fm/music/Renaud% Artist: Mickey 3d Mbid: bac316b8-e971-403d-a5e4-f81fa6a4efbb Url: 75.829 Image: http://static3.last.fm/storable/image/161385/small.jpg Small: - http://www.last.fm/music/Mickey+3d% [...]
- A list of the most popular albums by a given artist :
CL-USER> (cl-audioscrobbler:get-artist-top-albums "Noir+Desir") ( Title: Des visages des figures Mbid: 9ad8394c-94c6-4c39-9381-a9b19e88f5ea Url: http://www.last.fm/music/Noir+D%C3%A9sir/Des+visages+des+figures Reach: 7816% Title: 666.667 Club Mbid: 7806dc5a-188d-41ca-8009-27a233898827 Url: http://www.last.fm/music/Noir+D%C3%A9sir/666.667+Club Reach: 5509% Title: Tostaky Mbid: c7e773a8-b214-4d9f-a593-40ed0a2cebcc Url: http://www.last.fm/music/Noir+D%C3%A9sir/Tostaky Reach: 2942% Title: Du ciment sous les plaines Mbid: 76176fed-543e-4a49-b057-ec3900eb85b3 Url: http://www.last.fm/music/Noir+D%C3%A9sir/Du+ciment+sous+les+plaines Reach: 2848% Title: En Public Mbid: Url: http://www.last.fm/music/Noir+D%C3%A9sir/En+Public Reach: 816% Title: Où veux-tu qu'je r'garde ? Mbid: 00415d09-d5b4-46df-9f5d-674d8b6e9748 Url: http://www.last.fm/music/Noir+D%C3%A9sir/O%C3%B9+veux-tu+qu%27je+r%27garde+%3F Reach: 807% [...]
- A list of the most popular tracks by a given artist :
CL-USER> (cl-audioscrobbler:get-artist-top-tracks "Noir+Desir") ( Title:Le vent nous portera MBid: Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Le+vent+nous+portera Reach: 6535% Title:Un jour en France MBid: Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Un+jour+en+France Reach: 3139% Title:Des armes MBid: Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Des+armes Reach: 2856% Title:Lost MBid: Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Lost Reach: 2749% Title:Comme elle vient MBid: Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Comme+elle+vient Reach: 2339% Title:Le Grand Incendie MBid: Url: http://www.last.fm/music/Noir+D%C3%A9sir/_/Le+Grand+Incendie Reach: 2311% [...]
- A list profiles of the biggest artist's fans :
CL-USER> (cl-audioscrobbler:get-artist-top-fans "Noir+Desir") ( Name: http://www.last.fm/user/Stalowka/ Url: http://www.last.fm/user/Stalowka/ Image: http://panther1.last.fm/avatar/118e7b8191786ed6faeeff34613f471c.jpg Weight: 230704 Name: http://www.last.fm/user/marc636/ Url: http://www.last.fm/user/marc636/ Image: http://panther1.last.fm/depth/catalogue/noimage/nouser_140px.jpg Weight: 158760 Name: http://www.last.fm/user/liviua/ Url: http://www.last.fm/user/liviua/ Image: http://panther1.last.fm/depth/catalogue/noimage/nouser_140px.jpg Weight: 125059 Name: http://www.last.fm/user/asyd/ Url: http://www.last.fm/user/asyd/ Image: http://panther1.last.fm/avatar/99a5c56fd7e9bfd34d8a34853cb41b6e.jpg Weight: 117193 [..]
- A list of the most popular tags applied to a given artist :
CL-USER> (cl-audioscrobbler:get-artist-top-tags "Noir+Desir") ( Name: rock Url: rock Count: 100 Name: french Url: french Count: 87 Name: alternative Url: alternative Count: 54 Name: indie Url: indie Count: 22 Name: alternative rock Url: alternative rock Count: 21 [..]
- Get a user profile from username :
CL-USER> (cl-audioscrobbler:get-profile "lam_") Name:lam_ Gender:m Age: 31 Country: France Registered: Jul 3, 2006 Id: 4147534 Url: http://www.last.fm/user/lam_/
- A list of all albums tagged the most times with this tag :
CL-USER> (cl-audioscrobbler:get-top-albums "Rock") (Album: Californication Count: 83 Mbid: NIL Url: http://www.last.fm/music/Red+Hot+Chili+Peppers/Californication Large: http://cdn.last.fm/coverart/300x300/4791.jpg Medium: http://cdn.last.fm/coverart/130x130/4791.jpg Small: http://panther1.last.fm/coverart/50x50/4791.jpg Album: Elephant Count: 83 Mbid: NIL Url: http://www.last.fm/music/The+White+Stripes/Elephant Large: http://images-eu.amazon.com/images/P/B00007KN36.02.LZZZZZZZ.jpg Medium: http://images-eu.amazon.com/images/P/B00007KN36.02.MZZZZZZZ.jpg Small: http://images-eu.amazon.com/images/P/B00007KN36.02.THUMBZZZ.jpg Album: Fallen Count: 83 Mbid: NIL Url: http://www.last.fm/music/Evanescence/Fallen Large: http://images.amazon.com/images/P/B00008US8R.01._SCMZZZZZZZ_.jpg Medium: http://images.amazon.com/images/P/B00008US8R.01._SCMZZZZZZZ_.jpg Small: http://images.amazon.com/images/P/B00008US8R.01._SCMZZZZZZZ_.jpg Album: OK Computer Count: 80 Mbid: NIL Url: http://www.last.fm/music/Radiohead/OK+Computer Large: http://images.amazon.com/images/P/B000007UTN.01._SCMZZZZZZZ_.jpg Medium: http://images.amazon.com/images/P/B000007UTN.01._SCMZZZZZZZ_.jpg Small: http://images.amazon.com/images/P/B000007UTN.01._SCMZZZZZZZ_.jpg [..]
- A list of the artists tagged the most times with this tag :
CL-USER> (cl-audioscrobbler:get-top-artists "Rock") (Artist: Red Hot Chili Peppers Count: 5931 Mbid: NIL Url: http://www.last.fm/music/Red+Hot+Chili+Peppers Thumbnail: http://static3.last.fm/storable/image/191508/small.jpg Image: http://panther1.last.fm/proposedimages/sidebar/6/1274/577120.jpg Artist: Foo Fighters Count: 3967 Mbid: NIL Url: http://www.last.fm/music/Foo+Fighters Thumbnail: http://static3.last.fm/storable/image/98/small.jpg Image: http://panther1.last.fm/proposedimages/sidebar/6/1000062/458.jpg Artist: Radiohead Count: 3824 Mbid: NIL Url: http://www.last.fm/music/Radiohead Thumbnail: http://static3.last.fm/storable/image/190095/small.jpg Image: http://panther1.last.fm/proposedimages/sidebar/6/979/542058.jpg [...]
- A list of the most used tags overall :
CL-USER> (cl-audioscrobbler:get-top-tags) ( Name: rock Url: http://www.last.fm/tag/rock Count: 878660 Name: indie Url: http://www.last.fm/tag/indie Count: 494827 Name: seen live Url: http://www.last.fm/tag/seen%20live Count: 486766 Name: alternative Url: http://www.last.fm/tag/alternative Count: 459958 Name: electronic Url: http://www.last.fm/tag/electronic Count: 352409 Name: metal Url: http://www.last.fm/tag/metal Count: 315552 [...]
- A list tracks tagged the most times with this tag :
CL-USER> (cl-audioscrobbler:get-top-tracks "Rock") (Track: Once Upon a Time Count: 1076 Url: http://www.last.fm/music/Frank+Zappa/_/Once+Upon+a+Time Thumbnail: http://ec1.images-amazon.com/images/P/B0000009TN.01._SCMZZZZZZZ_.jpg Image: http://ec1.images-amazon.com/images/P/B0000009TN.01._SCMZZZZZZZ_.jpg Track: The Florida Airport Tape Count: 656 Url: http://www.last.fm/music/Frank+Zappa/_/The+Florida+Airport+Tape Thumbnail: http://static3.last.fm/storable/image/190360/small.jpg Image: http://panther1.last.fm/proposedimages/sidebar/6/4250/551053.jpg Track: Wonderwall Count: 365 Url: http://www.last.fm/music/Oasis/_/Wonderwall Thumbnail: http://images.amazon.com/images/P/B000002BBY.01.MZZZZZZZ.jpg Image: http://images.amazon.com/images/P/B000002BBY.01.MZZZZZZZ.jpg Track: Dani California Count: 351 Url: http://www.last.fm/music/Red+Hot+Chili+Peppers/_/Dani+California Thumbnail: http://static3.last.fm/storable/image/195250/small.jpg Image: http://panther1.last.fm/proposedimages/sidebar/6/1274/561624.jpg
- A list of profiles who've listened to a given TRACK the most :
CL-USER> (cl-audioscrobbler:get-track-fans "Noir+Desir" "Lost") ( Name: Stalowka Url: http://www.last.fm/user/Stalowka/ Image: http://panther1.last.fm/avatar/118e7b8191786ed6faeeff34613f471c.jpg Weight: 3080 Name: Chaniuk Url: http://www.last.fm/user/Chaniuk/ Image: http://panther1.last.fm/avatar/c154e59838d9242cc9344d974fb1a681.jpg Weight: 1642 Name: vomitive Url: http://www.last.fm/user/vomitive/ Image: http://panther1.last.fm/avatar/458ee491fa8c9e69539dcab99575c97d.jpg Weight: 1505 Name: Lochkaese Url: http://www.last.fm/user/Lochkaese/ Image: http://panther1.last.fm/avatar/a4db9f4d17535137821b2601d46a47ea.png Weight: 685 [...]
- A list of the most popular tags applied to a given track :
CL-USER> (cl-audioscrobbler:get-track-tags "Noir+Desir" "Lost") ( Name: rock Url: http://www.last.fm/tag/rock Count: 100 Name: french Url: http://www.last.fm/tag/french Count: 85 Name: 00s Url: http://www.last.fm/tag/00s Count: 23 Name: French rock Url: http://www.last.fm/tag/french%20rock Count: 22 [..]
- Friends added to a profile :
CL-USER> (cl-audioscrobbler::get-user-friends "lam_")
- People with similar taste to this profile :
CL-USER> (cl-audioscrobbler::get-user-neighbours "lam_") ( Name: blumenal Url: http://www.last.fm/user/blumenal/ Image: http://panther1.last.fm/depth/catalogue/noimage/nouser_140px.jpg Match: 100 Name: thiagozanato Url: http://www.last.fm/user/thiagozanato/ Image: http://panther1.last.fm/avatar/dc07dd8d6ed2dbf6676ae5be92571b8c.jpg Match: 83 Name: deadpot99 Url: http://www.last.fm/user/deadpot99/ Image: http://panther1.last.fm/avatar/6b2e304b09313a0a95d5fe18b155eee0.jpg Match: 81.03 [...]
- A list of recently played tracks for this profile.
CL-USER> (cl-audioscrobbler::get-user-recent-tracks "lam_")
- A list of similarity of this user to another user :
CL-USER> (cl-audioscrobbler::get-user-taste-o-meter "lam_" "antipodium") lam_ - antipodium : 1 TV on the Radio, Clap Your Hands Say Yeah, The Arcade Fire, Bloc Party, Cansei de Ser Sexy
- Retrieve a list of most played music albums by an user :
CL-USER> (cl-audioscrobbler::get-user-top-albums "lam_") ( Artist: Gnarls Barkley Count: 188 Large: http://panther1.last.fm/coverart/130x130/2419895.jpg Medium: http://cdn.last.fm/coverart/130x130/2419895.jpg Small: http://cdn.last.fm/coverart/50x50/2419895.jpg Artist: Electrelane Count: 174 Large: http://images.amazon.com/images/P/B0000B0WVQ.01._SCMZZZZZZZ_.jpg Medium: http://images.amazon.com/images/P/B0000B0WVQ.01._SCMZZZZZZZ_.jpg Small: http://images.amazon.com/images/P/B0000B0WVQ.01._SCMZZZZZZZ_.jpg Artist: Clap Your Hands Say Yeah Count: 170 Large: http://images.amazon.com/images/P/B000AOJHZA.01.MZZZZZZZ.jpg Medium: http://images.amazon.com/images/P/B000AOJHZA.01.MZZZZZZZ.jpg Small: http://images.amazon.com/images/P/B000AOJHZA.01.MZZZZZZZ.jpg [...]
- Retrieve a list of most played artists by an user :
CL-USER> (cl-audioscrobbler::get-user-top-artists "lam_") ( Artist: TV on the Radio Count: 507 MBid : eb872766-98f6-453d-883f-2ae908a18315 Url : http://www.last.fm/music/TV+on+the+Radio Rank: 1 Artist: Clap Your Hands Say Yeah Count: 252 MBid : 4b2d6a23-034d-4a29-9bb9-d2462796da4e Url : http://www.last.fm/music/Clap+Your+Hands+Say+Yeah Rank: 2 Artist: Electrelane Count: 219 MBid : 7756e3dc-f44c-4678-a7bc-d1b31204a963 Url : http://www.last.fm/music/Electrelane Rank: 3 Artist: Gnarls Barkley Count: 210 MBid : Url : http://www.last.fm/music/Gnarls+Barkley Rank: 4 [...]
- A list of the most used tags by a music profile :
CL-USER> (cl-audioscrobbler::get-user-top-tags "lam_")
- Retrieve a list of most played music tracks by an user :
CL-USER> (cl-audioscrobbler::get-user-top-tracks "lam_") ( Artist: TV on the Radio Title: Staring at the Sun Count: 43 MBid: NIL Url: http://www.last.fm/music/TV+on+the+Radio/_/Staring+at+the+Sun Rank: 1 Artist: TV on the Radio Title: King Eternal Count: 30 MBid: NIL Url: http://www.last.fm/music/TV+on+the+Radio/_/King+Eternal Rank: 2 Artist: TV on the Radio Title: Dreams Count: 29 MBid: NIL Url: http://www.last.fm/music/TV+on+the+Radio/_/Dreams Rank: 3 Artist: TV on the Radio Title: Playhouses Count: 25 MBid: NIL Url: http://www.last.fm/music/TV+on+the+Radio/_/Playhouses Rank: 4 [...]
- Post which song is listening :
CL-USER> (defparameter *c* (cl-audioscrobbler::make-client "user" "passwd" "tst" "1.0")) *C* CL-USER> (cl-audioscrobbler::post-song *c* :1.1 "TV on the radio" "Desperate Youth Blood Thirsty Babes" "Staring at the sun" "300" "25") T
The identifier "tst", with a version number of "1.0" is only for test.
- Make a friendly output :
News
Add some webservices and implements the 1.1 Audioscrobbler Protocol
Split code, and update API.
First public version.
Team
List of developers :
Nicolas Lamirault - nicolas.lamirault@gmail.com
Mailing Lists
Mailing lists that have been established for this project :
Repository
NIL NIL
Releases
API
API Reference documentation for
cl-audioscrobbler project.
XREF
Source Reference for cl-audioscrobbler project.
Lisp Critic
Check aspects of cl-audioscrobbler project's source code.