- Notifications
You must be signed in to change notification settings - Fork0
Rockstar is a wrapper for the audioscrobbler v2.0 (last.fm) web services. This gem includes scrobbling with the new api.
License
dcarneiro/rockstar
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Rockstar is a wrapper for the last.fm audioscrobbler web services (http://www.last.fm/api/). This gem is based on the scrobblergem by John Nunemaker and was updated to use the 2.0 version of the last.fm api
Below is just a sampling of how easy this lib is to use.
Please initialize your api key and secret before using the api:
Rockstar.lastfm = YAML.load_file('lastfm.yml')Here is an example lastfm.yml:
api_key: "API"api_secret: "SECRET"If you want to use the api in an rails app, you could add an initializer in config/initializers/lastm.rb and load a config/lastfm.yml file.
rails_root = ENV['RAILS_ROOT'] || File.dirname(__FILE__) + '/../..'Rockstar.lastfm = YAML.load_file(rails_root + '/config/lastfm.yml')Alternatively you can provide a hash with the api key and secret:
Rockstar.lastfm = {:api_key => "API", :api_secret => "SECRET"}user = Rockstar::User.new('jnunemaker')puts "#{user.username}'s Recent Tracks"puts "=" * (user.username.length + 16)user.recent_tracks.each { |t| puts t.name }putsputsputs "#{user.username}'s Top Tracks"puts "=" * (user.username.length + 13)user.top_tracks.each { |t| puts "(#{t.playcount}) #{t.name}" }album = Rockstar::Album.new('Carrie Underwood', 'Some Hearts', :include_info => true)puts "Album: #{album.name}"puts "Artist: #{album.artist}"puts "URL: #{album.url}"puts "Release Date: #{album.release_date.strftime('%m/%d/%Y')}"If you want to load all informations about an artist or any otherobject, you have to add:include_info => true .
artist = Rockstar::Artist.new('Carrie Underwood', :include_info => true)puts artist.urlputs 'Top Tracks'puts "=" * 10artist.top_tracks.each { |t| puts "(#{t.name}" }putsputs 'Similar Artists'puts "=" * 15artist.similar.each { |a| puts "(#{a.match}%) #{a.name}" }tag = Rockstar::Tag.new('country')puts 'Top Albums'tag.top_albums.each { |a| puts "(#{a.count}) #{a.name} by #{a.artist}" }putsputs 'Top Tracks'tag.top_tracks.each { |t| puts "(#{t.count}) #{t.name} by #{t.artist}" }geo = Rockstar::Geo.new# Get events for a lat/longgeo.events(:lat => 50.0, :long => 12.3).each{|e| p "#{e.title} at #{e.venue.name}"}# Get events for a locationgeo.events(:location => 'london').each{|e| p "#{e.title} at #{e.venue.name}"}# To get a list of possible locations usegeo.metros("germany").each{|m| p m.name}# Get artists and albums for userlibrary = Rockstar::Library.newputs 'Artists'library.artists(false, :user => 'jnunemaker').each { |a| puts a.name }puts 'Albums'library.albums(false, :user => 'jnunemaker').each { |a| puts a.name }# Get it with Rockstar::Useruser = Rockstar::User.new('jnunemaker')puts 'Artists'user.artists.each { |a| puts a.name }puts 'Albums'user.albums.each { |a| puts a.name }a = Rockstar::Auth.newtoken = a.tokenputsputs "Please open http://www.last.fm/api/auth/?api_key=#{Rockstar.lastfm_api_key}&token=#{token}"putsputs "Press enter when done."getssession = a.session(token)You can store the session.key somewhere and use it from now on to identify the user. Moredetails can be found in Rockstar::Auth or examples/scrobble.rb
track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')puts 'Fans'puts "=" * 4track.fans.each { |u| puts "(#{u.weight}) #{u.username}" }track.love(session.key)track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')track.scrobble(Time.now, session.key)track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')track.updateNowPlaying(Time.now, session.key)- Fork the project.
- Make your feature addition or bug fix.
- Add tests for it. This is important so I don't break it in afuture version unintentionally.
- Commit, do not mess with rakefile, version, or history.(if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
- Send me a pull request. Bonus points for topic branches.
Copyright (c) 2007-2011 John Nunemaker, Bodo "Bitboxer" Tasche, Nick "zapnap" Plante. See LICENSE for details.
Thanks toputpat.tv for sponsering the work on the rockstar gem.
About
Rockstar is a wrapper for the audioscrobbler v2.0 (last.fm) web services. This gem includes scrobbling with the new api.
Resources
License
Stars
Watchers
Forks
Packages0
Languages
- Ruby100.0%