Added info about streaming

README.md

@@ -39,9 +39,45 @@ while( (frame = player.nextFrame()) ) {
 }
 ```
 
+### Live Streaming ###
+
+jsmpeg supports streaming live video through WebSockets. You can use ffmpeg and a nodejs server to serve the MPEG video. See this [blog post](http://phoboslab.org/log/2013/09/html5-live-video-streaming-via-websockets) for the details of setting up a server. Also have a look at the `stream-server.js` and `stream-example.html`.
+
+To configure jsmpeg to connect to the stream server, simply pass a WebSocket connection instead of a filename to the constructor:
+
+```javascript
+// Setup the WebSocket connection and start the player
+var client = new WebSocket( 'ws://example.com:8084/' );
+var player = new jsmpeg(client, {canvas:canvas});
+```
+
+##Stream Recording##
+
+To record an MPEG stream clientside in the browser jsmpeg provides the `.startRecording(cb)` and `.stopRecording()` methods. `.stopRecording()` returns a `Blob` object that can be used to create a download link.
+
+```javascript
+player.startRecording(function(player){
+	// Called when recording really starts; usually 
+	// when the next intra frame is received
+});
+
+// ...
+
+// Stop recording and create a download link
+var blob = player.stopRecording();
+
+var filename = 'jsmpeg-recording.mpg';
+var a = document.getElementById('downloadLink');
+a.innerHTML = filename;
+a.download = fileName;
+a.href = window.URL.createObjectURL(blob);
+```
+
+
+
 ### Limitations ###
 
-- Playback can only start when the file is fully loaded. I'm waiting for chunked XHR with ArrayBuffers to arrive in browsers.
+- Playback can only start when the file is fully loaded (when not using streamin). I'm waiting for chunked XHR with ArrayBuffers to arrive in browsers.
 - MPEG files with B-Frames look weird - frames are not reordered. This should be relatively easy
 to fix, but most encoders seem to not use B-Frames at all by default.
 - The width of the MPEG video has to be a multiple of 2.