Youtube MP3 Downloader

Youtube MP3 Downloader is a module which allows to specify YouTube videos from which the audio data should be extracted, converted to MP3, and stored on disk.

Installation

Prerequisites

To run this project, you need to have a local installation of FFmpeg present on your system. You can download it from https://www.ffmpeg.org/download.html

Checkout the project from Github to a local folder

git clone https://github.com/tobilg/youtube-mp3-downloader.git

Install module dependencies

Navigate to the folder where you checked out the project to in your console. Run npm install.

Running

A basic usage example is the following:

var YoutubeMp3Downloader = require('youtube-mp3-downloader');

//Configure YoutubeMp3Downloader with your settings
var YD = new YoutubeMp3Downloader({
    "ffmpegPath": "/path/to/ffmpeg",        // Where is the FFmpeg binary located?
    "outputPath": "/path/to/mp3/folder",    // Where should the downloaded and encoded files be stored?
    "youtubeVideoQuality": "highest",       // What video quality should be used?
    "queueParallelism": 2,                  // How many parallel downloads/encodes should be started?
    "progressTimeout": 2000                 // How long should be the interval of the progress reports
});

//Download video and save as MP3 file
YD.download("rnkuRQ8tjIE");

YD.on("finished", function(data) {
    console.log(data);
});

YD.on("error", function(error) {
    console.log(error);
});

YD.on("progress", function(progress) {
    console.log(progress);
});

You can also pass a file name for the respective video, which will then be used. Otherwise, the file name will be derived from the video title.

YD.download("rnkuRQ8tjIE", "Nancy Sinatra - Jackson.mp3");

While downloading, every progressTimeout timeframe, there will be an progress event triggered, outputting an object like

{
    "videoId": "rnkuRQ8tjIE",
    "progress": {
        "percentage": 76.81,
        "transferred": 5619680,
        "length": "7315910",
        "remaining": 1696230,
        "eta": 3,
        "runtime": 8,
        "delta": 1834992,
        "speed": 661138.82
    }
}

Furthermore, there will be a queueSize event emitted when the queue size changes (both positive and negative). This can be caught via

YD.on("queueSize", function(size) {
    console.log(size);
});

Upon finish, the following output will be returned:

{
    "videoId": "rnkuRQ8tjIE",
    "file": "/path/to/mp3/folder/Nancy Sinatra & Lee Hazlewood - Jackson.mp3",
    "youtubeUrl": "http://www.youtube.com/watch?v=rnkuRQ8tjIE",
    "videoTitle": "Nancy Sinatra & Lee Hazlewood - Jackson",
    "artist": "Nancy Sinatra & Lee Hazlewood",
    "title": "Jackson",
    "stats": {
        "transferred": 7315910,
        "runtime": 9,
        "averageSpeed": 713747.31
    }
}