# VK Music Downloader

A very simple tool to download music through VKontakte Music API.

This a proof of concept.

Inspired by [DatMusic](https://github.com/alashow/datmusic-api), [MyFreeMp3](https://myfreemp3cc.com/)

## Features

*For now*

* Scrape Spotify playlist page
* Download all the titles from MyFreeMp3 aka VK Music
* Generate a .m3u8 playlist file

*TODO*

* Dowload all songs in a folder
* Add Spotify metadatas in the m3u8 file
* Add proper command line options
* Rewrite this as a plugin for Ampache
* Rewrite this as a plugin for Funkwhale
* Add MusicBrain ID3Tag on file

## Goals

* Try to use state of art NodeJS APIs
* Demonstrate what we can do with 100 lines of Javascript (and an
  infinity of dependencies, HALF OF THE WORLD LITERALY)

## Usage

1. Install nodejs/npm
1. `npx vk-music-dl https://open.spotify.com/playlist/6LgeEhc97Azxq6sinJQt6w`

## Usage as library

```javascript
const {main} = require('vk-music-dl/lib');

main('https://open.spotify.com/playlist/6LgeEhc97Azxq6sinJQt6w');
```