genius_lyrics

Description:

genius lyrics

genius_lyrics: a Dart client for the Genius.com API based on LyricsGenius #
genius_lyrics provides a simple interface to the song, artist, and lyrics data stored on Genius.com.
Read the API reference here.
Setup #
Before using this package you'll need to sign up for a (free) account that authorizes access to the Genius API. The Genius account provides a accessToken that is required by the package. See the Usage section below for examples.
Usage #
Import the package and initiate Genius:
import 'package:genius_lyrics/genius_lyrics.dart';
Genius genius = Genius(accessToken: YOUR_TOKEN);
copied to clipboard
Search for songs by a given artist:
Artist? artist = await genius.searchArtist(artistName: 'Eminem', maxSongs: 5, sort: SongsSorting.release_date);
if (artist != null) {
for (var song in artist.songs) {
print(song.title);
}
}
copied to clipboard
By default, the searchArtist() only returns songs where the given artist is the primary artist.
However, there may be instances where it is desirable to get all of the songs that the artist appears on.
You can do this by setting the includeFeatures argument to true.
Artist? artist = await genius.searchArtist(artistName: 'Eminem', maxSongs: 5, includeFeatures: true);
if (artist != null) {
for (var song in artist.songs) {
print(song.title);
}
}
copied to clipboard
Search for a single song by the same artist:
artist?.song(client: genius, songName: "No Love");
# or:
# Song? song = genius.searchSong(artist: 'Eminem', title: 'No Love'));
if (song != null) {
print(song.lyrics);
}
copied to clipboard
Add the song to the artist object:
artist?.addSong(newSong: song!);
copied to clipboard
Save the artist's songs to a file:
artist?.saveLyrics(destPath: 'D:/Music/Eminme/Lyrics');
copied to clipboard
Searching for an album and saving it:
Album? album = (await genius.searchAlbum(name: 'The Off-Season', artist: 'J.Cole'));
album?.saveLyrics(destPath: 'D:/Desktop/test');
copied to clipboard
A complete example #
import 'package:genius_lyrics/genius_lyrics.dart';

void main(List<String> args) async {
Genius genius = Genius(accessToken: YOUR_TOKEN);

Artist? artist = await genius.searchArtist(artistName: 'Eminem', maxSongs: 5, sort: SongsSorting.release_date, includeFeatures: true);

if (artist != null) {
for (var song in artist.songs) {
print(song.title);
}
}

Album? album = (await genius.searchAlbum(name: 'The Off-Season', artist: 'J.Cole'));
album?.saveLyrics(destPath: 'D:/Desktop/test');

if (album != null) {
print(album.tracks.length);
for (var track in album.tracks) {
print(track.title);
}
}

Song? song = (await genius.searchSong(artist: 'J. Cole', title: 'KOD'));

if (song != null) {
print(song.lyrics);
}
}
copied to clipboard
Contributing #
Please contribute! If you want to fix a bug, suggest improvements, or add new features to the project, just open an issue or send me a pull request.