Unofficial Encyclopedia Metallum API
Unfortunately http://www.metal-archives.com/ does not provide any API whats so ever, this library exists. Because Encyclopedia Metallum is still the best website to get correct and complete information about any metal band on earth.
Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request :D
Build
Just build it with maven
mvn clean install
Howto
Maven
<dependency>
<groupId>com.github.loki-afro</groupId>
<artifactId>metalarchives-api</artifactId>
<version>1.2.0</version>
</dependency>
Gradle
compile 'com.github.loki-afro:metalarchives-api:1.2.0'
Usage
public class APIExample {
// unit tests are full of examples
private void bandExample() {
// just using the search
BandQuery query = BandQuery.builder()
.country(Country.DE)
.statuses(Sets.newHashSet(BandStatus.SPLIT_UP, BandStatus.ON_HOLD))
.build();
for (SearchBandResult result : API.getBands(query)) {
System.out.println("BandName" + result.getName());
System.out.println("BandId" + result.getId());
}
// or if you wanna go all in: search and load all bands by name
BandQuery query2 = BandQuery.byName("Slayer", true);
for (final Band fullBand : API.getBandsFully(query2)) {
System.out.println("Bandname: " + fullBand.getName());
System.out.println("Bandgenre: " + fullBand.getGenre());
System.out.println("Bandstatus: " + fullBand.getStatus());
System.out.println("Partial Discs: " + fullBand.getDiscsPartial());
// or if you want the discs with all details
System.out.println("Discs: " + fullBand.getDiscs());
System.out.println("---");
}
// get by id
Band band = API.getBandById(666L);
System.out.println(band.getCountry());
}
public void discExample() {
// same with band we can do the default operations like searching and getting a single disc by its id
Disc disc = API.getDiscById(845L);
for (Track track : disc.getTrackList()) {
System.out.println("name " + track.getPlayTime());
System.out.println("playtime " + track.getPlayTime());
System.out.println("lyrics " + track.getLyrics().orElse(""));
// ...
}
DiscQuery query = DiscQuery.builder()
.name("Hordanes Land")
.discType(DiscType.EP)
.build();
// enforces that you get only one result, if there are more than one an exception will be thrown
final Disc singleDisc = API.getSingleUniqueDisc(query);
// or you might be interested in reviews? or artworks?
DiscQuery query2 = DiscQuery.builder()
.name("The Wretched Spawn")
.build();
for (Disc discResult : API.getDiscsFully(query2)) {
System.out.println(convertToAsciiArtNotIncluded(discResult.getArtwork()));
for (Review review : discResult.getReviews()) {
System.out.println(review.getAuthor());
System.out.println(review.getDate());
System.out.println(review.getContent());
System.out.println(review.getPercent());
// ...
}
}
}
public void trackExample() {
// this query results, as of January 2021 to one result
TrackQuery query = TrackQuery.builder()
.name("Fatal Self-Inflicted Disfigurement")
.exactNameMatch(true)
.discType(DiscType.FULL_LENGTH)
.build();
for (SearchTrackResult track : API.getTracks(query)) {
System.out.println(track.getLyrics().orElse(""));
}
}
}
Background
I wrote this library almost 15 years a ago, used it to tag my music library. (that tagger is not available and was just a huge hack) Later it was used in an Android App to have a mobile version of the original site.
It was used for some papers to analyzed lyrics Several music players back in the day displayed some information by using this api
License
"THE BEER-WARE LICENSE" (Revision 42):
Phillip Wirth<schaum@kaffeekrone.de> wrote this file.
As long as you retain this notice you can do whatever you want with this stuff.
If we meet some day, and you think this stuff is worth it, you can buy me a non alcohol-free in return.
Phillip Wirth