Package com.tagtraum.ubermusic

Interface UberMusic

All Known Implementing Classes:

AcousticBrainz, Beatport, CoverartArchive, Discogs, DiscogsOffline, LastFM, OnlineDB, Wikidata

public interface UberMusic

Allows clients to find metadata about a song or music file using services like Discogs, MusicBrainz or others.

Author:

Hendrik Schreiber

Method Summary

Modifier and Type	Method	Description
default List<AudioArtist>	getArtists(AudioSong song)	Lookup artists for a song.
default List<Similarity<AudioArtist>>	getSimilarArtists(AudioSong song)	Try to find similar artists for the given song.
List<AudioSong>	lookup(AudioSong song)	Looks up metadata for a song.
default List<AudioSong>	lookup(File file)	Deprecated.
default List<AudioSong>	lookup(Path file)	Looks up metadata for a file.

Method Detail

lookup

List<AudioSong> lookup(AudioSong song)
                throws IOException

Looks up metadata for a song.

Parameters:

song - song (query by example)

Returns:

reference songs, empty list, if the metadata is unavailable

Throws:

IOException - IOException

lookup

default List<AudioSong> lookup(Path file)
                        throws IOException

Looks up metadata for a file.

Parameters:

file - audio file

Returns:

reference songs, empty list, if the metadata is unavailable

Throws:

IOException - IOException

lookup

@Deprecated
default List<AudioSong> lookup(File file)
                        throws IOException

Deprecated.

Looks up metadata for a file (old file API).

Parameters:

file - audio file

Returns:

reference songs, empty list, if the metadata is unavailable

Throws:

IOException - IOException

getSimilarArtists

default List<Similarity<AudioArtist>> getSimilarArtists(AudioSong song)
                                                 throws IOException

Try to find similar artists for the given song. The default implementation returns an empty list.

Parameters:

song - song

Returns:

list of similar artists

Throws:

IOException - IOException

getArtists

default List<AudioArtist> getArtists(AudioSong song)
                              throws IOException

Lookup artists for a song. The default implementation returns an empty list.

Parameters:

song - song

Returns:

list of similar artists that seem to match the given song

Throws:

IOException - IOException