| 1 | <p align="center">
|
| 2 | <img width="400" alt="typescript-starter dark logo" src="https://user-images.githubusercontent.com/16015833/103463862-d9ee3200-4d2f-11eb-96d2-e02f5a5c9637.png" style="max-width:100%;">
|
| 3 |
|
| 4 | <h2 align="center">
|
| 5 | Unofficial YouTube Music API for Node.js
|
| 6 | </h2>
|
| 7 |
|
| 8 | <p align="center">
|
| 9 | <a href="https://www.npmjs.com/package/node-youtube-music">
|
| 10 | <img src="https://img.shields.io/npm/v/node-youtube-music.svg" alt="version" />
|
| 11 | </a>
|
| 12 | <a href="https://npmjs.org/package/node-youtube-music">
|
| 13 | <img src="https://img.shields.io/npm/dm/node-youtube-music.svg" alt="downloads" />
|
| 14 | </a>
|
| 15 | <a href="https://packagephobia.now.sh/result?p=node-youtube-music">
|
| 16 | <img src="https://packagephobia.now.sh/badge?p=node-youtube-music" alt="install size" />
|
| 17 | </a>
|
| 18 | </p>
|
| 19 |
|
| 20 |
|
| 21 | ## Features
|
| 22 |
|
| 23 | - [x] Search
|
| 24 | - [x] Musics
|
| 25 | - [x] Playlists
|
| 26 | - [x] Albums
|
| 27 | - [x] Artists
|
| 28 | - [x] List musics from playlist
|
| 29 | - [x] List musics from album
|
| 30 | - [x] List albums from artist
|
| 31 | - [x] List musics from artist
|
| 32 | - [x] Get suggestions from music
|
| 33 | - [ ] Playlist management (create, push, remove)
|
| 34 | - [ ] Library management
|
| 35 |
|
| 36 | ## Get started
|
| 37 |
|
| 38 | ```shell
|
| 39 | npm install node-youtube-music
|
| 40 | ```
|
| 41 |
|
| 42 | or
|
| 43 |
|
| 44 | ```shell
|
| 45 | yarn add node-youtube-music
|
| 46 | ```
|
| 47 |
|
| 48 | ## How to use
|
| 49 |
|
| 50 | ```ts
|
| 51 | import * as ytMusic from 'node-youtube-music';
|
| 52 |
|
| 53 | const musics = await ytMusic.searchMusics('Never gonna give you up');
|
| 54 |
|
| 55 | const suggestions = ytMusic.getSuggestions(musics[0].youtubeId);
|
| 56 | ```
|