From 9ffcc580cf9f238aaaae0d6df1effc05cb9b874e Mon Sep 17 00:00:00 2001
From: =?utf8?q?Fr=C3=A9d=C3=A9ric=20P=C3=A9ters?= <fpeters@0d.be>
Date: Sat, 5 Jul 2014 13:57:19 +0200
Subject: [PATCH] fill README file

---
 README | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 TODO   |  2 --
 2 files changed, 64 insertions(+), 2 deletions(-)

diff --git a/README b/README
index 367b2aa..15a7eb5 100644
--- a/README
+++ b/README
@@ -1,4 +1,68 @@
 jackwsmeter - jack meter over websockets
 ========================================
 
+jackwsmeter get the signal values of the audio signals that flow through
+JACK ports and make the peak levels available over a websocket link,
+it's a clean and efficient way to get an overview of levels from a serie
+of jack servers.
 
+
+Installation
+------------
+
+JACK <http://jackaudio.org> and libwebsockets <http://libwebsockets.org>
+development files are required.
+
+Building and installing is done via the autotools:
+
+  ./autogen.sh
+  make
+  make install
+
+
+Usage
+-----
+
+Run the following command, then open your browser at http://localhost:7681.
+
+  jackwsmeter system:capture_1 system:capture_2
+
+It's also possible to specify invalid ports, in that case the corresponding
+number of jack input ports will be created but unconnected; the following
+command creates four input ports:
+
+  jackwsmeter x x x x
+
+(the limit is set at 20 input ports)
+
+
+Protocol
+--------
+
+jackwsmeter comes with a minimalistic HTML page but can be used in much better
+integration when using its WebSocket interface.
+
+The WebSocket protocol string is jack-wsmeter-protocol, it will periodically
+emit a message consisting of a string containing a space separated list of
+level values.
+
+  var ws = new WebSocket('ws://localhost:7681', 'jack-wsmeter-protocol');
+  ws.onmessage = function(event) {
+      var peaks = event.data.split(" ");
+      console.log('got ', peaks.length, ' measures:', event.data);
+  }
+
+
+Real world usage
+----------------
+
+jackwsmeter was developed to be used in Radio Panik, a free community radio in
+Brussels, Belgium. <http://www.radiopanik.org>
+
+
+Feedback
+--------
+
+You can send bug reports or any kind of comment to the author.
+
+  mailto:Frederic Peters <fpeters@0d.be>
diff --git a/TODO b/TODO
index 135e482..aa969bb 100644
--- a/TODO
+++ b/TODO
@@ -1,3 +1 @@
-- documentation
-  - README (including protocol description)
 - arg to set refresh rate (?)
-- 
2.11.4.GIT