summaryrefslogtreecommitdiff
path: root/non-posts/soundcli.html
diff options
context:
space:
mode:
Diffstat (limited to 'non-posts/soundcli.html')
-rw-r--r--non-posts/soundcli.html68
1 files changed, 68 insertions, 0 deletions
diff --git a/non-posts/soundcli.html b/non-posts/soundcli.html
new file mode 100644
index 0000000..bf3eee9
--- /dev/null
+++ b/non-posts/soundcli.html
@@ -0,0 +1,68 @@
+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>.
+ If you are a user of <a href="http://archlinux.org">Archlinux</a>, you can install soundCLI from the
+ <a href="https://aur.archlinux.org/packages.php?ID=51472">Arch User Repository</a>. The latest development
+ snapshot is also <a href="https://aur.archlinux.org/packages.php?ID=51608">available as a package</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.
+
+TODO
+= flattr("397352/soundCLI-a-soundcloud-client-for-the-command-line")
+-->
+
+<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>