# lyrics-finder

> A Simple Lyrics Finder That Just Works!

Latest version **21.7.0** (published 2021-01-09) · MIT license · 0 weekly downloads

## Install

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

Provides the command `lyrics-finder`.

## Health

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

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 21.7.0 |
| Published | 2021-01-09 |
| First published | 2020-05-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 10.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 40 |
| Author | Rahil Kabani |
| Maintainers | alias-rahil |
| Keywords | song, lyrics, rapidapi, azlyrics, findlyrics, google, genius, musixmatch, scrape, api |

## Links

- npm: https://www.npmjs.com/package/lyrics-finder
- Repository: https://github.com/alias-rahil/lyrics-finder
- Homepage: https://github.com/alias-rahil/lyrics-finder#readme
- Issues: https://github.com/alias-rahil/lyrics-finder/issues
- npm.io page: https://npm.io/package/lyrics-finder

## Dependencies (3)

- [encoding](https://npm.io/package/encoding.md) ^0.1.13
- [node-fetch](https://npm.io/package/node-fetch.md) ^2.6.0
- [html-to-text](https://npm.io/package/html-to-text.md) ^5.1.1

## Alternatives

- [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads
- [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads
- [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads
- [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads
- [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads

## Recent versions

- 21.7.0 (latest) — 2021-01-09
- 21.4.0 — 2020-09-13
- 21.3.3 — 2020-08-29
- 21.3.2 — 2020-08-19
- 21.3.1 — 2020-08-19
- 21.3.0 — 2020-08-18
- 21.2.3 — 2020-08-14
- 21.2.2 — 2020-08-14
- 21.2.1 — 2020-08-14
- 21.2.0 — 2020-08-14
- 21.1.1 — 2020-08-09
- 21.1.0 — 2020-08-09
- 21.0.5 — 2020-07-03
- 21.0.4 — 2020-07-03
- 21.0.3 — 2020-07-03
- … 60 more at https://npm.io/package/lyrics-finder/versions

## README

<h1 align="center">Welcome to lyrics-finder 👋</h1>
<p>
  <a href="https://www.npmjs.com/package/lyrics-finder" target="_blank">
    <img alt="Version" src="https://img.shields.io/npm/v/lyrics-finder.svg">
  </a>
  <a href="https://github.com/alias-rahil/lyrics-finder/blob/master/LICENSE" target="_blank">
    <img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" />
  </a>
</p>

> A lyrics api which actually works!

> It scrapes the lyrics from [Google](https://www.google.com/) so no seperate API key is needed.

# In your code:

## Installation

```bash
npm install --save lyrics-finder
```

## Usage

```javascript
const lyricsFinder = require('lyrics-finder');
(async function(artist, title) {
    let lyrics = await lyricsFinder(artist, title) || "Not Found!";
    console.log(lyrics);
})("poets of fall", "carnival of rust");
```

# Command line usage:

## Using without installation

```bash
npx lyrics-finder "a r rahman" "kun faya kun"
```

> Note: Use this method only if you plan to use lyrics-finder for one time, installing lyrics-finder globally (see-below) is recommended for multiple time usages.

## Installation

```bash
npm install lyrics-finder -g
```

> Note: **DO NOT** use sudo to install global packages! The correct way is to tell npm where to install its global packages: `npm config set prefix ~/.local`. Make sure `~/.local/bin` is added to `PATH`.

## Usage after installation

```bash
lyrics-finder "prateek kuhad" "cold mess"
```

# Screenshot

<p align="center">
  <img align="center" src="https://raw.githubusercontent.com/alias-rahil/lyrics-finder/master/screenshots/humpty-dumpty.jpeg" alt="humpty-dumpty.jpeg">
</p>

# API

It takes two arguments, artist name and song name and returns the lyrics as a string if found, else it will return an empty string (if used in code). The CLI binary logs the lyrics on your console (stdout) if found, else it will log 'Not Found!'.

# Author

👤 **Rahil Kabani <rahil.kabani.4@gmail.com>**

# Show your support

Give a ⭐️ if this project helped you!

# 🤝 Contributing

Contributions, issues and feature requests are welcome!<br />Feel free to check [issues page](https://github.com/alias-rahil/lyrics-finder/issues).

# Lyrics-Finder

🏠 [Homepage](https://github.com/alias-rahil/lyrics-finder#readme)

# License

[MIT](https://github.com/alias-rahil/lyrics-finder/blob/master/LICENSE)

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