How It Works

Here is a slideshow on how to build Internet Controllable Christmas lights, a full-color version and a printable version.  Below is an introductory video to get you started!


Setting up Internet control of your lights involves these steps:

  1. Create a variety of xLights animations as multiple playback files

  2. Install Falcon Player onto a Raspberry Pi computer

  3. Configure Falcon Player to be Internet control capable 
    1. Uploading show/sequence files from xLights to Falcon Player
    2. Secure Falcon Player from Internet hackers
    3. Configure Falcon Player to receive commands from the Internet

  4. Setup an outdoor webcam that allows website visitors to see your house lights as they control them

  5. Configure your home Internet router to allows the outside world to contact your Raspberry Pi

  6. Setup a "Dynamic DNS" service so that the Raspberry Pi and webcam can be easily accessed from the Internet

  7. Setup a webpage that allows visitors to send commands to the Raspberry Pi, playing chosen animations


Suppose someone visits your webpage and clicks the "Candy Cane" animation.  Here is what happens:

  1. When the Candy Cane button is clicked, a php file is activated from the webpage.  

  2. This php file activates another php file on your Raspberry Pi (runEventScript.php).  The webpage can "find" your Raspberry Pi through the domain name that you created via Dynamic DNS.  

  3. The runEventScript.php file is used by Falcon Player to execute operating system commands via a "bash script".  In this case, Falcon Player is told to stop whatever animation is was currently playing, then being playing the animation that was chosen by the webpage visitor.

  4. A video of your webcam is also shown on the webpage so that visitors can view the animation that they chose.  The video feed on the webpage also "finds" your webcam via the domain name setup through Dynamic DNS.


There are two major parts of this "magic".  The first is how Dynamic DNS allows your Raspberry Pi and webcam be "seen" by outside users.  For those technically minded, Falcon Player is "seen" through port 80 from the Dynamic DNS domain name, while port 81 also allows the camera to be "seen", both sharing the same domain name.

The second part is Falcon Player's built-in runEventScript feature that allows outside users to control how Falcon Player functions.  


Last modified on Monday, 05 June 2017 16:58

Leave a comment

More in this category:


Learn how to make computer controlled, affordable, and Internet capable Christmas lights.


See what animated lights (a.k.a. "props") I have made for my Christmas display.

Build It

Step-by-step instructions how to build your own Christmas light display.


Project photos, videos, and news coverage.


FAQs, instructional videos, and community support.

Go to top
JSN Boot template designed by