title: SoundCLI
---
<h1>
  <img src="images/soundcli-icon.png"  class="headline" />SoundCLI
</h1>
<p>
  soundCLI is a command line client for streaming music from <a href="http://soundcloud.com">SoundCloud</a>.
  Timed comments are displayed on the command line as the playback reaches their
  respective positions.
</p>

<p>
  This screenie says it all:
</p>

<img src="images/soundcli-screenie.png" alt="screenshot of a typical soundCLI session" class="full" />

<h2>Installation</h2>
<p>
  The latest stable (or stale) version of soundCLI is
  <a href="https://rubygems.org/gems/soundcli">available as a RubyGem</a>.
  Install it like this: <span class="code">gem install soundcli</span>
</p>

<p>
  You can <a href="http://github.com/rekado/soundCLI">download the source code from github</a>.
</p>

<h2>Authorization</h2>
<p>
  To access your own songs and those of other users, you have to authorise
  soundCLI first. You can either provide a password once when starting soundCLI
  for the first time or authorise the application by clicking on the button
  below. You will then be redirected to <a href="http://soundcloud.com">soundcloud.com</a>
  and receive an authorisation code. The application only needs to be
  authorised once. If ever you want to revoke access, you can simply run
  <span class="code">soundcli revoke</span> to delete the authentication
  token or delete the connection in your SoundCloud account settings. Note
  that soundCLI defaults to password authentication. Change the authentication
  type in the configuration file.
</p>

<a href="https://soundcloud.com/connect?client_id=a0f81a06bbce9c2995ef16b87eb87820&response_type=code&redirect_uri=http://soundcli.elephly.net/oauth-callback.html">
  <img src="images/larger-connect-with-sc.png" alt="connect with SoundCloud" />
</a>

<h2>Support</h2>
<p>
  Head to the <a href="https://github.com/rekado/soundCLI">github page</a> to
  get more information, or to submit bug reports and feature requests.
</p>

<p>
  If by &ldquo;support&rdquo; you actually meant <em>giving support</em>,
  then fret not! You can show your appreciation for soundCLI by clicking the Flattr link. I shall be flattered.
</p>

<a href="http://flattr.com/thing/397352/soundCLI-a-soundcloud-client-for-the-command-line">
  <img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" />
</a>


<h2>License</h2>
<p>
  soundCLI is <a href="http://www.gnu.org/philosophy/free-sw.html">free software</a> and licensed under the <a href="http://www.gnu.org/licenses/gpl.html">GNU GPL&nbsp;v3</a>.
</p>