README.md

JLyrics

🎼 Expandable lyrics-scraping API for Java

Example

LyricsClient client = new LyricsClient();
Lyrics lyrics = client.getLyrics("smooth criminal").get();
System.out.println(lyrics.getContent()); // As he came into the window ...

Features

• Async or blocking (uses CompletableFuture)
• Built-in caching to prevent duplicate scrapes
• Highly customizable (see reference.conf and lightbend/config)
• Easily expandable to many lyrics sites

Included Lyrics Sites

• A-Z Lyrics
• Genius
• MusixMatch
• [your contribution here]

Maven Setup

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

<dependency>
	   <groupId>com.github.jagrosh</groupId>
	   <artifactId>JLyrics</artifactId>
	   <version>master-SNAPSHOT</version>
</dependency>