Musix Match¶ ↑

 _                                                                              _
| |       _                                                            _       | |
| |      | |                                                          | |      | |
| | _  _ | |                                                          | | _  _ | |
| || || || |    MusixMatch is a wrapper for the musixmatch.com API's. | || || || |
| || || || |  With this library you can search for lyrics and tracks  | || || || |
| |  || || |        using the http://musixmatch.com service.          | |  || || |
|          |                                                          |          |
|          |                                                          |          |
\          /                                                          \          /
 ----------                                                            ----------

Installation¶ ↑

gem install musix_match

Usage¶ ↑

require 'musix_match'

MusixMatch::API::Base.api_key = 'YOUR_API_KEY'

Track search¶ ↑

response = MusixMatch.search_track(:q_artist => 'Pantera')
if response.status_code == 200
  response.each do |track|
    puts "#{track.track_id}: #{track.track_name} (#{track.artist_name})"
  end
end

Available options for the search_track methods are:

• q: a string that will be searched in every data field

• q_track: string to be searched among tracks titles

• q_artist: string to be searched among artists names

• page: requested page of results

• page_size: desired number of items per result page

• f_has_lyrics: exclude tracks without an available lyrics

Getting lyrics¶ ↑

response = MusixMatch.get_lyrics(track_id)
if response.status_code == 200 && lyrics = response.lyrics
  puts lyrics.lyrics_body
end

Getting track¶ ↑

response = MusixMatch.get_track(track_id)
if response.status_code == 200 && track = response.track
  puts "#{track.track_name} (#{track.artist_name})"
  puts "Lyrics id: #{track.lyrics_id}"
end

Are you feeling lucky?¶ ↑

puts MusixMatch.i_m_feeling_lucky("Guns'n'Roses - Welcome to the jungle")

Lyrics¶ ↑

The Lyrics object has the following attributes:

• lyrics_id

• lyrics_body

• lyrics_language

• script_tracking_url

• lyrics_copyright

• track_name

• artist_name

Track¶ ↑

The track object has the following attributes:

• track_id

• track_mbid

• track_name

• track_mbid

• track_length

• lyrics_id

• instrumental

• subtitle_id

• artist_id

• artist_mbid

• artist_name

• artist_mbid

• album_name

• album_id

• album_coverart_100x100

Sending Feedback¶ ↑

MusixMatch.post_feedback(track_id, lyrics_id, feedback_type)

Feedback type should be one of the following:

• wrong_attribution (the lyrics shown are not by the artist that I selected.)

• bad_characters (there are strange characters and/or words that are partially scrambled.)

• lines_too_long (the text for each verse is too long!)

• wrong_verses (there are some verses missing from the beginning or at the end.)

• wrong_formatting (the text looks horrible, please fix it!)

Links¶ ↑

• Repository: git://github.com/pilu/musix_match.git

• Musixmatch site: musixmatch.com

• Musixmatch API: developer.musixmatch.com

Author¶ ↑

Andrea Franz - gravityblast.com