From 7459b2404c28d32bf876fffb473301d8032b0bb2 Mon Sep 17 00:00:00 2001
From: Phil Howard <phil@gadgetoid.com>
Date: Mon, 12 Nov 2018 21:20:05 +0000
Subject: [PATCH] Updated README

---
 README.md          |  2 +-
 library/README.rst | 22 ++++++++++++++++++++--
 2 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index d64ea74..b9074b7 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-![!](plasma-logo.png)
+# Plasma Arcade Lights
 
 [![Build Status](https://travis-ci.com/pimoroni/plasma.svg?branch=master)](https://travis-ci.com/pimoroni/plasma)
 [![Coverage Status](https://coveralls.io/repos/github/pimoroni/plasma/badge.svg?branch=master)](https://coveralls.io/github/pimoroni/plasma?branch=master)
diff --git a/library/README.rst b/library/README.rst
index ad36c42..0e32307 100644
--- a/library/README.rst
+++ b/library/README.rst
@@ -1,5 +1,5 @@
-.. figure:: plasma-logo.png
-   :alt: Plasma Logo
+Plasma Arcade Lights
+====================
 
 |Build Status| |Coverage Status| |PyPi Package| |Python Versions|
 
@@ -67,6 +67,24 @@ other environments:
 
     sudo pip2 install plasmalights
 
+Using Plasma
+~~~~~~~~~~~~
+
+Plasma installs two programs onto your Raspberry Pi. ``plasma`` itself
+and a tool called ``plasmactl`` you can use to install and switch
+lighting effects. Plasma runs as a service on your system.
+
+``plasmactl`` commands:
+
+-  ``plasmactl 255 0 0`` - Set Plasma lights to R, G, B colour. Red in
+   this case.
+-  ``plasmactl <pattern>`` - Set Plasma lights to pattern image
+-  ``plasmactl fps <fps>`` - Change plasma effect framerate (default is
+   30, lower FPS = less CPU)
+-  ``plasmactl --list`` - List all available patterns
+-  ``sudo plasmactl --install <pattern>`` - Install a new pattern, where
+   ``<pattern>`` is the filename of a 24bit PNG image file
+
 Development:
 ~~~~~~~~~~~~