# brisingr

> "Snap" a photo of a track or album on Spotify

Latest version **1.0.1** (published 2020-04-14) · ISC license · 0 weekly downloads

## Install

```sh
npm install brisingr
pnpm add brisingr
yarn add brisingr
bun add brisingr
```

## 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 | 1.0.1 |
| Published | 2020-04-14 |
| First published | 2017-09-05 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 13.8 KB |
| Known vulnerabilities | 0 (+4 in 1 direct dependencies) |
| Install scripts | no |
| Author | Samarth Dave |
| Maintainers | rubenmoya |

## Links

- npm: https://www.npmjs.com/package/brisingr
- npm.io page: https://npm.io/package/brisingr

## Dependencies (4)

- [enquirer](https://npm.io/package/enquirer.md) ^2.3.2
- [puppeteer](https://npm.io/package/puppeteer.md) ^2.0.0
- [validator](https://npm.io/package/validator.md) ^12.1.0
- [csv-parser](https://npm.io/package/csv-parser.md) ^2.3.2

## Recent versions

- 1.0.1 (latest) — 2020-04-14
- 1.0.0 — 2017-09-05

## README

# SpotifySnap :notes:
"Snap" a photo of a track or album on Spotify

## What it does
- Downloads an image of a track based on the id
- helped fill my [100-days-of-code](https://github.com/samarthdave/100-days-of-code) repository w/ images
- generates an image like below from a given track id

![Generated Image (Middle Child)](/media/middle-child.jpg)

## Install
```
npm install --save brisingr
```

### Usage
```
npm install # see below if errors install Puppeteer
node prompt.js
# ...
# ? Is it an album or a track? ... track
# ? What is the track link/id? 2JvzF1RMd7lE3KmFlsyZD8
# ... downloads MIDDLE CHILD by J Cole into media folder
```

### Tools used
- enquirer - great tool for CLIs
- Puppeteer (runs Chromium) - is it overkill? yes

#### Problems I ran into
- If puppeteer does not install, use the following command (from issue #[375](https://github.com/puppeteer/puppeteer/issues/375)):
```
sudo npm install --save puppeteer --unsafe-perm=true
# "--save" adds dependency to package.json
# "--unsafe-perm" -- https://stackoverflow.com/questions/48869749/npm-install-puppeteer-showing-permission-denied-errors/
```

#### Future features
- allow URL input & extract id
- change image dimensions
- extract song name from request
- check for 404 statuses & send back errors (try/catch)
- progress bar
- song search

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