genius_lyrics 1.0.1 copy "genius_lyrics: ^1.0.1" to clipboard
genius_lyrics: ^1.0.1 copied to clipboard

Dart native package inspired by LyricsGenius Python library. genius_lyrics provides a simple interface to the song, artist, and lyrics data stored on Genius.com.

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);

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);
  }
}

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);
  }
}

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);
}

Add the song to the artist object:

artist?.addSong(newSong: song!);

Save the artist's songs to a file:

artist?.saveLyrics(destPath: 'D:/Music/Eminme/Lyrics');

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');

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);
  }
}

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.

10
likes
140
pub points
52%
popularity

Publisher

unverified uploader

Dart native package inspired by LyricsGenius Python library. genius_lyrics provides a simple interface to the song, artist, and lyrics data stored on Genius.com.

Repository (GitHub)
View/report issues

Documentation

API reference

License

MIT (LICENSE)

Dependencies

beautiful_soup_dart, http, universal_io

More

Packages that depend on genius_lyrics