https://github.com/asone/soundcloud_streamcaster
a set of 2 ruby files to facilitate routine for backupping availables song streams from soundcloud
https://github.com/asone/soundcloud_streamcaster
Last synced: 9 days ago
JSON representation
a set of 2 ruby files to facilitate routine for backupping availables song streams from soundcloud
- Host: GitHub
- URL: https://github.com/asone/soundcloud_streamcaster
- Owner: Asone
- Created: 2014-09-08T13:18:29.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2014-09-08T15:42:09.000Z (almost 12 years ago)
- Last Synced: 2025-10-16T19:19:41.774Z (9 months ago)
- Language: Ruby
- Homepage:
- Size: 176 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
SoundCloud_StreamCaster
=========
SoundCloud_StreamCaster is a set of 2 small ruby scripts in order to download favorites from soundcloud.
- db_routine.rb : retrieves list of last favorites and stores it into db.json file
- sc_downloader.rb : reads the db.json file and stores streams to local storage
Requirements
---
In order to use SoundCloud_StreamCaster you will need an access to the API. You can register tokens [here](http://soundcloud.com/you/apps/new). Once done you'll just have to copy-paste your tokens into the config.yml file
Install & Use
---
The scripts have been built with ruby-2.1.2 . There's no warranty that the scripts will run on other version of ruby.
You will also need to install taglib before install its ruby dependencies :
**linux : **
```apt-get install taglib```
** homebrew : **
```brew install taglib```
** ruby dependencies : **
```sh
gem install soundcloud
gem install json
gem install taglib-ruby
gem install fileutils
```
**clone the repo :**
```sh
git clone git@github.com:Asone/SoundCloud_StreamCaster.git
```
*** configure it ***
edit & rename the config.sample.yml to config.yml.
- :dest: represents destination of files
- :max_db: represents maximum favs appending at once on the db.json file
- :max_per_cycle: number of songs to download on a call
tip : max_db can't retrieve more thant 200 favs at once due to soundcloud restrictions.
** make it a routine **
You might want to create routines invoking the scripts. In order to do so it is recommended you use RVM. If you don't know how to do that here's some useful documentation :
- Linux : [Create routines with Cron and RVM](http://rvm.io/integration/cron)
- Mac OS : [Create routines with launchd and RVM](http://notes.jerzygangi.com/creating-a-ruby-launchd-task-with-rvm-in-os-x/)
- Windows : Suck it up, i don't know how to do that and i don't care
Version
----
0.1
Is this legal ?
-----------
SoundCloud_StreamCaster should be considered as having a normal behavior regarding the [user licence](https://soundcloud.com/terms-of-use#grant-of-licence) and [developper](https://developers.soundcloud.com/docs/api/terms-of-use#privacy) licence if the script is used for personal purpose only.
The script only downloads the songs available as streams so it does not override any particular protection.
If it appears that those scripts break any rule of the licences, please feel free to [contact me](mailto:asone@akbarworld.info)
License
----
This software is free and released under GPL v3 licence. Please [read the licence](http://opensource.org/licenses/GPL-3.0) for more information