Giter Club home page Giter Club logo

rockstar's Introduction

Rockstar Build Status Gem Version

Rockstar is a wrapper for the last.fm audioscrobbler web services (http://www.last.fm/api/). This gem is based on the scrobbler gem 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"}

Users

user = Rockstar::User.new('jnunemaker')

puts "#{user.username}'s Recent Tracks"
puts "=" * (user.username.length + 16)
user.recent_tracks.each { |t| puts t.name }

puts
puts

puts "#{user.username}'s Top Tracks"
puts "=" * (user.username.length + 13)
user.top_tracks.each { |t| puts "(#{t.playcount}) #{t.name}" }

Albums

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')}"

Artists

If you want to load all informations about an artist or any other object, you have to add :include_info => true .

artist = Rockstar::Artist.new('Carrie Underwood', :include_info => true)

puts artist.url

puts 'Top Tracks'
puts "=" * 10
artist.top_tracks.each { |t| puts "(#{t.name}" }

puts

puts 'Similar Artists'
puts "=" * 15
artist.similar.each { |a| puts "(#{a.match}%) #{a.name}" }

Tags

tag = Rockstar::Tag.new('country')

puts 'Top Albums'
tag.top_albums.each { |a| puts "(#{a.count}) #{a.name} by #{a.artist}" }

puts

puts 'Top Tracks'
tag.top_tracks.each { |t| puts "(#{t.count}) #{t.name} by #{t.artist}" }

Geo

geo = Rockstar::Geo.new

# Get events for a lat/long
geo.events(:lat => 50.0, :long => 12.3).each{|e| p "#{e.title} at #{e.venue.name}"}

# Get events for a location
geo.events(:location => 'london').each{|e| p "#{e.title} at #{e.venue.name}"}

# To get a list of possible locations use
geo.metros("germany").each{|m| p m.name}

# Retrieve list of top tracks by country
geo.toptracks('united kingdom', 10).each{|t| p "#{t.name} by #{t.artist}"}

# Retrieve list of top artists by country
geo.topartists('united kingdom', 10).each{|a| p "artist #{a.name} with #{a.listenercount} listeners"}

Library

# Get artists and albums for user
library = Rockstar::Library.new

puts '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::User
user = Rockstar::User.new('jnunemaker')

puts 'Artists'
user.artists.each { |a| puts a.name }

puts 'Albums'
user.albums.each { |a| puts a.name }

Get rights to access the user data for scrobbing, now playing, events etc...

a = Rockstar::Auth.new
token = a.token

puts
puts "Please open http://www.last.fm/api/auth/?api_key=#{Rockstar.lastfm_api_key}&token=#{token}"
puts
puts "Press enter when done."

gets

session = a.session(token)

You can store the session.key somewhere and use it from now on to identify the user. More details can be found in Rockstar::Auth or examples/scrobble.rb

Tracks

track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')
puts 'Fans'
puts "=" * 4
track.fans.each { |u| puts "(#{u.weight}) #{u.username}" }

track.love(session.key)

Scrobbling

track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')
track.scrobble(Time.now, session.key)

Now Playing Submission

track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')
track.updateNowPlaying(Time.now, session.key)

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future 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

Copyright (c) 2007-2011 John Nunemaker, Bodo "Bitboxer" Tasche, Nick "zapnap" Plante. See LICENSE for details.

Acknowledgements

Thanks to putpat.tv for sponsering the work on the rockstar gem.

rockstar's People

Contributors

bitboxer avatar zapnap avatar jnunemaker avatar titanous avatar rob-murray avatar krasnoukhov avatar juhat avatar chrblabla avatar jonaustin avatar viettienn avatar whatwho avatar johnu avatar klaustopher avatar pauldowman avatar scf4 avatar

Watchers

 avatar James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.