Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mortenson/soundcloud-simple-likes

Something I made while frustrated at Soundcloud's UI for playing your likes
https://github.com/mortenson/soundcloud-simple-likes

Last synced: about 1 month ago
JSON representation

Something I made while frustrated at Soundcloud's UI for playing your likes

Awesome Lists containing this project

README 

        
# Soundcloud Simple Likes (Favorites)



I use Soundcloud a bit and have over 500 likes that are unsearchable, unsortable, and unshuffalable using the website. This got pretty frustrating, so I peeked into the API and created a simple script that loads up the current authenticated user's likes and displays them using ListJS, which handles all the complexities of sorting and searching for me. 



Here's what it looks like:



![screenshot](http://i.imgur.com/w9DAopo.png)



# Installation instructions



1. Register a new App at http://soundcloud.com/you/apps

1. Clone the repository into your webroot.

1. Edit soundcloud.html and enter your App's Client ID and the uri to soundcloud_auth.html under the `SC.initialize()` call.

1. Visit soundcloud.html and authenticate using your credentials.

1. Enjoy!



# External dependencies



I've made use of a few Javascript libraries, here's a brief breakdown of what they are and what I'm doing with them:



1. ListJS - https://github.com/javve/list.js

 * This is a library that lets you shunt data into a HTML list, which can then be displayed, sorted, and filtered. In this project ListJS is responsible for almost all of of the UI features, except shuffling.

1. cacheJS - https://github.com/hoangnd25/cacheJS

 * I've written my own caching in the past but felt lazy this time around, so I looked for something simple and lightweight and found cacheJS. Here all responses from Soundcloud are cached for one hour, which mean the initial load time in one listening session may take awhile, but if you come back to the page things should spin up rather quickly.

1. Soundcloud Javascript SDK - https://github.com/soundcloud/soundcloud-javascript

 * This library is provided by Soundcloud proper to wrap API requests for Javascript applications. I just use it for requesting favorites and controlling currently playing sounds.

1. jQuery - https://github.com/jquery/jquery

 * You know what it is. I would have actually forgone using this if the Soundcloud SDK didn't already sneak it into their distribution.



# Legal stuff



The purpose of this codebase is to be a simple example of using the Soundcloud JavaScript SDK, as well as being useful to users who are looking for a stupid-simple Soundcloud interface for sorting their likes. 



**Use this codebase at your own risk.** By entering your App's Client ID you should accept any consequences that may come as a result of using this code to stream your likes from Soundcloud.



Although this is not associated with a specific product/app, I have read through https://developers.soundcloud.com/docs/api/terms-of-use and do not believe that this is in any violation of Soundcloud's terms of use. I am in no way competing with their product and have purposefully limited the functionality of this script so that users are encouraged to continue using the primary site.