soundcloud9000

Gem Version

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

Screen Shot 2019-04-28 at 20 42 40

Screen Shot 2019-05-26 at 13 37 32

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

What's the Difference?

The original software, soundcloud2000, is no longer maintained, and so I've picked it back up so I can add new features.

Requirements

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

See this comment.

Installation

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

macOS

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

If you ever encounter a problem with audite being required, run:

gem uninstall audite
gem install --user audite -- --with-ldflags="-lmpg123"

See this comment for more information.

Debian / Ubuntu

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

Usage

In order to use soundcloud9000, you need to acquire a client credential for your application. soundcloud9000 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 soundcloud9000

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
  • play songs in random order (m)
  • no advertisements
  • live help (h)

Planned

  • custom configuration file
  • sorting tracks
  • favoriting tracks
  • play any streams, sets or sounds
  • better browsing between users and sound lists
  • live lyrics (don't get your hopes up for this one)

Authors

Contributors

Current Maintainer