sachin-handiekar/jmusixmatch

A Java wrapper for the MusiXmatch API

jMusixMatch

A Java wrapper for the MusixMatch API

Installation with Maven

<dependency>
  <groupId>com.sachinhandiekar</groupId>
  <artifactId>jMusixMatch</artifactId>
  <version>1.1.4</version>
</dependency>

If you prefer using the latest snapshot build, include the following lines to your pom.xml.

    <repositories>
        <repository>
            <id>oss.snapshots</id>
            <name>OSS Sonatype Snapshot Repository</name>
            <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
            <releases>
                <enabled>false</enabled>
            </releases>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </repository>
    </repositories>

    <dependencies>
        <dependency>
            <groupId>com.sachinhandiekar</groupId>
            <artifactId>jMusixMatch</artifactId>
             <version>1.1.5-SNAPSHOT</version>
        </dependency>
    </dependencies>

Usage

• Declaring the MusixMatch Instance

String apiKey = "Your MusixMatch API Key";
MusixMatch musixMatch = new MusixMatch(apiKey);

• Fuzzy Search

String trackName = "Don't stop the Party";
String artistName = "The Black Eyed Peas";

// Track Search [ Fuzzy ]
Track track = musixMatch.getMatchingTrack(trackName, artistName);
TrackData data = track.getTrack();

System.out.println("AlbumID : "    + data.getAlbumId());
System.out.println("Album Name : " + data.getAlbumName());
System.out.println("Artist ID : "  + data.getArtistId());
System.out.println("Album Name : " + data.getArtistName());
System.out.println("Track ID : "   + data.getTrackId());

• Getting Lyrics

int trackID = data.getTrackId();

Lyrics lyrics = musixMatch.getLyrics(trackID);

System.out.println("Lyrics ID       : "     + lyrics.getLyricsId());
System.out.println("Lyrics Language : "     + lyrics.getLyricsLang());
System.out.println("Lyrics Body     : "     + lyrics.getLyricsBody());
System.out.println("Script-Tracking-URL : " + lyrics.getScriptTrackingURL());
System.out.println("Pixel-Tracking-URL : "  + lyrics.getPixelTrackingURL());
System.out.println("Lyrics Copyright : "    + lyrics.getLyricsCopyright());

• Search Tracks

// The following will search for tracks with matching artist_name 'Eminem'
List<Track> tracks = musixMatch.searchTracks("", "Eminem", "", 10, 10, true);

for (Track trk : tracks) {
    TrackData trkData = trk.getTrack();
 
    System.out.println("AlbumID : "     + trkData.getAlbumId());
    System.out.println("Album Name : "  + trkData.getAlbumName());
    System.out.println("Artist ID : "   + trkData.getArtistId());
    System.out.println("Artist Name : " + trkData.getArtistName());
    System.out.println("Track ID : "    + trkData.getTrackId());
    System.out.println();
}

Dependencies

• Google GSON (http://code.google.com/p/google-gson/)

Contact Me

• LinkedIn
• Email : [email protected] or [email protected]
• Twitter : @sachinhandiekar

jmusixmatch's Issues

Add Coveralls plugin

Wrong TRACK_SUBTITLE method name

Methods.java:47
public static final String TRACK_SUBTITLE = "track.subtitle/get";

should be track.subtitle.get

Unit test for the API Endpoints

Create unit test for the below endpoints -

API Methods

• chart.artists.get
• chart.tracks.get
• track.search
• track.get
• track.subtitle.get
• track.lyrics.get
• track.snippet.get
• track.lyrics.post
• track.lyrics.feedback.post
• matcher.lyrics.get
• matcher.track.get
• matcher.subtitle.get
• artist.get
• artist.search
• artist.albums.get
• artist.related.get
• album.get
• album.tracks.get
• tracking.url.get
• catalogue.dump.get

JMusixMatch returning error

I just gone through your JMusixMatch java library on git and I must say a big kudos to you.

I'm having a slight issue. I'm trying to use the .getMatchingTrack function with another parameter aside the sample trackName and artistName u gave but I'm getting an error.

The error is : com.google.gson.JsonSyntaxException: java.lang.NumberFormatException: Expected an int but was 999.99999296056 at line 1 column 103 path $.message.header.confidence

Please help with solution and what I might have done wrong.

Thank you as I await your prompt response.

Snapshot Build in TravisCI

Error: Expected a string but was BEGIN_OBJECT

Hi there,

First of all thank you for your great jobyou've done with this project.

I have been using it for a while but lately it stopped working and threw this exception. I thought maybe Musixmatch itself changed something in the response and the library is not up to date.

Give it a look.

Exception in thread "main" com.google.gson.JsonSyntaxException: java.lang.IllegalStateException: Expected a string but was BEGIN_OBJECT at line 1 column 143 path $.message.body
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$Adapter.read(ReflectiveTypeAdapterFactory.java:224)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$1.read(ReflectiveTypeAdapterFactory.java:129)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$Adapter.read(ReflectiveTypeAdapterFactory.java:220)
at com.google.gson.Gson.fromJson(Gson.java:887)
at com.google.gson.Gson.fromJson(Gson.java:852)
at com.google.gson.Gson.fromJson(Gson.java:801)
at com.google.gson.Gson.fromJson(Gson.java:773)
at org.jmusixmatch.MusixMatch.handleErrorResponse(MusixMatch.java:301)
at org.jmusixmatch.MusixMatch.getTrackResponse(MusixMatch.java:279)
at org.jmusixmatch.MusixMatch.getMatchingTrack(MusixMatch.java:249)

Thank you.

Alex