From: Ben Beltran <redacted>
Date: Sat, 6 Oct 2012 06:53:00 +0000 (-0500)
Subject: Add a README
X-Git-Url: https://git.r.bdr.sh/rbdr/lyricli.rb/commitdiff_plain/1be0eee39d325c1a180dbf992bc6fd256f828008

Add a README

So y'all don't get /that/ lost
---

diff --git a/README.md b/README.md
index e69de29..a0102bc 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,62 @@
+# Lyricli #
+## The command line client for lyrics ##
+
+This is a quick introduction for Lyricli. Right now it's in really early
+stages of development, so it's lacking in a lot of stuff (mainly tests
+and documentation) ... But it generally works and here's a tutorial to
+see how to get it working.
+
+### Installing ###
+
+1. Clone this Repo
+2. `gem build lyricli.gemspec`
+3. `gem install lyricli-0.0.1.gem`
+4. Voila!
+
+### Usage ###
+
+Lyricli can be invoked with the command `lrc` and there are three basic
+ways of using it:
+
+`lrc`
+
+When you run it without arguments, it will look in the available sources
+to try to find a playing song and extract the lyrics.
+
+`lrc artist song`
+
+When you run it with arguments, it will use them to search for the
+lyrics. This won't work if you manually disable the arguments source in
+your configuration file.
+
+#### Commands ####
+
+The third way to use it is by passing it one of the following special
+commands:
+
+* `lrc -l` or `lrc --list-sources` lists the available sources.
+* `lrc -e` or `lrc --enable SOURCE` enable a source from the list.
+* `lrc -d` or `lrc --disable SOURCE` disable a source from the list.
+* `lrc -r` or `lrc --reset SOURCE` reset all configuration for a source.
+* `lrc -v` or `lrc --version` show the installed version of lyricli.
+* `lrc -h` or `lrc --help` display some help
+
+### Roadmap ###
+
+There is not much defined right now as a roadmap, but this needs to be
+done:
+
+* Specs for all the components
+* YARD documentation for all the components
+
+And the first thing I want to work on after that is done is separating
+the Lyrics Engines so we can add/remove lyrics engines in a similar way to how
+we currently add/remove sources.
+
+### Leave Feedback Please! ###
+
+If you decide to use or hack away at Lyricly, please don't forget to
+post any issues you find.
+
+### License ###
+Licensed under 3-clause-BSD.