Live!

Tomtomgo · Dec 24, 2014 · b645f32 · b645f32
commit b645f32
Show file tree

Hide file tree

Showing 6 changed files with 203 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -0,0 +1,116 @@
+# Raspberry Pi livestreaming
+---
+## Streaming live video from a webcam to the web over RTMP using a Raspberry Pi and Nginx
+
+Imagine you're in a shared office with a foosball table and many people in the office like to play foosball. Then sometimes when you want to play you'll make a trip down the stairs just to find out its in use and you'll have to go up the stairs again. That's pretty sad, useless and a waste of time. 
+
+The fix is obvious: get a Raspberry Pi, a webcam and stream the foosball table so you'll always know if it's free!
+
+Because we ran into quite a few difficulties we decided to write a little how-to. Sharing is caring ;)
+
+If you find anything is missing, create an issue here!
+
+## Hardware
+
+This is the hardware we used. You will probably have some other stuff... which should work as well.
+
+- RaspberryPi B+ with Raspbian installed
+- 8 GB SD card
+- Logitech C310 webcam
+- 2A power adapter
+
+## Installing the necessary software
+
+Everything here should be done on the Raspberry Pi (as opposed to on your computes). 
+
+### Basics
+
+```bash
+sudo apt-get install ffmpeg
+sudo apt-get install supervisor
+```
+
+### Build Nginx with RTMP module
+
+To stream our video to the web we use [Nginx](http://nginx.org/) with an [RTMP module](https://github.com/arut/nginx-rtmp-module). This module has to be compiled into Nginx, so let's do it:
+
+```bash
+cd /tmp
+wget https://github.com/arut/nginx-rtmp-module/archive/master.zip
+wget http://nginx.org/download/nginx-1.7.9.tar.gz
+tar -zxvf nginx-1.7.9.tar.gz
+unzip master.zip
+
+cd nginx-1.7.9
+./configure --add-module=/tmp/nginx-rtmp-module-master
+make # <- This takes a few minutes on a Raspberry Pi
+sudo make install
+```
+
+### Edit `stream.sh` for your environment
+
+Replace **<STREAM_NAME>** and **<RASPBERRY_IP>** with suitable values for you. 
+
+### Copy files to Raspberry Pi
+
+From this folder on your machine:
+
+```bash
+scp -r ./ pi@<RASPBERRY_IP>:/home/pi
+```
+
+### Copy config files
+
+```bash
+cd ~
+sudo cp nginx.conf /usr/local/nginx/conf/nginx.conf
+cp stream.supervisor.conf /etc/supervisor/conf.d/stream.supervisor.conf 
+cp /tmp/nginx-rtmp-module-master/stat.xsl 
+```
+
+### Run the systems!
+
+This will (re)start Nginx and the stream itself.
+
+```bash
+sudo service supervisor stop
+sudo service supervisor start
+```
+
+## Showing the stream on a web page
+
+We used [HDW Player](http://www.hdwplayer.com) for showing the RTMP-stream, but there are probably many more.
+
+Download it and put the `player` folder in a project folder somewhere.
+
+Then to show the video you can do something like this (replace <THESE_THINGS>):
+
+```html
+<html>
+  <head>
+    <script src="<PROJECT_FOLDER>/player/hdwplayer.js"></script>
+  </head>
+  <body>
+    <div id="player"></div>
+    <script type="text/javascript">
+      hdwplayer({ 
+        id        : 'player',
+        swf       : '<PROJECT_FOLDER>/player/player.swf',
+        width     : '640',
+        height    : '334',
+        type      : 'rtmp',
+        streamer  : 'rtmp://<RASPBERRY_IP/live',
+        video     : '<STREAM_NAME>',
+        autoStart : 'true',
+        controlBar: 'false'
+        });
+    </script>
+  </body>
+</html>
+```
+
+That should do it!
+
+## Credits
+
+Built at [Rockstart](http://rockstart.com) by [Sjoerd Huisman](https://github.com/shuisman) from [Congressus](https://www.congressus.nl/) and [Tom Aizenberg](https://github.com/Tomtomgo) from [Achieved](http://achieved.co).
diff --git a/deploy.sh b/deploy.sh
@@ -0,0 +1,11 @@
+#! /bin/bash 
+
+if [[ $1 != "" ]]
+then
+  echo "Deploying to $1"
+else
+  echo "You should set PI's IP address!"
+  exit 1
+fi
+
+scp -r ./ pi@$1:/home/pi
diff --git a/livestream-working.jpg b/livestream-working.jpg
diff --git a/nginx.conf b/nginx.conf
@@ -0,0 +1,45 @@
+# This is the nginx configuration file for setting up a simple live streaming server.
+worker_processes  1;
+
+events {
+  worker_connections  1024;
+}
+
+rtmp {
+  server {
+    listen 1935;
+    ping 30s;
+    notify_method get;
+
+    application live {
+      live on;
+    }
+  }
+}
+
+http {
+  include       mime.types;
+  default_type  application/octet-stream;
+
+  sendfile        on;
+  keepalive_timeout  65;
+
+  server {
+    listen       80;
+    server_name  localhost;
+
+
+    location / {
+      rtmp_stat all;
+      rtmp_stat_stylesheet stat.xsl;
+    }
+
+    location /control {
+      rtmp_control all; 
+    }
+
+    location /stat.xsl {
+      root /home/pi/;
+    }
+  }
+}
diff --git a/stream.sh b/stream.sh
@@ -0,0 +1,14 @@
+#! /bin/bash
+
+# Run avconv to stream the webcam's video to the RTMP server.
+
+avconv  -f video4linux2 \       # Webcam format goes in 
+        -s 320x176 \            # Small is big enough
+        -r "10" \               # Fixed framerate at 10fps, somehow this needs to be a string
+        -b 256k \               # Fixed bitrate
+        -i /dev/video0 \        # Webcam device
+        -vcodec libx264 \       # h264.1 video encoder
+        -preset ultrafast \     # Use the fastest encodeing preset
+        -f flv \                # Flash video goes out
+        -an \                   # No audio!
+        rtmp://<RASPBERRY_IP>/live/<STREAM_NAME>
diff --git a/stream.supervisor.conf b/stream.supervisor.conf
@@ -0,0 +1,17 @@
+# The minimal Supervisord configuration for running the live stream.
+[program:serve]
+command=/home/pi/stream.sh
+process_name=%(program_name)s
+numprocs=1
+directory=/home/pi
+autostart=true
+autorestart=true
+user=pi
+
+[program:nginx]
+command=/usr/local/nginx/sbin/nginx
+process_name=%(program_name)s
+numprocs=1
+autostart=true
+autorestart=true
+user=root