# genius-lyrics

> Fetches Lyrics from Genius at Ease.

Latest version **4.4.7** (published 2024-04-04) · MIT license · 0 weekly downloads

## Install

```sh
npm install genius-lyrics
pnpm add genius-lyrics
yarn add genius-lyrics
bun add genius-lyrics
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 4.4.7 |
| Published | 2024-04-04 |
| First published | 2019-11-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 68.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 69 |
| Author | ZYROUGE |
| Maintainers | zyrouge |
| Keywords | lyrics, genius, genius-lyrics, lyrics-api, discord-lyrics, lyrics-genius, genius-parser |

## Links

- npm: https://www.npmjs.com/package/genius-lyrics
- Repository: https://github.com/zyrouge/node-genius-lyrics
- Homepage: https://genius-lyrics.js.org
- Issues: https://github.com/zyrouge/node-genius-lyrics/issues
- npm.io page: https://npm.io/package/genius-lyrics

## Dependencies (2)

- [undici](https://npm.io/package/undici.md) ^6.11.1
- [node-html-parser](https://npm.io/package/node-html-parser.md) ^6.1.13

## Recent versions

- 4.4.7 (latest) — 2024-04-04
- 4.4.6 — 2023-09-11
- 4.4.5 — 2023-09-11
- 4.4.4 — 2023-09-07
- 4.4.3 — 2023-02-12
- 4.4.2 — 2022-12-16
- 4.4.1 — 2022-12-15
- 4.4.0 — 2022-08-12
- 4.3.8 — 2022-04-27
- 4.3.7 — 2022-04-27
- 4.3.6 — 2022-03-19
- 4.3.5 — 2021-12-10
- 4.3.4 — 2021-10-25
- 4.3.3 — 2021-10-25
- 4.3.2 — 2021-10-25
- … 29 more at https://npm.io/package/genius-lyrics/versions

## README

<h1 align="center">Genius Lyrics 🎵</h1>

[![npm](https://img.shields.io/npm/v/genius-lyrics)](https://npmjs.com/package/genius-lyrics)
[![npm](https://img.shields.io/npm/dw/genius-lyrics)](https://npmjs.com/package/genius-lyrics)
[![npm](https://img.shields.io/npm/l/genius-lyrics)](https://npmjs.com/package/genius-lyrics)
[![Documentation](https://github.com/zyrouge/node-genius-lyrics/actions/workflows/docs.yml/badge.svg?branch=master)](https://github.com/zyrouge/node-genius-lyrics/actions/workflows/docs.yml)

## 🤔 Whats is this?

Just a simple lyrics fetcher that uses [Genius](https://genius.com). This also has official API implementations.

## 💻 Installation

```
npm install genius-lyrics
```

## ⚙️ Usage

```js
const Genius = require("genius-lyrics");
const Client = new Genius.Client("top-secret-optional-key");
```

## 📎 Links

-   [Documentation](https://genius-lyrics.js.org/)
-   [NPM](https://npmjs.com/genius-lyrics)
-   [GitHub](https://github.com/zyrouge/node-genius-lyrics)

## ✏️ Examples

### Requiring

**JavaScript**

```js
const Genius = require("genius-lyrics");
const Client = new Genius.Client("top-secret-optional-key"); // Scrapes if no key is provided
```

**TypeScript**

```ts
import Genius from "genius-lyrics";
const Client = new Genius.Client("top-secret-optional-key"); // Scrapes if no key is provided
```

### Fetching a Song and Lyrics

```js
const searches = await Client.songs.search("faded");

// Pick first one
const firstSong = searches[0];
console.log("About the Song:\n", firstSong, "\n");

// Ok lets get the lyrics
const lyrics = await firstSong.lyrics();
console.log("Lyrics of the Song:\n", lyrics, "\n");
```

### Fetching an Artist

```js
const artist = await Client.artists.get(456537);
console.log("About the Artist:\n", artist, "\n");
```

<br>

---
_Source: https://npm.io/package/genius-lyrics · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._