node-spotify-downloader

A community driven CLI and GUI solution to download music from Spotify

Download entire Spotify playlists, albums or tracks (directly from Spotify at 160kbps) to your local machine.

Features

ID3 tags
Album art image
Download entire library
Custom folder hierarchy

Known problems

ID3 tags don't work with Unicode characters
Not possible to download 320kbps (limitation of Spotify Web)

Prerequisites

Install NodeJS (v4.4.4 LTS) if you haven't already. (NodeJS Downloads)
Download this repository as a .zip archive
Unpack the contents to a folder of your choice
Run npm install from a commandline

CLI Usage

Usage: node main.js [options]

Options:

    -h, --help                   output usage information
    -V, --version                output the version number
    -u, --username [username]    Spotify Username (required)
    -p, --password [password]    Spotify Password (required)
    -i, --uri 	   [URI / URL]   Spotify URI / URL for playlist, album or track - another valid input for this is "library"
    -d, --directory [directory]  Download Directory - Default: "download" folder within the same directory
    -f, --folder                 Create a sub-directory for playlist / album / library or specify folder hierarchy format

So

If you wanted to download the playlist "Top 100 Hip-Hop Tracks on Spotify", you would use the following command:

node main.js -u yourusername -p yourpassword -i spotify:user:spotify:playlist:06KmJWiQhL0XiV6QQAHsmw
OR
node main.js -u yourusername -p yourpassword -i https://play.spotify.com/user/spotify/playlist/06KmJWiQhL0XiV6QQAHsmw

If you wanted to download the album "Epiphany", you would use the following command:

node main.js -u yourusername -p yourpassword -i spotify:album:44Z1ZEmOyois0QoAgfUxrD
OR
node main.js -u yourusername -p yourpassword -i https://play.spotify.com/album/44Z1ZEmOyois0QoAgfUxrD

If you wanted to download the track "2Pac I Get Around", you would use the following command:

node main.js -u yourusername -p yourpassword -i spotify:track:74kHlIr01X459gqsSdNilW
OR
node main.js -u yourusername -p yourpassword -i https://play.spotify.com/track/74kHlIr01X459gqsSdNilW

If you pass -f flag without specifying a file path template, it will save the songs inside a folder with the name of the album/playlist, or inside a Library folder in case you are downloading all saved songs (-i library).

If you want to specify a path template, the following tokens are available:

{track.name}
{track.number}
{artist.name}
{album.name}
{album.year}
{user} (user name used for downloading)
{id} (ID of what is being downloaded)
{b64uri} (Spotify URI to be downloaded, base64 encoded)

In case of playlists and library, these tokens are also available:

{playlist.name} ("Library" in case of library download)
{playlist.trackCount} (the total number of tracks in the playlist or library)
{playlist.user} (owner of the playlist)
{index} (the index of the track in the playlist or library, not in the album it belogs to)

To get the ID of a track, album, artist or playlist, use the respective .id attribute ({track.id}, {album.id}, {artist.id}, or {playlist.id}).
The same thing applies to the .b64uri attribute, which return a base64 version of the resource's URI.

e.g. -f "{artist.name}/{album.name} [{album.year}]/{track.name}" will result in: Rammstein/Mutter [2001]/Sonne.mp3

e.g. -f "{playlist.name}/{index} - {artist.name} - {track.name}" for a playlist: will result in My playlist/18 - The Artist - The Song.mp3

e.g. -f "{artist.name} - {album.name} [{album.year}]/{track.number} - {artist.name} - {track.name}" for an album: will result in The Artist - The Album [2015]/18 - The Artist - The Song.mp3

Passing -f legacy will result in the format: {artist.name}/{album.name} [{album.year}]/{artist.name} - {track.name}

To run it from a Web browser

To open in browser, just run from terminal/cmd file run.sh/run.bat (depends of your OS) this file will install all needed modules an start a local server (address will be displayed in terminal, by default is http://localhost:3001). Just open this address in your browser and ... enjoy :)

Disclaimer

Don't use it ( ͡° ͜ʖ ͡°)

vmirage/node-spotify-downloader