Skip to content
This repository

Ncurses player for Soundcloud tracks in Ruby

branch: master
README.md

CloudRuby

A soundcloud player written in Ruby with Ncurses for graphical interface and mpg123 for playback.

Installation

Install mpg123, ruby 1.9.2, curses and json_pure with a package manager of your destribution.

Then install the required gems.

If you are using RVM:

  gem install curses json_pure

Without RVM you need to obtain write permissions with sudo:

  sudo gem install curses json_pure

Usage

From the terminal start with:

  cloudruby          # query the latest 100 tracks from soundcloud 
  cloudruby $search  # query the latest 100 tracks that match the $search keyword
  
  # play a soundcloud url directly
  cloudruby http://soundcloud.com/crassmix/feint-clockwork-hearts-crass

Shortcuts:

Key Description
ESC | q | Q Quit
+ | = Increase volume
- | _ Decrease volume
n | N | Up Next track
p | P | Down Previous track
m | M Toggle mute
d | D Download file
v | V About dialog
Spacebar Toggle playback

Download

With 'd' or 'D' you can download a downloadable file from soundcloud. The file will be placed inside your download directory specified with --download_dir argument or inside your ~/.cloudruby.json. If none of these are given, the current working directory is used.

A track is indicated by a [D] in the playlist if it's downloadable.

Screenshot

Screenshot showing curses user interfaceScreenshot showing customized curses user interface

Config

Cloudruby can be customized through ~/.cloudruby.json file.

Example

{
  "download_dir": "~/music",
  "curses": {
    "colors": {
      "default": ["white", "black"],
      "playlist": ["green", "black"],
      "playlist_active": ["red", "black"],
      "progress": ["cyan", "black"],
      "progress_bar": ["blue", "white"],
      "title": ["cyan"],
      "artist": ["magenta"]
    }
  }
}

There are 7 different 'colors', defined with a foreground and a background color. You can use only these colors: "black", "blue", "cyan", "green", "magenta", "red", "yellow", "white".

Author

Paul Koch [kulpae]

http://www.uraniumlane.net/users/kulpae

License

see LICENSE.

Something went wrong with that request. Please try again.