thresher

An unofficial API for the Grooveshark music streaming service.

License	The Apache Software License, Version 2.0
GroupId	co.arcs.groove
ArtifactId	thresher
Last Version	1.2.1
Release Date	Jun 10, 2014
Type	jar
Description	thresher An unofficial API for the Grooveshark music streaming service.
Project URL	https://github.com/danhawkes/thresher
Source Code Management	https://github.com/danhawkes/thresher

Download thresher

Filename	Size
thresher-1.2.1.pom
thresher-1.2.1.jar	34 KB
thresher-1.2.1-sources.jar	11 KB
thresher-1.2.1-javadoc.jar	65 KB
thresher-1.2.1-jar-with-dependencies.jar	4 MB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/co.arcs.groove/thresher/ -->
<dependency>
    <groupId>co.arcs.groove</groupId>
    <artifactId>thresher</artifactId>
    <version>1.2.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/co.arcs.groove/thresher/
implementation 'co.arcs.groove:thresher:1.2.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/co.arcs.groove/thresher/
implementation ("co.arcs.groove:thresher:1.2.1")

Apache Buildr

'co.arcs.groove:thresher:jar:1.2.1'

Apache Ivy

<dependency org="co.arcs.groove" name="thresher" rev="1.2.1">
  <artifact name="thresher" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='co.arcs.groove', module='thresher', version='1.2.1')
)

Scala SBT

libraryDependencies += "co.arcs.groove" % "thresher" % "1.2.1"

Leiningen

[co.arcs.groove/thresher "1.2.1"]

Dependencies

compile (4)

Group / Artifact	Type	Version
com.google.guava : guava	jar	15.0
com.belladati : httpclientandroidlib	jar	4.3.0
com.fasterxml.jackson.core : jackson-databind	jar	2.2.2
com.google.code.findbugs : jsr305	jar	2.0.2

test (2)

Group / Artifact	Type	Version
junit : junit	jar	4.11
org.mockito : mockito-core	jar	1.9.5

Project Modules

There are no modules declared in this project.

Thresher

An unofficial API for Grooveshark, in Java.

Download

With Maven:

<dependency>
	<groupId>co.arcs.groove</groupId>
	<artifactId>thresher</artifactId>
	<version>X.X.X</version>
</dependency>

Or Gradle:

compile 'co.arcs.groove:thresher:X.X.X'

Find the latest version on maven central.

Usage

All API requests go through a client object:

client = new Client();

Search

By keyword:

client.search("clair de lune");

For popular songs:

client.searchPopularSongs();

Stream

Get a short-lived song URL:

client.getStreamUrl(Song);

Log in

Log in to get access a user's data:

user = client.login("username", "hunter2");

List the contents of their library and favorites:

user.library().get();
user.favorites().get();

Add or remove songs:

user.library().add(song);
user.library().remove(song);
user.favorites().add(song);
user.favorites().remove(song);

Build / Test

To build and run tests against the real servers:

mvn clean test

Notes

Bug reports and pull requests are much appreciated.
Thanks to sosedoff and contributors for providing API information in their Ruby library.

Licence

Apache 2.0. See LICENCE.txt for details.

Versions

Version
1.2.1 Jun 10, 2014