https://github.com/sumanthratna/soundcloud9000
A terminal client for https://soundcloud.com.
https://github.com/sumanthratna/soundcloud9000
soundcloud soundcloud-client soundcloud-player terminal-based terminal-client
Last synced: 5 months ago
JSON representation
A terminal client for https://soundcloud.com.
- Host: GitHub
- URL: https://github.com/sumanthratna/soundcloud9000
- Owner: sumanthratna
- License: mit
- Fork: true (grobie/soundcloud2000)
- Created: 2019-04-28T17:06:03.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-22T04:19:33.000Z (almost 2 years ago)
- Last Synced: 2025-01-01T09:34:43.032Z (6 months ago)
- Topics: soundcloud, soundcloud-client, soundcloud-player, terminal-based, terminal-client
- Language: Ruby
- Homepage: https://rubygems.org/gems/soundcloud9000
- Size: 289 KB
- Stars: 117
- Watchers: 3
- Forks: 6
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# soundcloud9000
[](https://app.codacy.com/app/sumanthratna/soundcloud9000?utm_source=github.com&utm_medium=referral&utm_content=sumanthratna/soundcloud9000&utm_campaign=Badge_Grade_Dashboard)
[](https://badge.fury.io/rb/soundcloud9000)
[](https://travis-ci.com/sumanthratna/soundcloud9000)
The next generation SoundCloud client. Without all these stupid CSS files. Runs on macOS and Linux.
This hack was originally built at the [Music Hack Day Stockholm 2013](http://stockholm.musichackday.org/2013).
## The Difference Between `soundcloud2000` and `soundcloud9000`
The original software, soundcloud2000, is no longer maintained, and so I've picked it back up so I can add new features.
## Requirements
- Ruby
- `ruby 2.5.3` on Ubuntu 18.04 (bionic), Ubuntu 16.04 (xenial), Ubuntu 14.04 (trusty), and macOS 10.13.6
- `ruby 2.6.6` on Ubuntu 18.04 (bionic), Ubuntu 16.04 (xenial), Ubuntu 14.04 (trusty), and macOS 10.13.6
- `ruby 2.6.3p62` on macOS 10.15.5 Beta
- Portaudio (19)
- Mpg123 (1.14)
## Legal
See [this comment](https://github.com/grobie/soundcloud2000/issues/93#issuecomment-233182516).
> \[The] stream needs to be downloaded, which is already against the ToS of SoundCloud. So just by using \[this], you are breaking the law.
## Installation
Assuming you have Ruby/RubyGems installed, you need `portaudio` and `mpg123` installed as libraries to compile the native extensions.
### macOS
```bash
xcode-select --install
brew install portaudio
brew install mpg123
gem install soundcloud9000
```
If you ever encounter a problem with `audite` being `require`d, run:
```bash
gem uninstall audite
gem install --user audite -- --with-ldflags="-lmpg123"
```
See [this comment](https://github.com/grobie/soundcloud2000/issues/96#issuecomment-341915328) for more information.
### Debian / Ubuntu
```bash
apt-get install portaudio19-dev libmpg123-dev libncurses-dev ruby-dev
gem install soundcloud9000
```
## Usage
In order to use soundcloud9000, you need to [acquire a client credential for your application](https://stackoverflow.com/a/43962626/7127932). 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:
```bash
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
- sorting tracks
- custom configuration file
- live lyrics (don't get your hopes up for this one)
## Authors
- [Matthias Georgi](https://github.com/georgi) ([@mgeorgi](https://twitter.com/mgeorgi))
- [Tobias Schmidt](https://github.com/grobie) ([@dagrobie](https://twitter.com/dagrobie))
## Contributors
- [Travis Thieman](https://github.com/tthieman) ([@tthieman](https://twitter.com/thieman))
- [Sean Lewis](https://github.com/sophisticasean) ([@FricSean](https://twitter.com/fricsean))
## Current Maintainer
- [Sumanth Ratna](https://github.com/sumanthratna) ([@sumanthratna](https://twitter.com/sumanthratna))