grobie / soundcloud2000

A terminal client for https://soundcloud.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

soundcloud2000

The next generation SoundCloud client. Without all these stupid CSS files. Runs on OSX and Linux.

Screen Shot 2013-01-20 at 15 37 03 Screen Shot 2013-01-20 at 15 37 54

This hack was built at the Music Hack Day Stockholm 2013.

Requirements

  • Ruby (1.9)
  • Portaudio (19)
  • Mpg123 (1.14)

Installation

Assuming you have Ruby/Rubygems installed, you need portaudio and mpg123 as library to compile the native extensions.

OSX

xcode-select --install
brew install portaudio
brew install mpg123
gem install soundcloud2000

Debian / Ubuntu

apt-get install portaudio19-dev libmpg123-dev libncurses-dev ruby1.9.1-dev
gem install soundcloud2000

Usage

In order to use soundcloud2000, you need to acquire a client credential for your application. soundcloud2000 expects a valid client id to be set in the SC_CLIENT_ID environment variable.

You can either set this up in your .bashrc or equivalent or you can specify it on the command line:

SC_CLIENT_ID=YOUR_CLIENT_ID soundcloud2000

Features

  • stream SoundCloud tracks in your terminal (enter)
  • scroll through sound lists (down / up)
  • play / pause support (space)
  • forward / rewind support (right / left)
  • play tracks of different users (u)
  • play favorites from a user (f)
  • play sets/playlists from a user (s)
  • level meter

Planned

  • play any streams, sets or sounds
  • better browsing between users and sound lists

Authors

Contributors

About

A terminal client for https://soundcloud.com

License:MIT License


Languages

Language:Ruby 99.5%Language:Shell 0.5%