JarCastingA simple Java Scrobble Client for Last.fm
This client uses jkovac's lastfm-java library for calls of the official Last.fm API as well as the lastfm-unscrobble-java library for unscrobbling and updating Scrobbles.
The purpose of this library is to simplify all interactions with Last.fm concerning scrobbles as well as providing extended features - relying on official and unofficial features of Last.fm - such as scrobble updating.
Usage
Initializing the Scrobble Client
LastfmAuthenticationDetails authenticationDetails = new LastfmAuthenticationDetails();
authenticationDetails.setApiKey("api-key");
authenticationDetails.setSharedSecret("shared-secret");
authenticationDetails.setUsername("username");
authenticationDetails.setPassword("password");
ScrobbleClient scrobbleClient = new ScrobbleClient();
try {
scrobbleClient.login(authenticationDetails);
} catch(LastfmAuthenticationException e){
System.err.println(e.getMessage());
}
Not all authentication details are mandatory depending on what you want to do. Certain operations require certain authentication details as shown in the table below:
| Scrobbling | Fetching Scrobbles | Unscrobbling | Updating Scrobbles | |
|---|---|---|---|---|
| API key | X | X | X | |
| Shared Secret | X | X | ||
| Username | X | X | X | X |
| Password | X | X | X |
So if for example you only want to fetch scrobble data from a user then the username and your API key is sufficient.
Fetching all Scrobbles
List<Scrobble> scrobbles = scrobbleClient.getAllScrobbles();
Fetching Scrobbles from a specific time
Temporal since = ZonedDateTime.now(ZoneOffset.UTC).minusDays(10);
List<Scrobble> scrobblesSince = scrobbleClient.getScrobblesSince(since);
Fetching a certain amount of Scrobbles
List<Scrobble> scrobbles = scrobbleClient.getLastScrobbles(100);
Scrobbling a Track
Scrobble scrobble = scrobbleClient.scrobble("LIQ","[un]INSOMNIA");
Setting the now playing status
Scrobble scrobble = scrobbleClient.nowPlaying("LIQ","[un]INSOMNIA");
Unscrobbling a Scrobble
Scrobble lastScrobble = scrobbles.get(0);
scrobbleClient.unscrobble(lastScrobble);
Updating Scrobble data
scrobble.setArtist("LIQ feat. 結月ゆかり");
scrobbleClient.updateScrobble(scrobble);
Maven Dependency
<dependency>
<groupId>net.beardbot</groupId>
<artifactId>lastfm-simple-scrobble-client</artifactId>
<version>1.0.2</version>
</dependency>
Enable debug logging
-Dorg.slf4j.simpleLogger.defaultLogLevel=DEBUG