Music Downloader

Command line tool to download mp3 files with metadata! All information, including album arts, are fetched from iTunes. Youtube is used to download the music. The correct result from Youtube is matched on the first result of iTunes based on the time in milliseconds. Make sure to get your free Youtube Data API token from the Google Developer Console.

Installation & basic usage

# Install it on your system.
$ npm install mp3-downloader -g

# You will need a Youtube token to start because this tool uses
# the API instead of a scraper. This way it shouldn't be updated
# whenever the site changes. You can get your free Youtube Data
# API token via the google developer console
# https://console.developers.google.com
$ mp3 --token "XYZ" --save-token

# From now on, download music as much as you want. If no output
# location is provided, your current working directory will be used.
$ mp3 "Byte Martin Garrix" --output "~/Desktop"

# You can override the token if you have to.
$ mp3 "Byte Martin Garrix" --token "ABC"

# It's also possible to limit the number of results to check when
# connecting to the Youtube API.
$ mp3 "Byte Martin Garrix" --results 25

# For more info, check the help.
$ mp3 --help

All options

-h, --help               output usage information
-V, --version            output the version number
-d, --debug              Enable debug mode
-b, --bulk [file]        Bulk file, one query per line
-f, --force [url]        Youtube url to use
-c, --country [country]  Specify which country of the iTunes store to search
-o, --output [output]    Output directory
-t, --token [token]      Youtube authentication token
-r, --results [results]  Max results to check
-s, --save-token         Store the Youtube authentication token for future use