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.
News
  • Version 0.3 [2007-07-26] :

    Add some webservices and implements the 1.1 Audioscrobbler Protocol

  • Version 0.2 [2007-05-28] :

    Split code, and update API.

  • Version 0.1 [2007-01-23] :

    First public version.

  • Links
    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.