0.4.2 • Public • Published

 Embeddable SoundCloud Players

npm version Dependency Status Download Count

The proof of concept in building of component-based, high-quality embeddable widgets. Under the hood Soundplayer Widget consists of deku.js for components and soundcloud-audio.js for HTML5 Audio API.


Manual Setup

I. Register for an app and get SoundCloud API clientId at

II. Include the script into your html page:

var sb_soundplayer_client_id = 'YOUR_CLIENT_ID';
(function(d, s, id) {
    if (d.getElementById(id)) return;
    var fjs = d.getElementsByTagName(s)[0],
        js = fjs.parentNode.insertBefore(d.createElement(s), fjs); = id;
    js.src = '//';
})(document, 'script', 'sb-soundplayer-widget-sdk');

III. Insert widget into the place where you want it to be shown on the page with necessary SoundCloud track or playlist link in data-url:

<div data-url="" class="sb-soundplayer-widget"></div>

IV. Enjoy! 😎 🎆 💃

Soundplayer Widget is also available on npm:
npm install soundplayer-widget --save

Why Deku and not React?!

Article on this topic (and about the whole process of development) is coming soon..

Browser support

Dependency on Deku which (due to its' tiny size) doesn't support legacy browsers. It means that SoundPlayer has the same range of supported browsers.

Chrome Firefox IE Safari
39+ ✔ 34+ ✔ 10+ ✔ 7+ ✔

To Do

  • playlists support
  • support for multiple different style layouts
  • global SDK object (for purposes like subscribe to audio events etc.)

Have a suggestion?

MIT Licensed


DownloadsWeekly Downloads






Last publish


  • dmitri