Organization changes to README

README.rst

@@ -1,15 +1,28 @@
 Kaylee
 ======
 
-Kaylee is a somewhat fancy speech recognizer that runs commands and
-performs other functions when a user speaks loosely preset sentences. It
-is based on `Blather <https://gitlab.com/jezra/blather>`__ by
+Kaylee is a somewhat fancy voice command recognition program that
+performs actions when a user speaks loosely preset sentences. It has a
+flexible plugin API allowing developers to add new advanced features
+that can be distributed and loaded with ease.
+
+Kaylee is based on `Blather <https://gitlab.com/jezra/blather>`__ by
 `Jezra <http://www.jezra.net/>`__, but adds a lot of features that go
 beyond the original purpose of Blather.
 
-Requirements
+Installation
 ------------
 
+Kaylee is only tested on GNU/Linux systems, so make sure you're trying
+to install it on one of those. The current recommended way to use Kaylee
+is to check out the Git repository and run it from there::
+
+    git clone https://git.clayhobbs.com/clay/kaylee.git
+    cd kaylee
+
+Dependencies
+~~~~~~~~~~~~
+
 1. Python 3 (tested with 3.5, may work with older versions)
 2. pocketsphinx 5prealpha
 3. gstreamer-1.0 (and what ever plugin has pocketsphinx support)
@@ -21,8 +34,8 @@ Requirements
 **Note:** it may also be required to install
 ``pocketsphinx-hmm-en-hub4wsj``
 
-Optional
-~~~~~~~~
+Optional Dependencies
+~~~~~~~~~~~~~~~~~~~~~
 
 1. python-pydbus (required for MPRIS plugin)
 
@@ -35,13 +48,8 @@ Usage
 2. Run Kaylee with ``./kaylee.py``. This generates a language model and
    dictionary using the `Sphinx Knowledge Base Tool
    <http://www.speech.cs.cmu.edu/tools/lmtool.html>`__, then listens for
-   commands with the system default microphone.
-
-   -  For the GTK UI, run ``./kaylee.py -i g``.
-   -  To start a UI in 'continuous' listen mode, use the ``-c`` flag.
-   -  To use a microphone other than the system default, use the ``-m``
-      flag.
-
+   commands with the system default microphone. To use a microphone
+   other than the system default, use the ``-m`` flag.
 3. Start talking!
 
 Examples