Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Official SoundCloud Javascript SDK
CoffeeScript Shell CSS JavaScript

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
examples
src
test
vendor
.gitignore
.gitmodules
LICENSE
Makefile
README.md
package.json
sdk.js

README.md

SoundCloud JavaScript SDk

Introduction

The SoundCloud JavaScript SDK lets you easily integrate SoundCloud into your website or web app. It's full documentation can be found here. In most case it's highly recommended that you use the hosted version from http://connect.soundcloud.com/sdk.js in your website. This README provides development related informations.

Dependencies

  • npm
  • - coffee-script
  • - uglify-js
  • - jslint

Usage

To checkout the repository locally and to initialize all submodules in vendor run:

$ git clone git@github.com:soundcloud/soundcloud-javascript.git
$ cd soundcloud-javascript
$ git submodule update --init
$ npm install

To build the release version in build/ just run:

$ make build

To run the tests or use the sdk.js you can run bin/server in either ./ or in ./build. The sdk.js in ./ will automatically compile all the coffeescripts in ./src on the fly when loaded. To make the sdk.js fully work it needs to be accessed via http://connect.soundcloud.dev instead of http://localhost:9090

Testing

To run the tests just start an HTTP server (for example "$ ponyhost server") in the project root and navigate to http://yourhost/test/test.html. In development mode the tests will automatically compile the coffeescript on each reload. In build mode the tests will laod the compiled sdk.js.

Repository Structure

  • build/ will provide the compiled CoffeeScript as it's hosted on http://connect.soundcloud.com
  • src/ the coffee script source code
  • vendor/ includes git submodules of external projects
  • test/ tests
  • examples/ examples
Something went wrong with that request. Please try again.