soundcloudr

An express soundcloud downloader module

Prerequisites

• Node.js > 0.10.x or iojs > 1.0.4
• NPM
• A Soundcloud client id - can be obtained here

Installation

In your project root do:

npm install soundcloudr --production --save

Reference

setClientId(clientId)

Sets the Soundcloud client id for the session.

getStreamUrl(url, callback)

Given a valid Soundcloud track url, this will give the direct stream url for that track.

download(url, res, callback)

Given a valid Soundcloud track url, this will download the direct stream url and pipe it to the Express response object causing a download of the track to happen in the browser.

Usage

Without Express

var soundcloudr = require('soundcloudr');
var fs = require('fs');
 
soundcloudr.setClientId(fs.readFile('clientId.txt', 'UTF-8'));
 
soundcloudr.getStreamUrl('https://soundcloud.com/madeon/pay-no-mind', function(err, url) {
    if(err) {
        return console.log(err.message);
    }
    // Do something with the stream url
    console.log('My stream URL is: ' + url);
});

With Express

var express = require('express');
var app = express();
var soundcloudr = require('soundcloudr');
var fs = require('fs');
 
soundcloudr.setClientId(fs.readFile('clientId.txt', 'UTF-8'));
 
app.get('/download', function(req, res, next) {
    var url = req.query.url;
 
    soundcloudr.download(url, response, function(err) {
        if(err) {
            res.status(err.status).json({
                message: err.message
            });
        }
    });
});

Disclaimer

This library should not be used to infringe copyright, only download music that is free to download or is licensed in such a way that downloading will not infringe copyright.

License

Licensed under the MIT license