- 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
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Packages0
Languages
- Ruby100.0%