Nutella Peanut-Butter Marshmallow


    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';
    /* * * DON'T EDIT BELOW THIS LINE * * */
    (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


    npm i soundplayer-widget

    DownloadsWeekly Downloads






    Last publish


    • dmitri