Skip to content

Jense5/mp3-downloader

Repository files navigation

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

JS.ORG Logo

About

Command line tool to download mp3 files with metadata

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •