LastFM Java Client

A Java client for the Last.fm API.

Quick Start

import io.github.rubeneekhof.lastfm.api.LastFmClient;

var apiKey = "your-api-key-here";
LastFmClient client = LastFmClient.builder()
    .apiKey(apiKey)
    .build();

var artist = client.artists().getInfo("Cher");

Installation

Maven

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.github.RubenJ01</groupId>
        <artifactId>lastfm-java-client</artifactId>
        <version>2.0.0</version>
    </dependency>
</dependencies>

Gradle

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    implementation 'com.github.RubenJ01:lastfm-java-client:2.0.0'
}

Documentation

📚 Full documentation is available in the Wiki

• Installation - Maven/Gradle setup
• Basic Usage - Getting started guide
• Authentication - Setting up authenticated requests
• Scrobbling - Recording listening history
• Pagination - Working with paginated results
• UnixTime Utilities - Timestamp helper documentation
• API Reference - Complete API coverage
• Project Structure - Architecture overview

📋 Changelog - Version history and release notes

What it does

• Builder pattern for requests
• Authentication support
• Scrobbling
• Pagination helpers for iterating over results
• Helper classes for timestamps and dates

License

MIT License - See LICENSE for details.