Build your own security camera for the Echo Show
C++ Makefile Python Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lambda 1st publish Aug 7, 2017
rtsp_server Push to GH Aug 5, 2017
LICENSE Initial commit Aug 4, 2017 Update Aug 8, 2017 1st publish Aug 7, 2017
stunnel.conf Push to GH Aug 5, 2017


NOTE: This is a very early version and has a number of complex steps, I'm planning to improve the process in the future


  • A Raspberry PI, I've tested this on the Pi2, Pi3 and PiZeroW Running Raspbian (tested this with the July 2017 Build)
  • A Camera module fitted
  • A domain name with access to the DNS server to create A and TXT records
  • An AWS Account
  • An Alexa Developer Account
  1. Start with a fresh install of raspbian for this I've used the July 2017 version

  2. Run raspi-config as root change the default password edit the hostname enable the camera in interfaceing options expand the filesystem in advance options

  3. Install camera v4l2 module: vi /etc/modules Add a line at the botom of that file bcm2835-v4l2

  4. Install live555 media server as pi user not root

tar -xvzf live555-latest.tar.gz
cd live
./genMakefiles linux
sudo make install
  1. Next install the raspi rtsp server (modified from code found on
tar -xvzf raspi_rtsp.tgz
cd raspi
make install
  1. Copy the startup script Place in the home directory of the pi user (not root) run You can now verify that your camera is working properly using VLC on your computer by opening a network address of rtsp://[YOUR PI IP]:8080/h264

  2. Install and configure stunnel (as root) apt-get install stunnel Place the stunnel.conf file at /etc/stunnel/stunnel.conf

  3. Setup DNS entry for the Camera's private IP address on your LAN I use AWS Route53 but any DNS host should be fine, just create a A record for the Pi's IP address and give it a hostname like camerapi.[YOURDOMAIN.COM] Yes Putting Private IP's into public DNS is discouraged, but if this is only for your personal use then you're not going to break the internet, I use a separate domain for my camera's just to keep stuff clean.

  4. Get an SSL Cert using lets encrypt from your main machine as certbot doesn't easily run on raspbian certbot -d [hostname] --rsa-key-size 4096 --manual --preferred-challenges dns certonly It will ask you to verify domain ownership by creating a special DNS record, be careful with this as if you make a mistake it can take a long time for the DNS chace to expire so you can try again! Copy the files privkey.pem and fullchain.pem created by certbot over to the Pi in /etc/stunnel

  5. Start stunnel as root stunnel

  6. Create a Lambda Function Use the code in the lambda folder, you will need to edit the cameras.json file to contain the names and hostname of your camera(s) using the domain names you setup above, its important to keep the :443/h264 on the end of the URLs.

  7. Setup the Alexa Skill Signin to, Within the Alexa Skills Kit section Click Add a Skill Slect the Smart Home API SKill Give it a name like CameraPi Set the Payload version to v2 There is no need for an interaction model on smart home skills Link the skill to your Lambda Instance

  8. Setup Login with Amazon Follow the guide here You don't need to authenticate the cameras within the skill if its only for your own use the Smart Home skills require authentication.

  9. Discover Devices "Alexa Discover Devices" Should find your new camera. You can then say Alexa show Office Camera or whatever you've named to to open the stream Alexa Stop ends the video