https://github.com/nok/soundcloud-processing
[unmaintained] Library to use the SoundCloud API in Processing.
https://github.com/nok/soundcloud-processing
Last synced: about 1 year ago
JSON representation
[unmaintained] Library to use the SoundCloud API in Processing.
- Host: GitHub
- URL: https://github.com/nok/soundcloud-processing
- Owner: nok
- License: mit
- Created: 2014-11-22T16:21:58.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2015-02-05T15:35:36.000Z (over 11 years ago)
- Last Synced: 2025-03-31T13:37:43.291Z (about 1 year ago)
- Language: CSS
- Homepage:
- Size: 5.59 MB
- Stars: 8
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-processing - SoundCloud - by [Darius Morawiec](http://nok.onl/) (Libraries / Contributions)
README
# SoundCloud for Processing
Library to use the [SoundCloud API](https://developers.soundcloud.com/docs/api/guide) in [Processing](http://processing.org/).
## Table of Contents
- [Download](#download)
- [Installation](#installation)
- [Dependencies](#dependencies)
- [Tested](#tested)
- [Usage](#usage)
- [Questions?](#questions)
- [License](#license)
## Download
- [SoundCloud for Processing](download/SoundCloud.zip?raw=true)
## Installation
Unzip and put the extracted *SoundCloud* folder into the libraries folder of your Processing sketches. Reference and examples are included in the *SoundCloud* folder. For more help read the [tutorial](http://www.learningprocessing.com/tutorials/libraries/) by [Daniel Shiffman](https://github.com/shiffman).
## Dependencies
- [SoundCloud Java library](https://github.com/nok/soundcloud-java-library) (It's included internally.) [](https://travis-ci.org/nok/soundcloud-java-library)
## Tested
System:
- **OSX** (*Mac OS X 10.7 and higher - tested with Mac OS X 10.10 Yosemite*)
- **Windows** (*not tested yet, but x86 and x64 should work*) (*Windows 7 and 8*)
Processing version:
- **2.2.1**
## Usage
I recommend to use the library with [Minim](http://code.compartmental.net/tools/minim/) ([GitHub](https://github.com/ddf/Minim)). It uses JavaSound to provide an easy-to-use audio library while still providing flexibility for more advanced users.
```java
import de.voidplus.soundcloud.*;
import ddf.minim.*;
SoundCloud soundcloud;
Minim minim;
AudioPlayer player;
void setup(){
// http://soundcloud.com/you/apps for APP_CLIENT_ID and APP_CLIENT_SECRET
soundcloud = new SoundCloud("APP_CLIENT_ID", "APP_CLIENT_SECRET");
// If you need any permissions:
// soundcloud.login("LOGIN_NAME", "LOGIN_PASS");
// show user details
User me = soundcloud.get("me");
println(me);
// play the first track of search
ArrayList result = soundcloud.findTrack("Chromatics");
if(result!=null){
println("Tracks: "+result.size());
minim = new Minim(this);
player = minim.loadFile(result.get(0).getStreamUrl());
player.play();
}
minim = new Minim(this);
}
void draw(){}
void stop(){
player.close();
minim.stop();
}
```
## Questions?
Don't be shy and feel free to contact me on Twitter: [@darius_morawiec](https://twitter.com/darius_morawiec)
## License
[MIT License by SoundCloud](https://raw.github.com/soundcloud/java-api-wrapper/master/LICENSE). The library is Open Source Software released under the [MIT License](MIT-LICENSE.txt).