4 # :title: lastfm plugin for rbot
6 # Author:: Jeremy Voorhis
7 # Author:: Giuseppe "Oblomov" Bilotta <giuseppe.bilotta@gmail.com>
8 # Author:: Casey Link <unnamedrambler@gmail.com>
10 # Copyright:: (C) 2005 Jeremy Voorhis
11 # Copyright:: (C) 2007 Giuseppe Bilotta
12 # Copyright:: (C) 2008 Casey Link
16 require 'rexml/document'
23 @location = hash[:location]
24 @description = hash[:description]
25 @attendance = hash[:attendance]
27 @artists = hash[:artists]
29 if @artists.length > 10 #more than 10 artists and it floods
30 diff = @artists.length - 10
31 @artist_string = Bold + @artists[0..10].join(', ') + Bold
32 @artist_string << _(" and %{n} more...") % {:n => diff}
34 @artist_string = Bold + @artists.join(', ') + Bold
39 unless @attendance.zero?
40 return "%s %s @ %s (%s attending) %s" % [@date.strftime("%a, %b %d"), @artist_string, @location, @attendance, @url]
42 return "%s %s @ %s %s" % [@date.strftime("%a, %b %d"), @artist_string, @location, @url]
44 alias :to_s :compact_display
48 class LastFmPlugin < Plugin
50 Config.register Config::IntegerValue.new('lastfm.max_events',
51 :default => 25, :validate => Proc.new{|v| v > 1},
52 :desc => "Maximum number of events to display.")
53 Config.register Config::IntegerValue.new('lastfm.default_events',
54 :default => 3, :validate => Proc.new{|v| v > 1},
55 :desc => "Default number of events to display.")
57 APIKEY = "b25b959554ed76058ac220b7b2e0a026"
58 APIURL = "http://ws.audioscrobbler.com/2.0/?api_key=#{APIKEY}&"
72 def help(plugin, topic="")
73 case (topic.intern rescue nil)
75 _("lastfm [<num>] events in <location> => show information on events in or near <location>. lastfm [<num>] events by <artist/group> => show information on events by <artist/group>. The number of events <num> that can be displayed is optional, defaults to %{d} and cannot be higher than %{m}") % {:d => @bot.config['lastfm.default_events'], :m => @bot.config['lastfm.max_events']}
77 _("lastfm artist <name> => show information on artist <name> from last.fm")
79 _("lastfm album <name> => show information on album <name> from last.fm [not implemented yet]")
81 _("lastfm track <name> => search tracks matching <name> on last.fm")
83 _("lastfm now [<user>] => show the now playing track from last.fm. np [<user>] does the same.")
85 _("lastfm set user <user> => associate your current irc nick with a last.fm user. lastfm set verb <present>, <past> => set your preferred now playing/just played verbs. default \"is listening to\" and \"listened to\".")
87 _("lastfm who [<nick>] => show who <nick> is on last.fm. if <nick> is empty, show who you are on lastfm.")
89 _("lastfm compare [<nick1>] <nick2> => show musical taste compatibility between nick1 (or user if omitted) and nick2")
91 _("lastfm [<user>] => show your or <user>'s now playing track on lastfm. np [<user>] => same as 'lastfm'. other topics: events, artist, album, track, now, set, who, compare")
95 def find_events(m, params)
96 num = params[:num] || @bot.config['lastfm.default_events']
97 num = num.to_i.clip(1, @bot.config['lastfm.max_events'])
99 location = params[:location]
100 artist = params[:who]
101 user = resolve_username(m, params[:user])
104 uri = "#{APIURL}method=geo.getevents&location=#{CGI.escape location.to_s}"
105 emptymsg = _("no events found in %{location}") % {:location => location.to_s}
107 uri = "#{APIURL}method=artist.getevents&artist=#{CGI.escape artist.to_s}"
108 emptymsg = _("no events found by %{artist}") % {:artist => artist.to_s}
110 uri = "#{APIURL}method=user.getevents&user=#{CGI.escape user}"
111 emptymsg = _("%{user} is not attending any events") % {:user => user}
113 xml = @bot.httputil.get_response(uri)
115 doc = Document.new xml.body
116 if xml.class == Net::HTTPInternalServerError
117 if doc.root and doc.root.attributes["status"] == "failed"
118 m.reply doc.root.elements["error"].text
120 m.reply _("could not retrieve events")
123 disp_events = Array.new
125 doc.root.elements.each("events/event"){ |e|
127 h[:title] = e.elements["title"].text
128 venue = e.elements["venue"].elements["name"].text
129 city = e.elements["venue"].elements["location"].elements["city"].text
130 country = e.elements["venue"].elements["location"].elements["country"].text
131 h[:location] = Underline + venue + Underline + " #{Bold + city + Bold}, #{country}"
132 date = e.elements["startDate"].text.split
133 h[:date] = Time.utc(date[3].to_i, date[2], date[1].to_i)
134 h[:desc] = e.elements["description"].text
135 h[:url] = e.elements["url"].text
136 h[:attendance] = e.elements["attendance"].text.to_i
138 e.elements.each("artists/artist"){ |a|
141 h[:artists] = artists
142 events << LastFmEvent.new(h)
148 events[0...num].each { |event|
149 disp_events << event.to_s
151 m.reply disp_events.join(' | '), :split_at => /\s+\|\s+/
155 def tasteometer(m, params)
156 opts = { :cache => false }
157 user1 = resolve_username(m, params[:user1])
158 user2 = resolve_username(m, params[:user2])
159 xml = @bot.httputil.get_response("#{APIURL}method=tasteometer.compare&type1=user&type2=user&value1=#{CGI.escape user1}&value2=#{CGI.escape user2}", opts)
160 doc = Document.new xml.body
162 m.reply _("last.fm parsing failed")
165 if xml.class == Net::HTTPBadRequest
166 if doc.root.elements["error"].attributes["code"] == "7" then
167 error = doc.root.elements["error"].text
168 error.match(/Invalid username: \[(.*)\]/);
171 m.reply _("%{u} doesn't exist on last.fm") % {:u => baduser}
174 m.reply _("error: %{e}") % {:e => doc.root.element["error"].text}
178 score = doc.root.elements["comparison/result/score"].text.to_f
179 artists = doc.root.get_elements("comparison/result/artists/artist").map { |e| e.elements["name"].text}
184 rating = _("Very High")
192 rating = _("Very Low")
195 reply = _("%{a}'s and %{b}'s musical compatibility rating is %{bold}%{r}%{bold}") % {
198 :r => rating.downcase,
202 reply << _(" and music they have in common includes: %{artists}") % {
203 :artists => artists.join(", ")
204 } unless artists.empty?
209 def now_playing(m, params)
210 opts = { :cache => false }
211 user = resolve_username(m, params[:who])
212 xml = @bot.httputil.get_response("#{APIURL}method=user.getrecenttracks&user=#{CGI.escape user}", opts)
213 doc = Document.new xml.body
215 m.reply _("last.fm parsing failed")
218 if xml.class == Net::HTTPBadRequest
219 if doc.root.elements["error"].text == "Invalid user name supplied" then
220 m.reply _("%{user} doesn't exist on last.fm, perhaps they need to: lastfm user <username>") % {
225 m.reply _("error: %{e}") % {:e => doc.root.element["error"].text}
229 now = artist = track = albumtxt = date = nil
230 unless doc.root.elements[1].has_elements?
231 m.reply _("%{u} hasn't played anything recently") % {:u => user}
234 first = doc.root.elements[1].elements[1]
235 now = first.attributes["nowplaying"]
236 artist = first.elements["artist"].text
237 track = first.elements["name"].text
238 albumtxt = first.elements["album"].text
241 year = get_album(artist, albumtxt)[2]
242 album = "[#{albumtxt}, #{year}] " if year
245 date = XPath.first(first, "//date")
247 time = date.attributes["uts"]
248 past = Time.at(time.to_i)
251 verb = _("is listening to")
252 if @registry.has_key? "#{m.sourcenick}_verb_present"
253 verb = @registry["#{m.sourcenick}_verb_present"]
255 m.reply _("%{u} %{v} \"%{t}\" by %{a} %{b}") % {:u => user, :v => verb, :t => track, :a => artist, :b => album}
257 verb = _("listened to")
258 if @registry.has_key? "#{m.sourcenick}_verb_past"
259 verb = @registry["#{m.sourcenick}_verb_past"]
261 ago = Utils.timeago(past)
262 m.reply _("%{u} %{v} \"%{t}\" by %{a} %{b}%{p}") % {:u => user, :v => verb, :t => track, :a => artist, :b => album, :p => ago}
266 def find_artist(m, params)
267 xml = @bot.httputil.get("#{APIURL}method=artist.getinfo&artist=#{CGI.escape params[:artist].to_s}")
269 m.reply _("I had problems getting info for %{a}") % {:a => params[:artist]}
272 doc = Document.new xml
274 m.reply _("last.fm parsing failed")
277 first = doc.root.elements["artist"]
278 artist = first.elements["name"].text
279 playcount = first.elements["stats"].elements["playcount"].text
280 listeners = first.elements["stats"].elements["listeners"].text
281 summary = first.elements["bio"].elements["summary"].text
282 m.reply _("%{b}%{a}%{b} has been played %{c} times and is being listened to by %{l} people") % {:b => Bold, :a => artist, :c => playcount, :l => listeners}
283 m.reply summary.ircify_html
286 def find_track(m, params)
287 track = params[:track].to_s
288 xml = @bot.httputil.get("#{APIURL}method=track.search&track=#{CGI.escape track}")
290 m.reply _("I had problems getting info for %{a}") % {:a => track}
294 doc = Document.new xml
296 m.reply _("last.fm parsing failed")
300 results = doc.root.elements["results/opensearch:totalResults"].text.to_i rescue 0
304 doc.root.each_element("results/trackmatches/track") do |track|
305 hits << _("%{bold}%{t}%{bold} by %{bold}%{a}%{bold} (%{n} listeners)") % {
306 :t => track.elements["name"].text,
307 :a => track.elements["artist"].text,
308 :n => track.elements["listeners"].text,
312 m.reply hits.join(' -- '), :split_at => ' -- '
315 m.reply _("last.fm parsing failed")
318 m.reply _("track %{a} not found") % {:a => track}
322 def get_album(artist, album)
323 xml = @bot.httputil.get("#{APIURL}method=album.getinfo&artist=#{CGI.escape artist}&album=#{CGI.escape album}")
325 return [_("I had problems getting album info")]
327 doc = Document.new xml
329 return [_("last.fm parsing failed")]
331 album = date = playcount = artist = date = year = nil
332 first = doc.root.elements["album"]
333 artist = first.elements["artist"].text
334 playcount = first.elements["playcount"].text
335 album = first.elements["name"].text
336 date = first.elements["releasedate"].text
337 unless date.strip.length < 2
338 year = date.strip.split[2].chop
340 result = [artist, album, year, playcount]
344 def find_album(m, params)
345 album = get_album(params[:artist].to_s, params[:album].to_s)
347 m.reply _("I couldn't locate: \"%{a}\" by %{r}") % {:a => params[:album], :r => params[:artist]}
350 year = "(#{album[2]}) " unless album[2] == nil
351 m.reply _("the album \"%{a}\" by %{r} %{y}has been played %{c} times") % {:a => album[1], :r => album[0], :y => year, :c => album[3]}
354 def set_user(m, params)
355 user = params[:who].to_s
357 @registry[ nick ] = user
358 m.reply _("okay, I'll remember that %{n} is %{u} on last.fm") % {:n => nick, :u => user}
361 def set_verb(m, params)
362 past = params[:past].to_s
363 present = params[:present].to_s
364 key = "#{m.sourcenick}_verb_"
365 @registry[ "#{key}past" ] = past
366 @registry[ "#{key}present" ] = present
367 m.reply _("okay, I'll remember that %{n} prefers \"%{r}\" and \"%{p}\"") % {:n => m.sourcenick, :p => past, :r => present}
370 def get_user(m, params)
373 nick = params[:who].to_s
377 if @registry.has_key? nick
378 user = @registry[ nick ]
379 m.reply _("%{nick} is %{user} on last.fm") % {
384 m.reply _("sorry, I don't know who %{n} is on last.fm, perhaps they need to: lastfm set user <username>") % {:n => nick}
388 def lastfm(m, params)
389 action = case params[:action]
390 when "neighbors" then "neighbours"
391 when "recentracks" then "recenttracks"
392 when /^weekly(track|album|artist)s$/
395 find_events(m, params)
401 user = resolve_username(m, params[:user])
402 uri = "#{APIURL}method=user.get#{action}&user=#{CGI.escape user}"
404 if period = params[:period]
405 period_uri = (period.last == "year" ? "12month" : period.first + "month")
406 uri << "&period=#{period_uri}"
409 res = @bot.httputil.get_response(uri)
411 m.reply _("I had problems accessing last.fm")
414 doc = Document.new(res.body)
416 m.reply _("last.fm parsing failed")
421 when Net::HTTPBadRequest
422 if doc.root and doc.root.attributes["status"] == "failed"
423 m.reply "error: " << doc.root.elements["error"].text.downcase
430 friends = doc.root.get_elements("friends/user").map do |u|
431 u.elements["name"].text
434 unless friends.empty?
435 m.reply _("%{user} has %{total} friends; %{friends}") %
436 { :user => user, :total => friends.size, :friends => friends.join(", ") }
438 m.reply _("%{user} has no friends :(") % { :user => user }
441 loved = doc.root.get_elements("lovedtracks/track").map do |track|
442 [track.elements["artist/name"].text, track.elements["name"].text].join(" - ")
444 loved_prep = loved.shuffle[0..4].to_enum(:each_with_index).collect { |e,i| (i % 2).zero? ? Underline+e+Underline : e }
447 m.reply _("%{user} has loved %{total} tracks, including %{tracks} %{uri}") % {
449 :total => loved.size,
450 :tracks => loved_prep.join(", "),
451 :uri => "http://www.last.fm/user/#{CGI.escape user}/library/loved"
454 m.reply _("%{user} has not loved any tracks") % { :user => user }
457 nbrs = doc.root.get_elements("neighbours/user").map do |u|
458 u.elements["name"].text
462 m.reply _("%{user}'s musical neighbors include %{nbrs} %{uri}") % {
464 :nbrs => nbrs.shuffle[0..9].join(", "),
465 :uri => "http://www.last.fm/user/#{CGI.escape user}/neighbours"
468 m.reply _("no one seems to share %{user}'s musical taste") % { :user => user }
471 tracks = doc.root.get_elements("recenttracks/track").map do |track|
472 [track.elements["artist"].text, track.elements["name"].text].join(" - ")
474 tracks_prep = tracks.to_enum(:each_with_index).collect { |e,i| (i % 2).zero? ? Underline+e+Underline : e }
477 m.reply _("%{user} has recently played %{tracks}") %
478 { :user => user, :tracks => tracks_prep.join(", ") }
480 m.reply _("%{user} hasn't played anything recently") % { :user => user }
483 shouts = doc.root.get_elements("shouts/shout")
485 shouts[0..4].each do |shout|
486 m.reply _("<%{author}> %{body}") % {
487 :body => shout.elements["body"].text,
488 :author => shout.elements["author"].text,
492 m.reply _("there are no shouts for %{user}") % { :user => user }
494 when :toptracks, :topalbums, :topartists, :weeklytrackchart, :weeklyalbumchart, :weeklyartistchart
495 type = action.to_s.scan(/track|album|artist/).to_s
496 items = doc.root.get_elements("#{action}/#{type}").map do |item|
498 when :weeklytrackchart, :weeklyalbumchart
499 format = "%{artist} - %{title} (%{bold}%{plays}%{bold})"
500 artist = item.elements["artist"].text
501 when :weeklyartistchart, :topartists
502 format = "%{artist} (%{bold}%{plays}%{bold})"
503 artist = item.elements["name"].text
504 when :toptracks, :topalbums
505 format = "%{artist} - (%{title} %{bold}%{plays}%{bold})"
506 artist = item.elements["artist/name"].text
511 :title => item.elements["name"].text,
512 :plays => item.elements["playcount"].text,
516 m.reply items[0..9].join(", ")
520 def resolve_username(m, name)
521 name = m.sourcenick if name.nil?
522 @registry[name] or name
526 plugin = LastFmPlugin.new
527 plugin.map 'lastfm [:num] event[s] in *location', :action => :find_events, :requirements => { :num => /\d+/ }, :thread => true
528 plugin.map 'lastfm [:num] event[s] by *who', :action => :find_events, :requirements => { :num => /\d+/ }, :thread => true
529 plugin.map 'lastfm [:num] event[s] [for] *who', :action => :find_events, :requirements => { :num => /\d+/ }, :thread => true
530 plugin.map 'lastfm artist *artist', :action => :find_artist, :thread => true
531 plugin.map 'lastfm album *album [by *artist]', :action => :find_album
532 plugin.map 'lastfm track *track', :action => :find_track, :thread => true
533 plugin.map 'lastfm set user[name] :who', :action => :set_user, :thread => true
534 plugin.map 'lastfm set verb *present, *past', :action => :set_verb, :thread => true
535 plugin.map 'lastfm who [:who]', :action => :get_user, :thread => true
536 plugin.map 'lastfm compare to :user2', :action => :tasteometer, :thread => true
537 plugin.map 'lastfm compare [:user1] [to] :user2', :action => :tasteometer, :thread => true
538 plugin.map "lastfm [user] :action [:user]", :thread => true,
539 :requirements => { :action =>
540 /^(?:events|shouts|friends|neighbou?rs|(?:loved|recent?)tracks|top(?:album|artist|track)s?|weekly(?:albums?|artists?|tracks?)(?:chart)?)$/
542 plugin.map 'lastfm [user] :action [:user] over [*period]', :thread => true,
544 :action => /^(?:top(?:album|artist|track)s?)$/,
545 :period => /^(?:(?:3|6|12) months)|(?:a\s|1\s)?year$/
547 plugin.map 'lastfm [now] [:who]', :action => :now_playing, :thread => true
548 plugin.map 'np [:who]', :action => :now_playing, :thread => true