diychristmas.org wiki - User contributions [en]

Controlling FPP from Vixen3

2026-07-22T19:16:30Z

ErnieHorning: Replaced outdated version-specific Vixen/Falcon Player setup instructions with a general integration overview and links to the official Falcon Player and Vixen documentation.

= Controlling Falcon Player from Vixen =

This article describes methods for triggering Falcon Player (FPP) functions from Vixen. Common uses include starting videos, launching scripts, controlling playlists, and executing events during a synchronized lighting sequence.

Current versions of both Falcon Player and Vixen continue to evolve, so specific menus and configuration procedures may differ from earlier releases. Refer to the official documentation for the latest setup instructions.

== Trigger Methods ==

Falcon Player can be controlled from Vixen using several methods, including:

* Streaming ACN (E1.31) Events
* Scripts
* HTTP requests (CURL/URL commands)
* Playlists and scheduler integration

The best method depends on your display architecture and the version of FPP and Vixen being used.

== Typical Workflow ==

A typical configuration consists of:

# Configure Falcon Player and verify normal operation.
# Configure network communications between Vixen and FPP.
# Create an event or script in FPP.
# Trigger the event from a Vixen sequence.
# Test synchronization of audio, lighting, and video.

== External Resources ==

The following official resources provide the latest information on Falcon Player (FPP) and Vixen.

* [https://falconchristmas.github.io/FPP_Manual.pdf Falcon Player User Manual]
* [https://falconchristmas.com/forum Falcon Christmas Forum]
* [https://www.vixenlights.com/docs/ Vixen Documentation]

Falcon Player on Pi

2026-07-22T19:09:39Z

ErnieHorning: Replaced outdated Raspberry Pi installation instructions with a concise overview and links to the official Falcon Player documentation, forum, and current installation resources.

```wiki
= Falcon Player on Raspberry Pi =

Falcon Player (FPP) can be installed on a Raspberry Pi to create a dedicated show player for synchronized holiday lighting displays. Once installed, the Raspberry Pi can play sequences, audio, and scheduled playlists without requiring a computer to remain connected during your show.

FPP supports a wide range of Raspberry Pi models and is continually updated with new features and hardware support. Because the installation process changes as new versions of FPP and Raspberry Pi hardware are released, this Wiki does not attempt to duplicate the official installation instructions.

== Hardware Requirements ==

Typical hardware includes:

* Raspberry Pi (any model currently supported by FPP)
* MicroSD card
* Power supply
* Ethernet or Wi-Fi network connection
* USB flash drive (if required by your FPP version and configuration)

Refer to the official FPP documentation for the current list of supported hardware and recommendations.

== Installation ==

Follow the official Falcon Player installation guide for the latest installation procedures, supported Raspberry Pi models, and configuration instructions.

== After Installation ==

Once FPP is installed you can:

* Configure your network settings.
* Upload sequences and audio files.
* Create playlists.
* Configure the scheduler.
* Connect to xLights or other supported sequencing software.
* Configure controllers and outputs.

== External Resources ==

The following official resources provide the latest documentation, downloads, and community support for Falcon Player (FPP).

* [https://falconchristmas.github.io/FPP_Manual.pdf Falcon Player User Manual (PDF)]
* [https://falconchristmas.com/forum Falcon Christmas Forum]
* [https://www.xlights.org xLights Website]
* [https://manual.xlights.org xLights User Manual]

Raspberry PI/BeagleBone

2026-07-22T18:55:08Z

ErnieHorning: Remove Falcon Player website, since there isn't one.

```wiki
= Falcon Player (FPP) =

Falcon Player (FPP) is a free, open-source show player designed specifically for synchronized holiday lighting displays. It allows a dedicated controller, such as a Raspberry Pi or BeagleBone, to play lighting sequences directly without requiring a computer to remain connected during the show.

FPP supports xLights sequences, scheduled playlists, audio playback, network synchronization, and a wide variety of lighting controllers and communication protocols. It is commonly used in displays ranging from small residential shows to large commercial installations.

== Supported Platforms ==

Falcon Player currently supports several hardware platforms, including:

* Raspberry Pi
* BeagleBone Black
* PocketBeagle
* Virtual Machines (for testing and development)

== Setup Guides ==

The following pages provide installation and configuration information for supported hardware platforms.

* '''[[Falcon Player on Pi]]''' – Setting up Falcon Player on a Raspberry Pi.
* '''[[Falcon Player on BeagleBone]]''' – Setting up Falcon Player on a BeagleBone.

== Integration ==

Falcon Player works with several popular sequencing applications.

* '''[[Controlling FPP from xLights]]'''
* '''[[Controlling FPP from Vixen3]]''' by mwestling

== Related Projects ==

* '''[[Building an Octoscroller Matrix Display]]''' – Using an Octoscroller and BeagleBone to build a large LED matrix display.

== External Resources ==

The following official resources provide the latest downloads, documentation, and community support for Falcon Player and xLights.

* [https://falconchristmas.github.io Falcon Player Documentation]
* [https://falconchristmas.com/forum Falcon Christmas Forum]
* [https://www.xlights.org xLights Website]
* [https://manual.xlights.org xLights User Manual]
```

Controlling FPP from xlights

2026-07-22T18:44:24Z

ErnieHorning: ErnieHorning moved page Controlling FPP from xlights to Controlling FPP from xLights

#REDIRECT [[Controlling FPP from xLights]]

Controlling FPP from xLights

2026-07-22T18:44:24Z

ErnieHorning: ErnieHorning moved page Controlling FPP from xlights to Controlling FPP from xLights

Controlling FPP from xlights

Assuming you have the fpp fully up and running with DNS resolved if not see the wiki's concerning installing fpp.

Xlights makes configuring the fpp very easy

If you have your networks all set up in xlights on the setup tab, and are running the latest version of xlights, under tools in xlights is fpp connect. Use this to upload your networks directly to the fpp, this will fully set up your show to run. You also can use fpp connect to upload the sequences and audio files.

If you do not have your networks setup in xlights or are running an older version of xlights that does not have fpp connect.

In the pi gui, under Input/Output settings you want Channel Outputs.
Here if you are using e1.31 that is the first tab, the universe count is default to 0, set it to the desired number of universes. Adjust them as necessary paying attention to start channels for the next universe.
NOTE: a trick to setting this up if you are using different sized universes is to set the universes up 1 at a time (add one to the number of universe count to add 1 more universe) and change one universe at a time, REMEMBER to save before adding another universe. The fpp will then keep the start channels flowing correctly.
Make sure to enable e1.31 output (little check box at the top easily missed)

If you are using p10 panels that is set up under the led panels tab,
Channel outputs - led panels
Set the panel correctly... 2x4 is 2 wide 4 high, a 4x2 is 4 wide and 2 high
Make sure the start channel of the grid matches the start channel in xlights/vix 3... even if you have a different fpp doing other things the data still starts at that point for the p10 panel.
There is now a drop down box in fpp that asks top left or bottom left start position this was added for vixen 3 users where there is an issue with text and vixen 3 using top left for its start position. xlights users make sure its set to top left.
ok setting up the grid in fpp is the biggest source of confusion... first and foremost... the set up in fpp is looking at the front of the panel, so your hookups are reversed left/right when connecting at the back... the top right panel in fpp is the top right panel looking at the front of the display so connecting at the back that would be the top left one.
note the arrows on the falcon player must match the arrows on the boards as viewed from the front (left/right flip when looking at the back does apply)

If you are wanting to test the matrix with a feed from xlights/vix 3 you will need to define the matrix in e1.31
Each panel is 512 pixels and each pixel is 3 channels so 3 512 universes per panel. A 36 panel matrix is 108 universes of 512 channels just for reference.
A quick way of doing the universes is to set the universe count to 1, use your start channel as that start channel and number of channels set to 512. you can use multicast or unicast doesnt matter. Click save then set the number of universes to the number needed fpp will auto fill the rest of them in. click save again then restart the fppd. Note - you do not need to enable e1.31 output for this to work (unless you have other things your outputting e1.31 for in which case just uncheck the box next to these universes that are defined for the panel)

Just a quick followup on the post....

the raspberry pi matix adapter has 3 outputs and a max of 12 panels per output for a total of 36 panels
the octoscroller for beaglebone has 8 outputs and a max of 8 panels per output for a total of 64 panels

When running the p10 make sure you direct your fpp away from the status page this updates every second and causes a blink on the panels if you navigate away from it then close the browser it will remember that you are not on the status page.

for best picture in xlights set the contrast to 1.2 to 1.25 and the brightness to -30%.
In vix 3 add a dimming curve to the matrix in the display setup set to 70.

A more advanced way of doing it is shown here in this video (DO AT YOUR OWN RISK)
https://www.youtube.com/watch?v=QtsncYoUl30

Here is a picture of my setup in xlights fpp and physical to show everything recapped

Click image for larger version.

Name: P10 layout.jpg

Pi hat/usb serial outputs are done from the other tab
Add then select the appropriate type from the drop down

for dmx your wanting dmx open ... this can control renard, lor. and other dmx boards
for the pi hat (pixel output) you will need to select RPIWS281X and then set the number of pixels per output (there are 2) as well as the correct start channel

Please note, BBB's do not have onboard sound, using either a pi hat or pi matrix adapter will disable the onboard sound card, in all these instances if you are wanting sound output you must add a usb sound card.

Falcon Player on pi

2026-07-22T18:42:49Z

ErnieHorning: ErnieHorning moved page Falcon Player on pi to Falcon Player on Pi

#REDIRECT [[Falcon Player on Pi]]

Falcon Player on Pi

2026-07-22T18:42:49Z

ErnieHorning: ErnieHorning moved page Falcon Player on pi to Falcon Player on Pi

This will cover how to set up the falcon player on a raspberry pi.

Before starting visit this page and download the github file listed this should be the latest working version of fpp.

http://falconchristmas.com/forum/index.php/topic,483.0.html

this has the link to the latest release of the falcon software as well as install instructions... i will cover the instructions here again just to help

Once you have the zip file downloaded from the above page here is the steps to getting it set up

== Hardware Required ==
'''Raspberry pi'''
'''NOTE:''' the pi's come in a variety of models, as of this writing there is Model A, Model B, Model B+, Model 2B+, Model 3B+, and the pi zero.
The stats are as follows:
Model A - Single core processor and 256 megabytes of ram (Does not have ethernet out)
Model B - Single core processor and 512 megabytes of ram
Model B+ - Single core processor, 512 megabytes of ram, and new form factor including a 2x20 pin header (this is needed for running pi hats and matrix boards)
Model 2B+ - Quad core processor, 1 gigabyte of ram, and the new form factor
Model 3B+ - Quad core processor, 1 gigabyte of ram, the new form factor, and built in wifi
Pi Zero - Single core processor, 512 megabytes of ram, (note does not have ethernet and all usb are micro usb ports)

'''Micro sd card''' 4gb or better, class 10 recommended.

'''USB thumb drive''' try to get one big enough to store all your sequences, songs and other stuff generally you would want 8gb or better

'''USB wifi dongle''' Not needed on 3B+ models as they have built in wifi

'''Micro USB wall wart''' this is to power the pi, note if you are using a hat on the pins the hat may have power to the card so this may not be needed.

'''NOTE:''' this is the micro sd card '''NOT''' the USB thumb drive

== windows ==

1) Download the sd card formatter from https://www.sdcard.org/downloads/formatter_4/eula_windows/

2) Insert the sd card into a reader for your computer, format the sd card using the sd card formater making sure to turn on size adjustment under options

[[File:sd_formatter_adjust_size.png]]

3) copy the contentes of the zip file onto the sd card (do not copy the zip file you need to put all the files from the zip on the sd card)

4) remove the sd card from the card reader and insert into the micro sd slot on the bottom of the pi

== MAC ==

1) Download the SD Association's Formatting Tool from https://www.sdcard.org/downloads/formatter_4/eula_mac/

2) Insert the sd card into a reader for your computer, format the sd card using the sd card formater making sure to select "Overwrite Format"

3) copy the contentes of the zip file onto the sd card

4) remove the sd card from the card reader and insert into the micro sd slot on the bottom of the pi

== Linux ==

1) Recommended to use gparted

2) format the entire sd card as a single vfat partition copy the contents of the zip file to the sd card.

3) a command-line script called formatSD.sh is available in the git repository for those who prefer the command line.

4) remove the sd card and put in the pi

== USB thumb drive prep ==

'''NOTE:''' now for the USB thumb drive

5) insert the USB thumb drive on your computer

6) format the drive to fat32 (if you are running windows 10 you will need to install a 3rd party fat32 formatter) '''NOTE:''' exFAT and ntfs are not valid and the pi will not be able to read or write to these formats.

7) create a directory called Config on the thumb drive and open the Config directory

8) Here you will make 2 files and put them in the Config folder made a copy of these available here https://www.dropbox.com/s/7pq73mueu45oiw5/Config.zip?dl=0
a) open a text editor '''NOTE:''' the ip addresses in eth0 and wlan0 '''must be on different networks''' (192.168.0 and 192.168.1 in these examples here)
b) copy the following into the editor and change as necessary (this is your show ip address not home address) If using notepad then make sure its all one line if using another editor turn on linux line formatting and make multiple lines
INTERFACE="eth0"
PROTO="static"
ADDRESS="192.168.1.101"
NETMASK="255.255.255.0"
GATEWAY=""
c) save this file as interface.eth0 and place in the Config folder of the usb drive
d) new file once again copy this into the editor and change as necessary If using notepad then make sure its all one line if using another editor turn on linux line formatting and make multiple lines
INTERFACE="wlan0"
PROTO="static"
ADDRESS="192.168.0.30"
NETMASK="255.255.255.0"
GATEWAY="192.168.0.1"
SSID='your home network name'
PSK='home wifi password'
e) save this file as interface.wlan0 and place in the Config folder of the usb drive (make sure to write down the address of wlan0)

9) remove the thumb drive from the computer and place in one of the usb ports of the pi

== The install ==

10) insert the USB wifi dongle (not needed on 3B+)

11) if you have speakers hook them up to the sound output (when the install is done and its up the pi will do an announcement of what ip addresses it has)

12) power on the pi

'''NOTE:''' you can connect the pi to a monitor or tv to watch the install (pretty boring) using either the hdmi output or the rca output depending on which model you have.

13) WAIT for the install to finish... this may take upwards of 30 minutes depending on pi model and sd card class

14) when you hear the pi announce what ip addresses it has found verify that they match what you put in wlan0 and eth0 (they should)

15) access the pi via webbrowser at the ip address you set for wlan0 (192.168.0.30 if you used the same addresses)

16) open the network page under status/control tab

17) the bottom is dns set it to manual

[[File:dns.jpg]]

18) for server 1 use your home router's ip address (192.168.0.1 is the normal but yours may vary) Or use 8.8.8.8 (the webs dns server)

19) update dns and restart networks

20) reboot the pi

You now have the fpp up and running and it should have the correct date though probably not the correct time you will need to set the time for your location under the time/date in status drop down.

You now can setup the input output and upload .fseq and audio files, set up your playlists, and use the playlists to set up the scheduler.

Here is part 1 (and from that you can get to further parts) of the falcon install in video form

https://vimeo.com/77569318

Falcon Player on beaglebone

2026-07-22T18:40:27Z

ErnieHorning: ErnieHorning moved page Falcon Player on beaglebone to Falcon Player on BeagleBone

#REDIRECT [[Falcon Player on BeagleBone]]

Falcon Player on BeagleBone

2026-07-22T18:40:27Z

ErnieHorning: ErnieHorning moved page Falcon Player on beaglebone to Falcon Player on BeagleBone

This will cover how to set up falcon player on a beaglebone

http://falconchristmas.com/forum/index.php/topic,2742.0.html

this has the link to the latest release of the falcon software as well as install instructions... i will cover the instructions here again just to help

Once you have the zip file downloaded from the above page here is the steps to getting it set up

== Hardware Required ==
'''Beaglebone black''' or '''Beaglebone green'''

'''Micro sd card''' 4gb or better, class 10 recommended.

'''USB thumb drive''' try to get one big enough to store all your sequences, songs and other stuff generally you would want 8gb or better

'''USB wifi dongle'''

'''USB Sound Card'''

'''Powered USB hub''' this is recommended so the usb thumb drive, usb sound card and the usb wifi dongle can be used. If you choose to not use the usb thumb drive install the eMMC fpp version and use the sd card as the storage for your sequences and songs

== Micro sd card setup ==

'''NOTE:''' this is the micro sd card '''NOT''' the USB thumb drive

1) Write FPP BBB SD disk image to micro-SD card using "Win32 Disk Imager"
Download and install the Win32 Disk Imager from the following link: http://sourceforge.net/projects/win32diskimager/files/latest/download

Extract the .img file from the FPP BBB SD image .zip file
Insert a 2GB or larger micro-SD card into your computer
Run the Win32 Disk Imager application
Select the correct disk drive letter for the micro-SD card. NOTE: Double-check that this is the correct drive letter as the Win32 Disk Imager will overwrite any data if you select the incorrect drive letter
Select the extracted .img file
Press "Write" and wait for the image to be written to the micro-SD

2) Insert micro-SD card into the BBB

== USB thumb drive prep ==

'''NOTE:''' now for the USB thumb drive

3) insert the USB thumb drive on your computer

4) format the drive to fat32 (if you are running windows 10 you will need to install a 3rd party fat32 formatter) '''NOTE:''' exFAT and ntfs are not valid and the pi will not be able to read or write to these formats.

5) create a directory called Config on the thumb drive and open the Config directory

6) Here you will make 2 files and put them in the Config folder
a) open a text editor '''NOTE:''' the ip addresses in eth0 and wlan0 '''must be on different networks''' (192.168.0 and 192.168.1 in these examples here)
b) copy the following into the editor and change as necessary (this is your show ip address not home address) If using notepad then make sure its all one line if using another editor turn on linux line formatting and make multiple lines
INTERFACE="eth0"
PROTO="static"
ADDRESS="192.168.1.101"
NETMASK="255.255.255.0"
GATEWAY=""
c) save this file as interface.eth0 and place in the Config folder of the usb drive
d) new file once again copy this into the editor and change as necessary If using notepad then make sure its all one line if using another editor turn on linux line formatting and make multiple lines
INTERFACE="wlan0"
PROTO="static"
ADDRESS="192.168.0.30"
NETMASK="255.255.255.0"
GATEWAY="192.168.0.1"
SSID='your home network name'
PSK='home wifi password'
e) save this file as interface.wlan0 and place in the Config folder of the usb drive (make sure to write down the address of wlan0)

7) remove the thumb drive from the computer and place in one of the usb ports of the usb hub

== The install ==

8) insert the USB wifi dongle

9) If you are using a usb sound card plug speakers into the sound card

10) power on the beaglebone

11) Hold the Boot Button (S2) on the top of the beaglbone (near the micro sd slot) while powering on the beaglebone. Hold until the led's start to flash. (Some users have reported not being required to do this step if they have been using the BBB already booting off the micro-SD card)

12) he BBB should boot up running FPP off the micro-SD. The boot process will automatically resize the main disk partition to fill up the micro-SD card, and this will automatically reboot. The whole process should take under a minute and then FPP will be up and running.

13) access the fpp via webbrowser at the ip address you set for wlan0 (192.168.0.30 if you used the same addresses)

14) open the network page under status/control tab

15) the bottom is dns set it to manual

[[File:dns.jpg]]

16) for server 1 use your home router's ip address (192.168.0.1 is the normal but yours may vary)

17) update dns and restart networks

Here is a video link to installing the falcon player (this is part 1 you can then get to later parts as needed)

https://vimeo.com/77569318

Raspberry PI/BeagleBone

2026-07-22T18:31:07Z

ErnieHorning: Expanded the Falcon Player page into an introductory reference with supported platforms, setup guides, software integration, related projects, and links to official documentation and community resources.

```wiki
= Falcon Player (FPP) =

Falcon Player (FPP) is a free, open-source show player designed specifically for synchronized holiday lighting displays. It allows a dedicated controller, such as a Raspberry Pi or BeagleBone, to play lighting sequences directly without requiring a computer to remain connected during the show.

FPP supports xLights sequences, scheduled playlists, audio playback, network synchronization, and a wide variety of lighting controllers and communication protocols. It is commonly used in displays ranging from small residential shows to large commercial installations.

== Supported Platforms ==

Falcon Player currently supports several hardware platforms, including:

* Raspberry Pi
* BeagleBone Black
* PocketBeagle
* Virtual Machines (for testing and development)

== Setup Guides ==

The following pages provide installation and configuration information for supported hardware platforms.

* '''[[Falcon Player on Pi]]''' – Setting up Falcon Player on a Raspberry Pi.
* '''[[Falcon Player on BeagleBone]]''' – Setting up Falcon Player on a BeagleBone.

== Integration ==

Falcon Player works with several popular sequencing applications.

* '''[[Controlling FPP from xLights]]'''
* '''[[Controlling FPP from Vixen3]]''' by mwestling

== Related Projects ==

* '''[[Building an Octoscroller Matrix Display]]''' – Using an Octoscroller and BeagleBone to build a large LED matrix display.

== External Resources ==

The following official resources provide the latest downloads, documentation, and community support for Falcon Player and xLights.

* [https://falconplayer.com Falcon Player Website]
* [https://falconchristmas.github.io Falcon Player Documentation]
* [https://falconchristmas.com/forum Falcon Christmas Forum]
* [https://www.xlights.org xLights Website]
* [https://manual.xlights.org xLights User Manual]
```

Arduino

2026-07-22T18:13:23Z

ErnieHorning: Expanded the Arduino landing page with an introduction, common applications, related articles, and external resources.

== Arduino ==

Arduino is a family of inexpensive microcontroller boards that are widely used for custom electronics projects. They are well suited for controlling relays, motors, servos, sensors, LEDs, and other hardware commonly found in animated holiday displays.

Although many modern Christmas displays use ESP8266 or ESP32 controllers because they include built-in Wi-Fi, Arduino boards remain an excellent choice for stand-alone prop control, motion systems, and learning embedded programming.

== Common Uses ==

* Relay control
* Servo control
* Stepper motors
* DC motors
* Sensors
* Button inputs
* Sound effects
* Custom prop animation

== Related Articles ==

* [[Arduino and the mechanical relay]]
* [[Arduino and pixels V1]]

----

''Future Enhancements''
== External Resources ==
----

* [Arduino Official Documentation] – Official documentation, tutorials, language reference, and board information.
* [Arduino Project Hub] – Community-contributed Arduino projects and examples.
* [SparkFun Arduino Tutorials] – Beginner-friendly tutorials covering hardware, programming, and common interfaces.
* [Adafruit Learning System – Arduino] – Excellent step-by-step lessons and project guides.
* [DroneBot Workshop] – Detailed articles and videos covering Arduino, ESP32, sensors, motors, and electronics.

Projects/PDFs

2026-07-22T16:33:12Z

ErnieHorning: Added descriptive summaries to the Related Projects section and standardized formatting for consistency.

== Related Projects ==

* '''Wireless Servo-Controlled Spotlight''' – A wireless spotlight project using servo motors for pan and tilt control. Created by pakeonoahu. [[Media:Spotlight.pdf]]

* '''Servo Recorder/Player''' – A system for recording and replaying servo movements, useful for creating repeatable animated sequences. Created by Brian Lincoln (Lightman). [[Media:Servo Recorder Player Guideline-Instructions11.pdf]]

* '''[[Super-sized Animatronic Ball Ornaments]]''' – Construction details for animated oversized Christmas ornaments driven by servo mechanisms.

* '''[[Animating a static, commercial snowman]]''' – Techniques for converting a commercial static decoration into an animated display using servos.

Wiper Motors

2026-07-22T15:53:15Z

ErnieHorning: Added six illustrations throughout the Wiper Motors article covering motor types, linkages, PWM speed control, display applications, and motor comparisons.

Wiper motors are rugged, inexpensive DC gearmotors originally designed to operate automotive windshield wipers. Because they provide high torque, low speed, and continuous rotation, they have become popular workhorses for animated Christmas and Halloween displays.

They are especially useful for larger props that need dependable mechanical movement without precise electronic positioning. With the proper linkage, a wiper motor can create rotating, rocking, lifting, sliding, or back-and-forth motion.

[[File:Wiper_Common_Motors.png|900px|thumb|center|Figure 1 – Common automotive wiper motors used in animated displays.]]

== How Wiper Motors Work ==

Although windshield wipers move back and forth, the motor itself normally rotates continuously in one direction. A crank, linkage, or gear mechanism converts that rotary motion into the sweeping movement of the wiper arms.

[[File:Wiper_Crank_Linkage.png|900px|thumb|center|Figure 2 – A crank linkage converts continuous rotation into back-and-forth motion.]]

This same principle makes wiper motors useful for animated display props. By attaching a crank arm, cam, connecting rod, or other mechanism to the motor shaft, continuous rotation can be converted into many different kinds of motion.

Wiper motors normally operate from low-voltage DC power, commonly 12 volts in passenger vehicles and sometimes 24 volts in larger vehicles.

== Why Wiper Motors Are Popular ==

Wiper motors offer several advantages for animated displays:

* High torque at low speed
* Rugged automotive construction
* Designed for long operating periods
* Widely available new, used, or salvaged
* Simple DC power requirements
* Reversible rotation on many models
* Easy speed control with a suitable PWM controller
* Strong enough for many medium and large props
* Often include built-in gear reduction

They are commonly used when a hobby servo is too small and a stepper motor would add unnecessary complexity.

== Common Applications ==

Wiper motors have been used in many animated Christmas and Halloween projects.

Examples include:

* [https://youtu.be/e3p6pAzczeU Rotating antenna dishes]
* [https://youtu.be/ed0nvu4U2IY Carousels]
* [https://youtu.be/zsRVe6O7oVE Trains]
* [https://youtu.be/PYk2SkbMg3w Conveyor belts]

Other possible applications include:

* Ferris wheels
* Rotating signs
* Windmills
* Animated figures
* Moving arms and heads
* Rocking props
* Opening doors
* Moving scenery
* Crank-driven characters
* Lifting and lowering mechanisms
* Oscillating displays
* Mechanical shop or workshop scenes

These short demonstration videos are useful because they show how the same basic motor can be adapted to many very different display mechanisms.

== Continuous Rotation and Direction ==

A wiper motor normally rotates continuously rather than moving to a commanded position.

Because it is a DC motor, the direction of rotation can often be reversed by reversing the polarity applied to the motor. However, not every automotive wiper motor is wired internally in the same way.

Some motors include:

* Multiple speed terminals
* An internal parking switch
* A chassis-ground connection
* Separate field or brush connections
* Internal wiring that complicates simple polarity reversal

'''⚠️ Warning:'''

Do not assume that every terminal on a salvaged wiper motor can be connected directly to power. Identify the motor terminals and internal park-switch wiring before applying voltage.

== Motor Terminals and Park Switches ==

Many automotive wiper motors include an internal park switch. In a vehicle, this switch keeps the motor running after the driver turns the wipers off until the blades return to their normal parked position.

Depending on the motor design, the park circuit may:

* Continue supplying power until a specific shaft position is reached
* Connect internally to one of the speed terminals
* Use the metal motor housing as ground
* Create unexpected behavior when used outside the vehicle

For display use, the park switch may be ignored, disconnected, or intentionally incorporated into the mechanism. Always test the motor on a current-limited supply or with an appropriate fuse before permanent wiring.

[[File:Wiper_Common_Linkages.png|900px|thumb|center|Figure 3 – Common mechanical linkages used with wiper motors.]]

== Speed Control ==

Wiper motor speed can be controlled by changing the effective voltage applied to the motor.

The preferred method is usually Pulse Width Modulation (PWM). A PWM controller rapidly switches the motor power on and off while varying the percentage of time the power remains on.

[[File:Wiper_PWM_Speed_Control.png|900px|thumb|center|Figure 4 – Typical PWM speed control wiring and operation.]]

PWM control provides several advantages:

* Better low-speed torque than a simple resistor
* Less wasted heat
* Wide speed adjustment
* Easy control from a knob, switch, relay, or microcontroller
* Better efficiency than dropping voltage through a linear regulator

A controller must be rated for the motor's startup and stall current, not just its normal running current.

'''💡 Note:'''

A motor that draws only a few amps while running may draw several times that amount when starting or if the mechanism jams.

== Power Requirements ==

Most passenger-car wiper motors operate from approximately 12 volts DC. Motors from trucks, buses, or industrial equipment may use 24 volts.

Before choosing a power supply, determine:

* Motor operating voltage
* Normal running current
* Startup current
* Stall current
* Expected mechanical load
* Number of motors powered at the same time

The power supply and wiring should be sized for the highest realistic current demand.

Use:

* Properly sized wire
* A fuse near the power source
* Secure terminals
* Strain relief
* Weather-resistant enclosures for outdoor use

Do not power a wiper motor directly from a microcontroller, ESP board, or small relay module unless the switching device is specifically rated for the motor current.

== Reversing Direction ==

Many wiper motors can be reversed by reversing the polarity at the motor terminals.

Direction control may be accomplished with:

* A double-pole, double-throw switch
* Reversing relays
* An H-bridge motor driver
* A dedicated reversible DC motor controller

When using relays or an H-bridge, include appropriate protection for inductive voltage spikes.

'''⚠️ Warning:'''

Never reverse a heavily loaded motor instantly at full speed. Stop the motor first or allow a controlled deceleration period to reduce mechanical shock and current surges.

== Creating Different Motions ==

The motor shaft provides continuous rotary motion. Mechanical linkages convert that rotation into the movement required by the prop.

=== Crank and Connecting Rod ===

A crank arm attached to the shaft drives a connecting rod. This is one of the simplest ways to create:

* Back-and-forth motion
* Up-and-down movement
* Rocking action
* Waving arms
* Moving heads
* Sliding mechanisms

The distance from the shaft center to the connecting-rod attachment point determines the amount of travel.

A longer crank radius produces greater movement but also increases the load on the motor.

=== Cam ===

A cam is an off-center or specially shaped disk attached to the rotating shaft.

A follower riding against the cam can create:

* Lifting and dropping motion
* Irregular movement
* Pauses or dwell periods
* Repeating character motions

Different cam profiles produce different motion patterns.

=== Eccentric ===

An eccentric is similar to a crank but often uses a round disk mounted off-center. It produces smooth repeating motion and can be useful for:

* Shaking
* Vibrating
* Rocking
* Pumping
* Gentle vertical movement

=== Linkages ===

Additional levers and pivots can increase, reduce, reverse, or redirect motion.

Linkages may be used to:

* Move several parts from one motor
* Create mirrored motion
* Change rotary motion into linear travel
* Increase or reduce the travel distance
* Place the motor away from the visible prop

=== Chain, Belt, or Gear Drive ===

A wiper motor can also drive:

* Roller chains
* Timing belts
* Pulleys
* Sprockets
* Gears
* Turntables
* Conveyor rollers

These methods are useful for continuous-motion projects such as trains, carousels, conveyor belts, and rotating displays.

== Crank Radius and Travel ==

For a simple crank mechanism, the approximate total linear travel is twice the crank radius.

For example:

{| class="wikitable"
! Crank Radius
! Approximate Total Travel
|-
| 1 inch
| 2 inches
|-
| 2 inches
| 4 inches
|-
| 3 inches
| 6 inches
|}

This is only an approximation. The actual motion also depends on the connecting-rod length, lever geometry, and mounting positions.

Increasing the crank radius increases both travel and required torque.

[[File:Wiper_Christmas_Applications.png|900px|thumb|center|Figure 5 – Examples of Christmas and Halloween display applications powered by wiper motors.]]

== Choosing a Wiper Motor ==

When selecting a motor, consider:

* Operating voltage
* Running and stall current
* Output-shaft design
* Available mounting holes
* Speed
* Torque
* Physical size
* Direction-reversal requirements
* Internal park-switch wiring
* Weather exposure
* Availability of replacement motors

Rear-window wiper motors are often smaller and easier to mount than full-size front-wiper motors. Front-wiper motors usually provide greater torque but may be larger and have more complicated wiring.

Salvaged motors can be inexpensive, but buying identical motors may make replacement parts and documentation easier.

== Mounting the Motor ==

Wiper motors can produce significant torque. The mounting structure must be strong enough to resist twisting and vibration.

Use:

* Rigid metal, plywood, or reinforced plastic brackets
* Locknuts or thread-locking compound
* Large washers where needed
* Shaft supports or bearings for heavy rotating props
* Guards around exposed cranks, gears, chains, and belts

Do not rely on thin sheet plastic or a single small screw for heavily loaded mechanisms.

The motor shaft should not be used as the only support for a large prop. Use separate bearings to carry the prop's weight and let the motor provide rotation through a coupler, belt, chain, or gear.

== Mechanical Stops and Limit Switches ==

A moving prop should not rely on the motor stall condition as its normal stopping method.

Mechanical stops can prevent excessive travel, while limit switches can disconnect or reverse the motor before damage occurs.

Limit switches are especially useful for:

* Doors
* Lifting mechanisms
* Sliding scenery
* Long crank systems
* Props with restricted travel
* Reversing mechanisms

For unattended operation, consider using both electrical limit switches and physical backup stops.

== Weather Protection ==

Although automotive motors are designed for a harsh environment, they are not necessarily waterproof when mounted in a different orientation or used with exposed terminals.

Protect the motor and wiring from:

* Rain
* Snow
* Standing water
* Road salt residue
* Condensation
* Corrosion
* Ice accumulation

Mount the motor so water cannot collect around the shaft or electrical terminals. Use drip loops, sealed connectors, and a ventilated weather-resistant enclosure where practical.

Do not completely seal a warm motor in an airtight container without considering heat buildup and condensation.

== Safety ==

Wiper motors can move heavy mechanisms with enough force to pinch fingers, catch clothing, damage props, or injure spectators.

'''⚠️ Warning:'''

Treat every moving linkage as a potential pinch or crush hazard.

Recommended safety practices include:

* Guard exposed gears, chains, belts, and crank arms.
* Keep hands clear while power is connected.
* Use a master disconnect switch.
* Fuse each motor circuit appropriately.
* Secure loose wires away from moving parts.
* Use physical barriers to keep spectators away.
* Test at reduced voltage or speed first.
* Stop immediately if the mechanism binds or makes unusual noise.
* Do not operate damaged or overheated motors.
* Design linkages so a single loose fastener cannot release a heavy prop.

Outdoor public displays should be designed so a person cannot easily reach a moving mechanism.

== Controlling Wiper Motors ==

Wiper motors may be controlled with:

* Manual switches
* Mechanical timers
* Relays
* Solid-state DC motor controllers
* PWM speed controllers
* Reversible H-bridge drivers
* Arduino
* ESP8266
* ESP32
* Raspberry Pi
* Falcon Player-compatible control systems
* Show-control relays or outputs

A microcontroller typically sends low-current control signals to a suitable motor driver, relay, or H-bridge. The motor receives power from a separate supply.

When integrating movement with a synchronized show, acceleration, deceleration, and mechanical travel time must be considered. Unlike a servo or stepper motor, a basic wiper motor does not inherently know its exact position.

Position feedback can be added using:

* Limit switches
* Hall-effect sensors
* Optical sensors
* Encoders
* The original park switch
* Current sensing for jam detection

== Comparing Wiper Motors, Servos and Stepper Motors ==

{| class="wikitable"
! Feature
! Wiper Motor
! Servo
! Stepper Motor
|-
| Continuous Rotation
| Yes
| Some types
| Yes
|-
| Precise Positioning
| No, unless feedback is added
| Yes
| Yes, while steps are not missed
|-
| Typical Torque
| High
| Low to medium
| Medium to high
|-
| Control Complexity
| Low to medium
| Low
| Medium
|-
| Best Use
| Large moving props and continuous mechanisms
| Small controlled movements
| Precise, repeatable positioning
|-
| Position Feedback
| Usually external
| Built in
| Usually none
|-
| Common Supply
| 12 or 24 V DC
| Approximately 5 to 8 V DC
| Depends on motor and driver
|}

Choose a wiper motor when strength, durability, and simple continuous motion matter more than exact positioning.

Choose a servo for small mechanisms that must move directly to a known angle.

Choose a stepper motor when repeatable position, speed, and controlled motion are required.

[[File:Wiper_Motor_Comparison.png|900px|thumb|center|Figure 6 – Comparison of wiper motors, servos, and stepper motors.]]

== Lessons Learned ==

* Test salvaged motors before building the final mechanism.
* Identify all terminals before applying power.
* Do not assume the motor housing is always ground.
* Size the power supply and controller for startup and stall current.
* Use PWM rather than resistors for speed control.
* Start with a small crank radius and increase it only if more travel is needed.
* Support heavy props with separate bearings.
* Use flexible couplers when shaft alignment is imperfect.
* Balance rotating loads before increasing speed.
* Guard all pinch points and moving linkages.
* Use limit switches when a mechanism has restricted travel.
* Test the mechanism without decorations before final assembly.
* Keep replacement motors or compatible substitutes available.
* Never depend on a stalled motor as a normal mechanical stop.

== See Also ==

* [[How to add Motion to your Display]]
* [[Servos]]
* [[Stepper Motors]]
* [[Cheap ULN2803A Motor Driver]]

File:Wiper Motor Comparison.png

2026-07-22T15:44:12Z

ErnieHorning:

File:Wiper Christmas Applications.png

2026-07-22T15:43:59Z

ErnieHorning:

File:Wiper PWM Speed Control.png

2026-07-22T15:43:46Z

ErnieHorning:

File:Wiper Common Linkages.png

2026-07-22T15:43:27Z

ErnieHorning:

File:Wiper Crank Linkage.png

2026-07-22T15:43:10Z

ErnieHorning:

File:Wiper Common Motors.png

2026-07-22T15:42:54Z

ErnieHorning:

Wiper Motors

2026-07-22T15:19:01Z

ErnieHorning: Expanded and modernized the Wiper Motors article. Added organized explanations of motor operation, park-switch wiring, PWM speed control, direction reversing, motion linkages, power requirements, mounting, weather protection, safety, controller options, application videos, motor comparisons, and lessons learned.

Wiper motors are rugged, inexpensive DC gearmotors originally designed to operate automotive windshield wipers. Because they provide high torque, low speed, and continuous rotation, they have become popular workhorses for animated Christmas and Halloween displays.

They are especially useful for larger props that need dependable mechanical movement without precise electronic positioning. With the proper linkage, a wiper motor can create rotating, rocking, lifting, sliding, or back-and-forth motion.

== How Wiper Motors Work ==

Although windshield wipers move back and forth, the motor itself normally rotates continuously in one direction. A crank, linkage, or gear mechanism converts that rotary motion into the sweeping movement of the wiper arms.

This same principle makes wiper motors useful for animated display props. By attaching a crank arm, cam, connecting rod, or other mechanism to the motor shaft, continuous rotation can be converted into many different kinds of motion.

Wiper motors normally operate from low-voltage DC power, commonly 12 volts in passenger vehicles and sometimes 24 volts in larger vehicles.

== Why Wiper Motors Are Popular ==

Wiper motors offer several advantages for animated displays:

* High torque at low speed
* Rugged automotive construction
* Designed for long operating periods
* Widely available new, used, or salvaged
* Simple DC power requirements
* Reversible rotation on many models
* Easy speed control with a suitable PWM controller
* Strong enough for many medium and large props
* Often include built-in gear reduction

They are commonly used when a hobby servo is too small and a stepper motor would add unnecessary complexity.

== Common Applications ==

Wiper motors have been used in many animated Christmas and Halloween projects.

Examples include:

* [https://youtu.be/e3p6pAzczeU Rotating antenna dishes]
* [https://youtu.be/ed0nvu4U2IY Carousels]
* [https://youtu.be/zsRVe6O7oVE Trains]
* [https://youtu.be/PYk2SkbMg3w Conveyor belts]

Other possible applications include:

* Ferris wheels
* Rotating signs
* Windmills
* Animated figures
* Moving arms and heads
* Rocking props
* Opening doors
* Moving scenery
* Crank-driven characters
* Lifting and lowering mechanisms
* Oscillating displays
* Mechanical shop or workshop scenes

These short demonstration videos are useful because they show how the same basic motor can be adapted to many very different display mechanisms.

== Continuous Rotation and Direction ==

A wiper motor normally rotates continuously rather than moving to a commanded position.

Because it is a DC motor, the direction of rotation can often be reversed by reversing the polarity applied to the motor. However, not every automotive wiper motor is wired internally in the same way.

Some motors include:

* Multiple speed terminals
* An internal parking switch
* A chassis-ground connection
* Separate field or brush connections
* Internal wiring that complicates simple polarity reversal

'''⚠️ Warning:'''

Do not assume that every terminal on a salvaged wiper motor can be connected directly to power. Identify the motor terminals and internal park-switch wiring before applying voltage.

== Motor Terminals and Park Switches ==

Many automotive wiper motors include an internal park switch. In a vehicle, this switch keeps the motor running after the driver turns the wipers off until the blades return to their normal parked position.

Depending on the motor design, the park circuit may:

* Continue supplying power until a specific shaft position is reached
* Connect internally to one of the speed terminals
* Use the metal motor housing as ground
* Create unexpected behavior when used outside the vehicle

For display use, the park switch may be ignored, disconnected, or intentionally incorporated into the mechanism. Always test the motor on a current-limited supply or with an appropriate fuse before permanent wiring.

== Speed Control ==

Wiper motor speed can be controlled by changing the effective voltage applied to the motor.

The preferred method is usually Pulse Width Modulation (PWM). A PWM controller rapidly switches the motor power on and off while varying the percentage of time the power remains on.

PWM control provides several advantages:

* Better low-speed torque than a simple resistor
* Less wasted heat
* Wide speed adjustment
* Easy control from a knob, switch, relay, or microcontroller
* Better efficiency than dropping voltage through a linear regulator

A controller must be rated for the motor's startup and stall current, not just its normal running current.

'''💡 Note:'''

A motor that draws only a few amps while running may draw several times that amount when starting or if the mechanism jams.

== Power Requirements ==

Most passenger-car wiper motors operate from approximately 12 volts DC. Motors from trucks, buses, or industrial equipment may use 24 volts.

Before choosing a power supply, determine:

* Motor operating voltage
* Normal running current
* Startup current
* Stall current
* Expected mechanical load
* Number of motors powered at the same time

The power supply and wiring should be sized for the highest realistic current demand.

Use:

* Properly sized wire
* A fuse near the power source
* Secure terminals
* Strain relief
* Weather-resistant enclosures for outdoor use

Do not power a wiper motor directly from a microcontroller, ESP board, or small relay module unless the switching device is specifically rated for the motor current.

== Reversing Direction ==

Many wiper motors can be reversed by reversing the polarity at the motor terminals.

Direction control may be accomplished with:

* A double-pole, double-throw switch
* Reversing relays
* An H-bridge motor driver
* A dedicated reversible DC motor controller

When using relays or an H-bridge, include appropriate protection for inductive voltage spikes.

'''⚠️ Warning:'''

Never reverse a heavily loaded motor instantly at full speed. Stop the motor first or allow a controlled deceleration period to reduce mechanical shock and current surges.

== Creating Different Motions ==

The motor shaft provides continuous rotary motion. Mechanical linkages convert that rotation into the movement required by the prop.

=== Crank and Connecting Rod ===

A crank arm attached to the shaft drives a connecting rod. This is one of the simplest ways to create:

* Back-and-forth motion
* Up-and-down movement
* Rocking action
* Waving arms
* Moving heads
* Sliding mechanisms

The distance from the shaft center to the connecting-rod attachment point determines the amount of travel.

A longer crank radius produces greater movement but also increases the load on the motor.

=== Cam ===

A cam is an off-center or specially shaped disk attached to the rotating shaft.

A follower riding against the cam can create:

* Lifting and dropping motion
* Irregular movement
* Pauses or dwell periods
* Repeating character motions

Different cam profiles produce different motion patterns.

=== Eccentric ===

An eccentric is similar to a crank but often uses a round disk mounted off-center. It produces smooth repeating motion and can be useful for:

* Shaking
* Vibrating
* Rocking
* Pumping
* Gentle vertical movement

=== Linkages ===

Additional levers and pivots can increase, reduce, reverse, or redirect motion.

Linkages may be used to:

* Move several parts from one motor
* Create mirrored motion
* Change rotary motion into linear travel
* Increase or reduce the travel distance
* Place the motor away from the visible prop

=== Chain, Belt, or Gear Drive ===

A wiper motor can also drive:

* Roller chains
* Timing belts
* Pulleys
* Sprockets
* Gears
* Turntables
* Conveyor rollers

These methods are useful for continuous-motion projects such as trains, carousels, conveyor belts, and rotating displays.

== Crank Radius and Travel ==

For a simple crank mechanism, the approximate total linear travel is twice the crank radius.

For example:

{| class="wikitable"
! Crank Radius
! Approximate Total Travel
|-
| 1 inch
| 2 inches
|-
| 2 inches
| 4 inches
|-
| 3 inches
| 6 inches
|}

This is only an approximation. The actual motion also depends on the connecting-rod length, lever geometry, and mounting positions.

Increasing the crank radius increases both travel and required torque.

== Choosing a Wiper Motor ==

When selecting a motor, consider:

* Operating voltage
* Running and stall current
* Output-shaft design
* Available mounting holes
* Speed
* Torque
* Physical size
* Direction-reversal requirements
* Internal park-switch wiring
* Weather exposure
* Availability of replacement motors

Rear-window wiper motors are often smaller and easier to mount than full-size front-wiper motors. Front-wiper motors usually provide greater torque but may be larger and have more complicated wiring.

Salvaged motors can be inexpensive, but buying identical motors may make replacement parts and documentation easier.

== Mounting the Motor ==

Wiper motors can produce significant torque. The mounting structure must be strong enough to resist twisting and vibration.

Use:

* Rigid metal, plywood, or reinforced plastic brackets
* Locknuts or thread-locking compound
* Large washers where needed
* Shaft supports or bearings for heavy rotating props
* Guards around exposed cranks, gears, chains, and belts

Do not rely on thin sheet plastic or a single small screw for heavily loaded mechanisms.

The motor shaft should not be used as the only support for a large prop. Use separate bearings to carry the prop's weight and let the motor provide rotation through a coupler, belt, chain, or gear.

== Mechanical Stops and Limit Switches ==

A moving prop should not rely on the motor stall condition as its normal stopping method.

Mechanical stops can prevent excessive travel, while limit switches can disconnect or reverse the motor before damage occurs.

Limit switches are especially useful for:

* Doors
* Lifting mechanisms
* Sliding scenery
* Long crank systems
* Props with restricted travel
* Reversing mechanisms

For unattended operation, consider using both electrical limit switches and physical backup stops.

== Weather Protection ==

Although automotive motors are designed for a harsh environment, they are not necessarily waterproof when mounted in a different orientation or used with exposed terminals.

Protect the motor and wiring from:

* Rain
* Snow
* Standing water
* Road salt residue
* Condensation
* Corrosion
* Ice accumulation

Mount the motor so water cannot collect around the shaft or electrical terminals. Use drip loops, sealed connectors, and a ventilated weather-resistant enclosure where practical.

Do not completely seal a warm motor in an airtight container without considering heat buildup and condensation.

== Safety ==

Wiper motors can move heavy mechanisms with enough force to pinch fingers, catch clothing, damage props, or injure spectators.

'''⚠️ Warning:'''

Treat every moving linkage as a potential pinch or crush hazard.

Recommended safety practices include:

* Guard exposed gears, chains, belts, and crank arms.
* Keep hands clear while power is connected.
* Use a master disconnect switch.
* Fuse each motor circuit appropriately.
* Secure loose wires away from moving parts.
* Use physical barriers to keep spectators away.
* Test at reduced voltage or speed first.
* Stop immediately if the mechanism binds or makes unusual noise.
* Do not operate damaged or overheated motors.
* Design linkages so a single loose fastener cannot release a heavy prop.

Outdoor public displays should be designed so a person cannot easily reach a moving mechanism.

== Controlling Wiper Motors ==

Wiper motors may be controlled with:

* Manual switches
* Mechanical timers
* Relays
* Solid-state DC motor controllers
* PWM speed controllers
* Reversible H-bridge drivers
* Arduino
* ESP8266
* ESP32
* Raspberry Pi
* Falcon Player-compatible control systems
* Show-control relays or outputs

A microcontroller typically sends low-current control signals to a suitable motor driver, relay, or H-bridge. The motor receives power from a separate supply.

When integrating movement with a synchronized show, acceleration, deceleration, and mechanical travel time must be considered. Unlike a servo or stepper motor, a basic wiper motor does not inherently know its exact position.

Position feedback can be added using:

* Limit switches
* Hall-effect sensors
* Optical sensors
* Encoders
* The original park switch
* Current sensing for jam detection

== Comparing Wiper Motors, Servos and Stepper Motors ==

{| class="wikitable"
! Feature
! Wiper Motor
! Servo
! Stepper Motor
|-
| Continuous Rotation
| Yes
| Some types
| Yes
|-
| Precise Positioning
| No, unless feedback is added
| Yes
| Yes, while steps are not missed
|-
| Typical Torque
| High
| Low to medium
| Medium to high
|-
| Control Complexity
| Low to medium
| Low
| Medium
|-
| Best Use
| Large moving props and continuous mechanisms
| Small controlled movements
| Precise, repeatable positioning
|-
| Position Feedback
| Usually external
| Built in
| Usually none
|-
| Common Supply
| 12 or 24 V DC
| Approximately 5 to 8 V DC
| Depends on motor and driver
|}

Choose a wiper motor when strength, durability, and simple continuous motion matter more than exact positioning.

Choose a servo for small mechanisms that must move directly to a known angle.

Choose a stepper motor when repeatable position, speed, and controlled motion are required.

== Lessons Learned ==

* Test salvaged motors before building the final mechanism.
* Identify all terminals before applying power.
* Do not assume the motor housing is always ground.
* Size the power supply and controller for startup and stall current.
* Use PWM rather than resistors for speed control.
* Start with a small crank radius and increase it only if more travel is needed.
* Support heavy props with separate bearings.
* Use flexible couplers when shaft alignment is imperfect.
* Balance rotating loads before increasing speed.
* Guard all pinch points and moving linkages.
* Use limit switches when a mechanism has restricted travel.
* Test the mechanism without decorations before final assembly.
* Keep replacement motors or compatible substitutes available.
* Never depend on a stalled motor as a normal mechanical stop.

== See Also ==

* [[How to add Motion to your Display]]
* [[Servos]]
* [[Stepper Motors]]
* [[Cheap ULN2803A Motor Driver]]

Stepper Motors

2026-07-22T15:00:43Z

ErnieHorning: Expanded and illustrated the Stepper Motors reference article. Added six technical graphics, detailed explanations of motor operation, winding types, driver boards, stepping modes, power requirements, homing, mechanical design, Christmas display applications, and updated safety guidance.

Stepper motors are widely used when precise, repeatable rotary motion is required. Unlike an ordinary DC motor, a stepper motor moves in small, fixed increments called ''steps''. This allows a controller to determine shaft position by counting the electrical pulses sent to the motor.

Stepper motors are commonly found in 3D printers, CNC machines, laser engravers, camera sliders, and robotic equipment. They are also useful in animated Christmas displays where controlled, repeatable movement is important.

[[File:Stepper_Common_Motors.png|800px|thumb|center|'''Figure 1.''' Common hobby stepper motors suitable for small through heavy-duty motion projects.]]

== How Stepper Motors Work ==

A stepper motor contains a rotor surrounded by multiple electromagnetic stator coils. The driver energizes these coils in a controlled sequence, creating magnetic fields that pull the rotor from one position to the next.

Instead of spinning continuously whenever voltage is applied, each electrical pulse advances the motor by a known amount. Reversing the coil sequence reverses the motor's direction, while changing the pulse rate changes its speed.

Common full-step angles include:

* 1.8° (200 steps per revolution)
* 0.9° (400 steps per revolution)

Because every pulse represents a known amount of rotation, the controller can position the motor by counting steps. However, most basic stepper systems operate without position feedback. If the motor is overloaded and misses steps, the controller may no longer know its true position until the mechanism is returned to a known home position.

Figure 2 illustrates the basic relationship between electrical pulses, coil energization, and rotor movement.

[[File:Stepper_How_It_Works.png|800px|thumb|center|'''Figure 2.''' Electrical pulses energize the motor coils in sequence, causing the rotor to move one step at a time.]]

== Advantages ==

* Excellent positioning accuracy
* Repeatable motion
* High holding torque at low speed
* Can rotate continuously
* Easy control of speed and direction
* Well suited for computer-controlled movement
* Widely available in many sizes and torque ratings

== Limitations ==

* Less efficient than many DC motor systems
* Torque decreases as speed increases
* Can miss steps if overloaded or accelerated too quickly
* Usually requires a dedicated driver board
* May produce vibration or audible noise
* Holding position continuously can generate heat
* A home or limit switch may be needed to establish a known starting position

== Stepper Motor Types ==

The two most common winding arrangements are unipolar and bipolar. Figure 4 compares their wiring, drivers, and typical uses.

=== Unipolar ===

Unipolar motors have center-tapped windings and commonly use five or six wires. They are relatively easy to drive because current does not need to reverse through an entire winding.

The inexpensive geared 28BYJ-48 is a common unipolar stepper motor. It is frequently supplied with a ULN2003 driver board and works well for lightweight props and experimental projects.

=== Bipolar ===

Bipolar motors normally use four wires and do not have center-tapped windings. Current must be reversed through each winding, requiring an H-bridge-style stepper driver.

Bipolar motors generally provide better torque and efficiency than similarly sized unipolar motors. Common examples include NEMA 17, NEMA 23, and NEMA 34 motors.

[[File:Stepper_Unipolar_vs_Bipolar.png|800px|thumb|center|'''Figure 4.''' Comparison of unipolar and bipolar stepper motors, including winding arrangements, wiring, drivers, and typical applications.]]

== Stepper Driver Boards ==

A microcontroller cannot normally power a stepper motor directly. The controller provides low-current logic signals, while a driver board switches the higher motor voltage and current through the windings.

Common driver boards include:

* '''ULN2003''' – commonly used with small five-wire unipolar motors such as the 28BYJ-48
* '''A4988''' – inexpensive bipolar driver with adjustable current limiting and microstepping
* '''DRV8825''' – similar to the A4988 but supports higher voltage, current, and finer microstepping
* '''TMC2209''' – quiet, advanced bipolar driver commonly used in 3D printers
* '''TB6600''' – larger external driver commonly used with NEMA 23 and other higher-current motors

Select a driver that supports the motor's winding type, voltage, and rated phase current. Adjustable-current drivers must be configured correctly before normal operation.

Figure 3 compares several commonly available hobby and higher-power driver boards.

[[File:Stepper_Driver_Boards.png|800px|thumb|center|'''Figure 3.''' Common stepper motor driver boards and their typical motor types, control signals, and applications.]]

'''⚠️ Warning:'''

Do not connect or disconnect a stepper motor while power is applied to the driver. Doing so can create voltage spikes that may damage the driver.

== Full-Step, Half-Step and Microstepping ==

Many bipolar stepper drivers support several stepping modes.

=== Full-Step ===

Full-step operation moves the motor through its normal mechanical step angle. A typical 1.8° motor therefore requires 200 full steps for one revolution.

Full-step operation generally provides strong torque but may produce more vibration and noise.

=== Half-Step ===

Half-step operation alternates the winding sequence to create positions between the normal full steps. A 1.8° motor operating in half-step mode produces approximately 400 commanded positions per revolution.

Half-stepping usually produces smoother motion and better positioning resolution than full-step operation.

=== Microstepping ===

Microstepping controls winding current in small increments to create many intermediate magnetic positions. Common settings include 1/8, 1/16, and 1/32 microstepping.

Microstepping can greatly reduce vibration and noise, but the additional commanded positions do not always provide an equal increase in true mechanical accuracy. Available incremental torque also decreases as the microstep size becomes smaller.

Figure 5 compares the major stepping modes.

[[File:Stepper_Stepping_Modes.png|800px|thumb|center|'''Figure 5.''' Full-step, half-step, and microstepping modes compared by resolution, smoothness, torque, and noise.]]

== Power Requirements ==

Stepper motors should normally be powered from a dedicated power supply connected to the motor driver.

'''💡 Note:'''

Do not power a stepper motor directly from a microcontroller GPIO pin. GPIO pins provide control signals only; the motor current must come from an appropriate driver and power supply.

When planning the power system:

* Verify the driver's supported supply-voltage range.
* Set the driver's current limit to match the motor.
* Provide adequate ventilation or a heatsink when required.
* Use wire sized for the motor current.
* Connect the controller and driver grounds together when separate supplies are used.
* Add suitable fusing for the wiring and power source.

The power-supply voltage does not always match the voltage printed on a low-resistance bipolar stepper motor. Current-limiting drivers often use a higher supply voltage to improve high-speed performance while regulating the actual winding current.

== Common Christmas Display Applications ==

Stepper motors work particularly well when a display element must move to known positions repeatedly or remain synchronized with a sequence.

Possible applications include:

* Rotating stars and tree toppers
* Spinning snowflakes
* Animated arms, heads, and figures
* Moving signs and letters
* Precision turntables
* Kinetic sculptures and windmill-style props
* Moving scenery, trains, bridges, and platforms
* Mechanical effects requiring repeatable positioning

Figure 6 shows several ways stepper motors can add controlled motion to Christmas displays.

[[File:Stepper_Christmas_Applications.png|800px|thumb|center|'''Figure 6.''' Typical Christmas display applications for stepper motors, along with basic design and control considerations.]]

== Controlling Stepper Motors ==

Stepper motors are commonly controlled using:

* Arduino
* ESP8266
* ESP32
* Raspberry Pi
* CNC controller boards
* Dedicated motion controllers
* Falcon Player-compatible control hardware

Many bipolar drivers use simple control signals:

* '''STEP''' – each pulse commands one step or microstep
* '''DIR''' – selects the direction of rotation
* '''ENABLE''' – enables or disables the driver output

Software libraries such as AccelStepper can provide controlled acceleration, deceleration, speed, and positioning. Gradual acceleration is especially important when moving heavier props because a stepper motor may stall or miss steps if commanded to reach full speed instantly.

Integration with xLights normally requires suitable controller firmware or intermediate software capable of translating show data into motor-position or motion commands. A stepper driver cannot be connected directly to an xLights network without a compatible controller.

== Homing and Limit Switches ==

Because most stepper systems do not inherently know the shaft's physical position after power-up, a home switch is often used.

During startup, the mechanism moves slowly toward the switch until the switch activates. The controller then assigns that location as a known zero or home position.

Limit switches may also be used to:

* Prevent travel beyond mechanical boundaries
* Detect jams or unexpected motion
* Establish repeatable startup alignment
* Protect wiring, linkages, and moving scenery

A physical stop should not normally be used as the only homing method unless the motor, driver current, and mechanism are specifically designed to tolerate stalling.

== Choosing a Stepper Motor ==

When selecting a motor, consider:

* Required holding and running torque
* Expected speed
* Supply voltage and available current
* Motor phase-current rating
* Shaft diameter and length
* Mounting-hole pattern
* Physical dimensions
* Gear reduction, if required
* Driver compatibility
* Outdoor temperature and moisture protection
* Load balance and mechanical friction
* Whether continuous rotation or limited travel is required

A larger motor is not automatically better. Excess motor weight, current, and holding torque may increase cost and mechanical stress without improving the finished prop.

== Mechanical Design Considerations ==

Reliable stepper operation depends as much on the mechanism as on the electronics.

* Keep rotating loads balanced.
* Use rigid motor mounts.
* Avoid side-loading the motor shaft.
* Use bearings to support large or heavy props.
* Use flexible shaft couplers where minor misalignment is unavoidable.
* Minimize backlash in gears and linkages when positioning accuracy matters.
* Protect moving parts from fingers, clothing, wires, snow, and ice.
* Test the complete mechanism at low speed before adding decorations or lights.

For continuous rotation of an illuminated prop, a slip ring may be needed to carry power and data across the rotating joint.

== Lessons Learned ==

* Select the motor and driver as a matched system.
* Set the driver current limit before extended testing.
* Use adequate cooling for larger drivers.
* Start with conservative speed and acceleration settings.
* Accelerate heavy loads gradually to avoid missed steps.
* Balance rotating props before increasing speed.
* Add a home switch whenever absolute position matters.
* Test the complete mechanism before decorating the prop.
* Keep spare drivers available because incorrect wiring can damage them quickly.
* Never connect or disconnect motor wiring while the driver is powered.

== See Also ==

* [[How to add Motion to your Display]]
* [[Servos]]
* [[Wiper Motors]]
* [[Cheap ULN2803A Motor Driver]]

File:Stepper Christmas Applications.png

2026-07-22T14:51:21Z

ErnieHorning:

File:Stepper Stepping Modes.png

2026-07-22T14:51:06Z

ErnieHorning:

File:Stepper Unipolar vs Bipolar.png

2026-07-22T14:50:47Z

ErnieHorning:

File:Stepper Driver Boards.png

2026-07-22T14:50:32Z

ErnieHorning:

File:Stepper How It Works.png

2026-07-22T14:50:16Z

ErnieHorning:

File:Stepper Common Motors.png

2026-07-22T14:50:00Z

ErnieHorning:

Stepper Motors

2026-07-22T14:05:13Z

ErnieHorning: Created and expanded the Stepper Motors reference article. Added explanations of stepper motor operation, motor types, driver boards, stepping modes, power requirements, applications, selection guidance, lessons learned, and related links.

Stepper motors are widely used when precise, repeatable rotary motion is required. Unlike ordinary DC motors, a stepper motor moves in small, fixed increments (steps), allowing accurate position control without the need for a feedback sensor in many applications.

Stepper motors are commonly found in 3D printers, CNC machines, laser engravers, camera sliders, and robotic equipment. They can also be used in animated holiday displays where smooth, repeatable movement is important.

== How Stepper Motors Work ==

A stepper motor contains multiple electromagnetic coils. By energizing these coils in a specific sequence, the motor rotates one small step at a time.

Instead of continuously spinning like a DC motor, each electrical pulse moves the shaft a precise amount.

Common step angles include:

* 1.8° (200 steps per revolution)
* 0.9° (400 steps per revolution)

Because every pulse represents a known amount of rotation, a controller can accurately position the motor simply by counting steps.

== Advantages ==

* Excellent positioning accuracy
* Repeatable motion
* High holding torque
* Can rotate continuously
* Well suited for computer-controlled movement

== Limitations ==

* Less efficient than DC motors
* Torque decreases as speed increases
* Can miss steps if overloaded
* Usually requires a dedicated driver board

== Stepper Motor Types ==

=== Unipolar ===

Unipolar motors are easy to drive and are commonly used with inexpensive ULN2003 driver boards. The popular 28BYJ-48 geared stepper motor is a common example.

=== Bipolar ===

Bipolar steppers provide higher torque but require H-bridge style driver electronics such as the A4988 or DRV8825.

== Stepper Drivers ==

Common driver boards include:

* ULN2003
* A4988
* DRV8825
* TMC2209
* TB6600 (larger motors)

Select a driver appropriate for the motor's voltage and current requirements.

== Full-Step, Half-Step and Microstepping ==

Many drivers support different stepping modes.

* Full-step provides maximum speed.
* Half-step increases positioning resolution.
* Microstepping divides each full step into many smaller steps, producing smoother motion and quieter operation.

== Power Requirements ==

Stepper motors should normally be powered from a dedicated power supply.

'''💡 Note:'''

Do not power stepper motors directly from a microcontroller. The GPIO pins provide control signals only; the motor current must come from an appropriate driver.

Always verify that the driver's current limit is properly adjusted before connecting the motor.

== Common Christmas Display Applications ==

Stepper motors work well for:

* Rotating signs
* Animated stars
* Precision turntables
* Camera pan mechanisms
* Santa workshop animations
* Moving scenery
* Mechanical displays requiring repeatable positioning

== Controlling Stepper Motors ==

Steppers are commonly controlled using:

* Arduino
* ESP8266
* ESP32
* Raspberry Pi
* CNC controller boards
* Dedicated motion controllers

Many software libraries are available, including AccelStepper, allowing smooth acceleration and deceleration.

== Choosing a Stepper Motor ==

When selecting a motor, consider:

* Required holding torque
* Supply voltage
* Current rating
* Shaft size
* Physical dimensions
* Required speed
* Driver compatibility

== Lessons Learned ==

* Select a driver before purchasing the motor.
* Use adequate cooling for larger drivers.
* Keep wiring short where practical.
* Accelerate heavy loads gradually to avoid missed steps.
* Use flexible couplers when driving mechanical loads.
* Test the complete mechanism before decorating the prop.

== See Also ==

* [[How to add Motion to your Display]]
* [[Servos]]
* [[Wiper Motors]]
* [[Cheap ULN2803A Motor Driver]]

Servos

2026-07-22T13:54:56Z

ErnieHorning: Expanded and modernized the Servos reference article. Added explanations of servo operation, PWM control, servo types, power requirements, applications, selection guidance, lessons learned, and related links while preserving the original information.

Servos are one of the simplest and least expensive ways to add motion to a holiday display. They are commonly used to animate figures, moving props, singing faces, opening doors, waving arms, and many other projects requiring controlled movement.

== Overview ==

A servo is a self-contained motor with built-in position control electronics. Most hobby servos have a limited range of motion, typically 90° or 180°, although continuous-rotation versions are also available.

Servos are widely used in radio-controlled cars, airplanes, boats, and robots because they provide accurate positioning without requiring complex control circuitry.

== How Servos Work ==

Unlike a standard DC motor, a servo contains:

* A DC motor
* A gear train
* A position sensor (typically a potentiometer)
* Internal control electronics

The controller compares the desired shaft position with the actual shaft position and automatically drives the motor until both match.

This closed-loop feedback system allows the servo to accurately hold its position.

== Servo Control ==

Most inexpensive hobby servos use Pulse Width Modulation (PWM) to determine the desired shaft position.

Instead of changing the voltage supplied to the motor, the controller sends a short control pulse approximately every 20 milliseconds (about 50 times per second).

Changing the pulse width changes the desired shaft position.

If the pulses stop, the servo no longer receives position updates and external forces may move the shaft. While valid control pulses are present, the servo continuously corrects its position and resists outside forces until it reaches its torque limit.

'''⚠️ Warning:'''

Holding a stalled servo against a heavy load for long periods can overheat and permanently damage the motor or gears.

== Typical Pulse Widths ==

The exact pulse widths vary slightly between manufacturers, but most hobby servos use values similar to the following:

{| class="wikitable"
! Pulse Width
! Typical Position
|-
| 1.0 ms
| 0°
|-
| 1.5 ms
| Center (90°)
|-
| 2.0 ms
| 180°
|}

The following illustration, originally adapted from an Arduino forum discussion, shows the relationship between pulse width and shaft position.

[[File:Servo_pulse_width.png|600px|thumb|center|Typical hobby servo pulse widths and corresponding shaft positions.]]

== Servo Types ==

=== Standard Position Servos ===

These are the most common servos used in holiday displays. The shaft moves to a commanded position and holds that position until a new command is received.

=== Continuous Rotation Servos ===

Continuous rotation servos do not control position. Instead, the control signal determines the speed and direction of rotation.

These are useful for spinning props, rotating signs, and other applications requiring continuous movement.

== Power Requirements ==

Most hobby servos operate from 4.8 to 6 volts, although larger digital servos may support higher voltages.

'''💡 Note:'''

Servos can draw several times their normal operating current when starting or when stalled. Multiple servos should normally be powered from a dedicated power supply rather than directly from a microcontroller.

== Common Christmas Display Applications ==

Servos are frequently used for:

* Waving figures
* Singing faces
* Moving arms and heads
* Opening doors or windows
* Animated presents
* Rotating signs
* Small mechanical props

== Choosing a Servo ==

When selecting a servo, consider:

* Required torque
* Range of motion
* Operating voltage
* Gear material (plastic or metal)
* Environmental protection if used outdoors

Metal gear servos generally provide greater durability for larger or heavier props.

== Lessons Learned ==

* Do not force a servo beyond its mechanical limits.
* Allow adequate power capacity for startup and stall current.
* Test the mechanism before attaching decorations.
* Protect outdoor servos from moisture whenever possible.
* Continuous-rotation servos control speed, not position.

== See Also ==

* [[How to add Motion to your Display]]
* [[Stepper Motors]]
* [[Wiper Motors]]
* [[Cheap ULN2803A Motor Driver]]

How to add Motion to your Display

2026-07-22T13:45:48Z

ErnieHorning: Added an introduction and improved the formatting of the Animatronics PDF reference page.

This document was generously provided by DanoNJ and contains additional information on animatronics and motion techniques for holiday displays.

== PDF Reference ==

* '''[[Media:Animatronics.pdf|Animatronics.pdf]]''' — Courtesy of DanoNJ.

Animatronics

2026-07-22T13:41:21Z

ErnieHorning: Deleted unnecessary categories.

This page serves as a central index for animatronics-related articles and projects used in animated Christmas displays.

Whether you're adding simple movement to an existing prop or building a fully animated display, the topics below provide information on the most common motor types, controllers, and construction techniques used by the DIYChristmas community.

== Animatronics Topics ==

* [[How to add Motion to your Display]]
* [[Servos]]
* [[Stepper Motors]]
* [[Wiper Motors]]
* [[Cheap ULN2803A Motor Driver]]
* [[Projects/PDFs]]

== Related Topics ==

As additional animatronics articles are created, they can be added to this page to make them easier to find.

Animatronics

2026-07-22T13:37:32Z

ErnieHorning: Modernized the Animatronics navigation page. Added introductory text, improved organization, updated formatting, and categorized the page.

Animated Noel Sign

2026-07-22T13:30:41Z

ErnieHorning: Expanded and modernized the animated NOEL sign article. Added organized construction sections, materials and safety information, controller alternatives, image captions, modern lighting options, maintenance guidance, and lessons learned while preserving the original project.

Here's a project that's easy and fun to build, yet large enough to span nearly the full width of a garage door. The finished display combines a continuously illuminated “NOEL” sign with three independently animated bells.

A video of the completed display can be viewed [https://vimeo.com/133000611 '''HERE'''].

== Overview ==

This project uses the spring grid from an old queen-size mattress as the structural frame. Rope light forms the word “NOEL” and outlines three bells made from 9-gauge galvanized wire.

The original display used four lighting channels:

* One channel for the “NOEL” lettering
* One channel for each of the three bells

The lettering remained continuously illuminated while the bells were animated in sequence.

== Materials and Tools ==

=== Materials ===

* Spring grid from an old queen-size mattress
* 9-gauge galvanized wire
* Rope light
* Transparent Metalcast paint, if colored rope light is desired
* Black electrical tape
* Heavy-duty zip ties
* Four-channel controller or equivalent
* Electrical wire and connectors appropriate for the selected lighting system
* Mounting hardware suitable for the installation location

=== Tools ===

* Wire cutters
* Pliers
* Welding equipment
* Safety glasses
* Work gloves
* Basic electrical tools
* Drill and mounting tools as required

'''⚠️ Warning:'''

Old mattress frames and cut wire can have sharp edges. Wear gloves and eye protection while dismantling the mattress and forming the wire. Use appropriate protective equipment while welding.

If AC rope light is used, all wiring, connectors, enclosures, and controllers must be rated for outdoor use and protected by a GFCI circuit.

== Controller Options ==

The original project used a DIGWDF 675-Plus controller. That controller is not required, however.

Any controller capable of independently switching four lighting circuits may be used:

* An AC controller for AC rope light
* A DC controller for low-voltage LED rope light
* A modern pixel or RGB controller if the design is adapted to addressable lighting

The original arrangement used one channel for the word “NOEL” and three channels for the bells.

== Preparing the Mattress Frame ==

Dismantle the mattress and remove the large spring grid that forms the internal support structure.

Remove any fabric, foam, padding, staples, clips, or other material attached to the spring frame.

Inspect the frame carefully for sharp wire ends, broken welds, or loose pieces. Repair or remove anything that could create a safety hazard.

The mattress spring grid becomes the foundation for the entire display.

== Building the Bells ==

Form three bell outlines from 9-gauge galvanized wire.

Each bell should be formed and welded as a separate piece. Keeping them separate makes the bells easier to shape and allows them to overlap when attached to the main frame.

The bells do not need to be identical, but their overall size and proportions should be similar enough to appear as a coordinated group.

[[File:4-wire.JPG|500px|thumb|center|Galvanized wire formed into the outlines used for the bells.]]

[[File:3bells.JPG|600px|thumb|center|The three completed bell frames before rope light was attached.]]

'''💡 Note:''' Equivalent wire may be substituted if it is stiff enough to hold its shape and suitable for welding or mechanical fastening.

== Forming the “NOEL” Lettering ==

Lay the mattress spring frame flat on a work surface.

Arrange the rope light across the frame to spell “NOEL.” Cursive lettering was selected for the original project because it required fewer sharp bends and was easier to form than block lettering.

Secure the rope light to the spring frame with zip ties.

Use enough ties to maintain the shape of the letters without crushing or sharply bending the rope light.

Sections of rope light that must pass between letters or cross the display without being visible can be covered with black electrical tape.

'''⚠️ Warning:'''

Do not cut rope light except at the manufacturer’s approved cutting intervals. Cutting it at the wrong location may damage the light or create an electrical hazard.

== Adding Rope Light to the Bells ==

Attach rope light around the perimeter of each wire bell.

Use zip ties at regular intervals to hold the rope light firmly against the wire frame.

Avoid tight bends, kinks, or stress near electrical connections.

Once the rope light is installed, attach the three bells to the mattress spring frame. Arrange and overlap them as desired.

The overlapping bells provide visual depth and make the large display more interesting.

== Coloring the Rope Light ==

Transparent Metalcast paint may be sprayed onto clear rope light to create bright colors while still allowing light to pass through.

Mask any areas that should remain unpainted, including electrical connections and portions intended to stay clear.

Apply several light coats rather than one heavy coat, allowing each coat to dry according to the paint manufacturer’s instructions.

Test the paint on a short unused section of rope light before applying it to the completed prop.

'''💡 Note:''' Paint compatibility can vary between rope-light jacket materials. A small test area should always be checked before painting the entire display.

== Installing the Controller ==

Mount the controller to the rear of the spring frame or in a nearby weather-resistant enclosure.

Connect the four outputs as follows:

* Channel 1 — “NOEL” lettering
* Channel 2 — Bell 1
* Channel 3 — Bell 2
* Channel 4 — Bell 3

Secure all wiring so it cannot rub against sharp metal edges or pull loose while the prop is being moved.

Use strain relief on all power and signal cables.

[[File:Controller-3.JPG|500px|thumb|center|The original DIGWDF 675-Plus controller mounted to the display frame.]]

== Original Animation Method ==

The original DIGWDF 675-Plus firmware was configured so that Channel 1 remained continuously on while Channels 2, 3, and 4 animated the three bells.

When the controller was powered:

* The word “NOEL” illuminated and remained on
* The three bells animated independently

The controller therefore operated as a self-contained display without requiring a separate show computer.

== Original Firmware ==

The original firmware for the 12F675 chip is preserved below for historical use and reference. Both the assembly source and HEX files are included.

[[File:NoelSign675Firmware.zip]]

== Modern Control Options ==

The original four-channel animation can be reproduced with many modern controllers.

Possible alternatives include:

* A four-channel AC lighting controller
* A low-voltage DC controller
* An ESP8266 or ESP32-based controller
* ESPixelStick
* WLED
* xLights-controlled outputs
* A small standalone sequencer

The lighting technology may also be updated while preserving the original design.

Possible modern lighting alternatives include:

* LED rope light
* Flexible LED neon
* RGB rope light
* Pixel strip
* Seed pixels
* Other addressable LED products

When converting to addressable pixels, the lettering and bells can be divided into virtual segments and animated with far more flexibility than the original four-channel design.

== Mounting and Installation ==

Because the completed display is nearly the width of a garage door, plan the mounting method before beginning construction.

The mattress spring frame provides many useful attachment points for brackets, hooks, wire, or other hardware.

Mount the prop to a structure capable of supporting its full weight and resisting expected wind, snow, and ice loads.

'''⚠️ Warning:'''

This completed prop is large and somewhat awkward to handle. Plan on having two people available when moving or installing it. Be sure the support frame and attachment points are strong enough to withstand wind and winter weather.

Route power and control wiring so it does not create a trip hazard or interfere with the operation of the garage door.

== Completed Display ==

[[File:Noel sign.png|700px|thumb|center|The completed animated “NOEL” sign with three illuminated bells.]]

The finished display is large, bright, and easily visible from the street. It demonstrates how recycled materials can become the foundation for a substantial animated Christmas prop.

== Storage and Maintenance ==

Inspect the display before each season.

Check for:

* Broken zip ties
* Cracked or damaged rope light
* Loose electrical connections
* Rust or broken welds
* Damaged insulation
* Worn mounting hardware
* Sharp wire ends

Replace damaged zip ties with outdoor-rated or UV-resistant ties.

Store the display in a dry location where the rope light and wire frame will not be crushed or sharply bent.

== Lessons Learned ==

* A recycled mattress spring frame provides a large, strong, and inexpensive prop foundation.
* Cursive lettering is easier to form with rope light than block lettering.
* Separate bell frames make shaping and installation easier.
* Black electrical tape can hide unwanted illuminated sections.
* Transparent paint can add color to clear rope light.
* Four independently controlled channels are enough to create a convincing animation.
* Large props should be designed with mounting, handling, and storage in mind from the beginning.

== Final Thoughts ==

This project is a good example of turning discarded material into a large animated display element.

The original design remains practical, inexpensive, and easy to understand. It can be reproduced with traditional rope light and a simple four-channel controller or updated with modern LEDs, pixels, WLED, ESPixelStick, or xLights while preserving the original appearance.

[[Category:Display Elements]]
[[Category:Construction]]
[[Category:How To]]

Singing Choir

2026-07-22T13:12:28Z

ErnieHorning: Removed undefined Note and Warning templates; replaced with standard MediaWiki formatting.

This animated Christmas choir is a large wireframe display element constructed from heavy wire, clear rope light, vinyl-coated garden fencing and PVC pipe. Eleven individually controlled choir members allow the different vocal sections to be animated along with the music.

:''This turned out to be a pretty sizeable project, and it takes two people to move it around because it's so unwieldy and heavy, but it's been a popular part of my display for quite a few years. I don't use it every year, but because it uses rope light, it's super-low maintenance and fills up a lot of visual space.'' — [[User:dirknerkle|Dirknerkle]]

== Materials and Tools ==

The original project used the following materials and tools:

* Two 50-foot spools of 9-gauge wire
* Clear white rope light
* Vinyl-coated wire garden fencing
* PVC pipe for the supporting arch
* Red, blue, yellow and green incandescent mini-light strings
* Black spray paint
* Dupli-Color Metalcast transparent spray paint
* Black electrical tape
* Outdoor-rated zip ties
* String for measuring the wireframe outlines
* Newspaper or other large sheets of paper
* Digital projector
* Wire cutters and bending tools
* Welding equipment
* A 16-channel lighting controller
* Ground stakes

'''💡 Note:'''

Equivalent materials may be substituted. Availability, electrical requirements and cutting intervals vary considerably between rope-light products. Always follow the manufacturer's instructions for the specific lighting product being used.

== Safety ==

The heavy wire used for this project can spring back while it is being bent or cut. Wear gloves and eye protection, and secure the wire while working with it.

Welding should be performed only by someone familiar with the equipment and appropriate safety procedures. Work in a properly ventilated area and keep combustible materials away from the welding and painting areas.

Paint and other coatings should be applied outdoors or in a well-ventilated location in accordance with the manufacturer's instructions.

== Developing the Design ==

I came up with a concept while sitting in the choir loft between anthems in church one Sunday morning, and I drew a little sketch in the margin of my daily service bulletin:

[[File:1-choirconcept.jpg|center|300px|Initial choir concept sketched in a church service bulletin.]]

I found a graphic on the Internet that was close to the vision that I had for the choir, so I made a screen capture of that.

[[File:2-choirgraphic.jpg|center|300px|Reference graphic used while developing the choir design.]]

I needed a way to enlarge the relatively small graphic to the size I wanted, so I used a digital projector to project it up on a wall. I taped several sheets of newspaper together as my "canvas" so I could outline the elements I wanted to make in wire.

[[File:3-enlarged.JPG|center|300px|The reference graphic projected onto sheets of newspaper.]]

== Forming the Wireframes ==

I used 9-gauge wire from Lowe's that came in 50-foot spools. It's very stiff but bendable and substantial enough to weld, and it's rather inexpensive. I used two spools for all the elements of this frame.

[[File:4-wire.JPG|center|300px|A spool of 9-gauge wire used to form the choir members.]]

Ping pong tables come in really handy for big projects like this! I laid out the paper, and because I wanted to make each frame out of a single piece of wire, I needed to know how long each wire should be.

I used string and taped it onto the outline of each element and then used each string to measure the length of wire and rope light I needed. The string also provided good practice for determining how I would wire the frames with a single, continuous length of rope light.

[[File:5-measuring.JPG|center|300px|String following the projected outline to measure the required wire and rope-light lengths.]]

After cutting and bending the wire into the shape I needed, I welded each piece together.

[[File:6-welded.JPG|center|300px|Completed wireframe sections after welding.]]

== Painting the Frames ==

Because I was planning to resurface the driveway anyway, I painted the frames on the driveway with flat black paint. Painting may not have been necessary, but I think it hides the metal better than if the frames had not been painted. It also seems to help the zip ties grip the frames.

[[File:7-painting.JPG|center|300px|Wireframes being painted flat black.]]

== Installing and Coloring the Rope Light ==

Once the frames were painted, I performed a test fit on the ping pong table and started zip-tying clear white rope light to each frame.

The clear white rope light I selected could be cut every 24 inches. Later, I used black electrical tape to mask areas that I did not want to illuminate.

[[File:8-testfit.JPG|center|300px|Test fitting the frames and attaching the rope light.]]

Because I used clear white rope light, I used Metalcast spray paint to color the various figures. Dupli-Color Metalcast spray paint is usually available from automotive-parts stores and online retailers.

In some cases, masking tape was used to protect sections from overspray. Each element received several coats of spray paint to deepen the color.

I then laid the completed sections on the garage floor for a test. The wire grid beneath the frames served as the base that held all the sections together. Zip-tying the pieces to one another and to the grid made the assembly quite strong.

The grid is vinyl-coated wire garden fencing, commonly available from home-improvement stores.

After five years of use, the Metalcast colors remained vibrant and had faded only slightly.

[[File:9-layout.JPG|300px|Choir members attached to the supporting wire grid.]]
[[File:10-choirtest.JPG|200px|Illuminated test of the completed choir members.]]

== Support Frame and Installation ==

I made an arch from PVC pipe, mounted the wire grid inside the arch and zip-tied four strings of incandescent mini lights around it. The four strings were red, blue, yellow and green.

A single 16-channel controller was used for the 11 choir members and the four colors on the arch, leaving one spare channel.

To mount the completed frame, I pound a couple of stakes into the ground and set the PVC arch over them to support the bottom. The upper portion is secured to nearby tree branches with zip ties in three or four places.

[[File:11-setup.JPG|center|300px|The completed choir installed inside the PVC supporting arch.]]

'''⚠️ Warning:'''

This completed prop is large and somewhat awkward to handle. Plan on having two people available when moving or installing it. Be sure the supporting stakes, PVC frame, and attachment points are strong enough to withstand wind and winter weather.

== Animation and Sequencing ==

All in all, it gives a nice effect, and each choir member is animated individually.

There are three sopranos, three altos, three tenors and two basses. When the choir is used, I animate the different vocal sections appropriately with the music.

Sequencing it takes a lot of time....

[[File:12-action.jpg|center|300px|The animated choir operating as part of the Christmas display.]]

== Refurbishment ==

After eight years of use, I decided to refurbish the colors with Metalcast paint again.

Good as new!

[[File:Choir_refurb.jpg|center|300px|The choir figures after repainting and refurbishment.]]

== Modern Lighting Options ==

The original choir was built with clear incandescent rope light and traditional individually controlled AC channels. That method remains practical because rope light is durable, visually continuous and relatively low-maintenance.

Builders creating a similar display today also have several other options:

* LED rope light
* Low-voltage flexible LED neon
* Individually addressable RGB pixel strip inside a diffuser
* Pixel rope or flexible pixel neon
* Seed pixels mounted to wire or narrow plastic strips

Modern pixel-based lighting can provide changing colors and more detailed animation, but it also requires additional planning for data wiring, power distribution, controllers and sequencing.

A modern version could be sequenced with software such as xLights and operated from a compatible pixel controller. However, replacing the original rope light with pixels would substantially change the electrical and mechanical design of the project.

== Lessons Learned ==

* Large wireframe props can become much heavier and harder to handle than expected.
* A full-size projected pattern is an effective way to enlarge a small drawing.
* String provides a simple method for measuring irregular wire and rope-light paths.
* Designing each figure around one continuous lighting path reduces the number of electrical connections.
* Flat black paint helps the supporting structure disappear at night.
* Transparent color coatings can provide durable color while allowing the original light to remain visible.
* A wire garden-fence grid can provide a strong, lightweight base for joining multiple wireframe elements.
* Large props should be designed with installation, removal, transportation and storage in mind from the beginning.

== Final Thoughts ==

This project requires substantial fabrication and sequencing effort, but the completed choir fills a large amount of visual space and provides a distinctive animated element for a Christmas display.

The original rope-light construction has also proven remarkably durable. With occasional repainting and replacement of weathered zip ties, the choir has remained usable for many years.

Singing Choir

2026-07-22T12:58:23Z

ErnieHorning: Expanded and modernized the Animated Choir article. Added introduction, materials list, safety notes, construction sections, image captions, modernization notes, lessons learned, and improved formatting while preserving the original build log.

This animated Christmas choir is a large wireframe display element constructed from heavy wire, clear rope light, vinyl-coated garden fencing and PVC pipe. Eleven individually controlled choir members allow the different vocal sections to be animated along with the music.

:''This turned out to be a pretty sizeable project, and it takes two people to move it around because it's so unwieldy and heavy, but it's been a popular part of my display for quite a few years. I don't use it every year, but because it uses rope light, it's super-low maintenance and fills up a lot of visual space.'' — [[User:dirknerkle|Dirknerkle]]

== Materials and Tools ==

The original project used the following materials and tools:

* Two 50-foot spools of 9-gauge wire
* Clear white rope light
* Vinyl-coated wire garden fencing
* PVC pipe for the supporting arch
* Red, blue, yellow and green incandescent mini-light strings
* Black spray paint
* Dupli-Color Metalcast transparent spray paint
* Black electrical tape
* Outdoor-rated zip ties
* String for measuring the wireframe outlines
* Newspaper or other large sheets of paper
* Digital projector
* Wire cutters and bending tools
* Welding equipment
* A 16-channel lighting controller
* Ground stakes

{{Note|Equivalent materials may be substituted. Availability, electrical requirements and cutting intervals vary considerably between rope-light products. Always follow the manufacturer's instructions for the specific lighting product being used.}}

== Safety ==

The heavy wire used for this project can spring back while it is being bent or cut. Wear gloves and eye protection, and secure the wire while working with it.

Welding should be performed only by someone familiar with the equipment and appropriate safety procedures. Work in a properly ventilated area and keep combustible materials away from the welding and painting areas.

Paint and other coatings should be applied outdoors or in a well-ventilated location in accordance with the manufacturer's instructions.

== Developing the Design ==

I came up with a concept while sitting in the choir loft between anthems in church one Sunday morning, and I drew a little sketch in the margin of my daily service bulletin:

[[File:1-choirconcept.jpg|center|300px|Initial choir concept sketched in a church service bulletin.]]

I found a graphic on the Internet that was close to the vision that I had for the choir, so I made a screen capture of that.

[[File:2-choirgraphic.jpg|center|300px|Reference graphic used while developing the choir design.]]

I needed a way to enlarge the relatively small graphic to the size I wanted, so I used a digital projector to project it up on a wall. I taped several sheets of newspaper together as my "canvas" so I could outline the elements I wanted to make in wire.

[[File:3-enlarged.JPG|center|300px|The reference graphic projected onto sheets of newspaper.]]

== Forming the Wireframes ==

I used 9-gauge wire from Lowe's that came in 50-foot spools. It's very stiff but bendable and substantial enough to weld, and it's rather inexpensive. I used two spools for all the elements of this frame.

[[File:4-wire.JPG|center|300px|A spool of 9-gauge wire used to form the choir members.]]

Ping pong tables come in really handy for big projects like this! I laid out the paper, and because I wanted to make each frame out of a single piece of wire, I needed to know how long each wire should be.

I used string and taped it onto the outline of each element and then used each string to measure the length of wire and rope light I needed. The string also provided good practice for determining how I would wire the frames with a single, continuous length of rope light.

[[File:5-measuring.JPG|center|300px|String following the projected outline to measure the required wire and rope-light lengths.]]

After cutting and bending the wire into the shape I needed, I welded each piece together.

[[File:6-welded.JPG|center|300px|Completed wireframe sections after welding.]]

== Painting the Frames ==

Because I was planning to resurface the driveway anyway, I painted the frames on the driveway with flat black paint. Painting may not have been necessary, but I think it hides the metal better than if the frames had not been painted. It also seems to help the zip ties grip the frames.

[[File:7-painting.JPG|center|300px|Wireframes being painted flat black.]]

== Installing and Coloring the Rope Light ==

Once the frames were painted, I performed a test fit on the ping pong table and started zip-tying clear white rope light to each frame.

The clear white rope light I selected could be cut every 24 inches. Later, I used black electrical tape to mask areas that I did not want to illuminate.

[[File:8-testfit.JPG|center|300px|Test fitting the frames and attaching the rope light.]]

Because I used clear white rope light, I used Metalcast spray paint to color the various figures. Dupli-Color Metalcast spray paint is usually available from automotive-parts stores and online retailers.

In some cases, masking tape was used to protect sections from overspray. Each element received several coats of spray paint to deepen the color.

I then laid the completed sections on the garage floor for a test. The wire grid beneath the frames served as the base that held all the sections together. Zip-tying the pieces to one another and to the grid made the assembly quite strong.

The grid is vinyl-coated wire garden fencing, commonly available from home-improvement stores.

After five years of use, the Metalcast colors remained vibrant and had faded only slightly.

[[File:9-layout.JPG|300px|Choir members attached to the supporting wire grid.]]
[[File:10-choirtest.JPG|200px|Illuminated test of the completed choir members.]]

== Support Frame and Installation ==

I made an arch from PVC pipe, mounted the wire grid inside the arch and zip-tied four strings of incandescent mini lights around it. The four strings were red, blue, yellow and green.

A single 16-channel controller was used for the 11 choir members and the four colors on the arch, leaving one spare channel.

To mount the completed frame, I pound a couple of stakes into the ground and set the PVC arch over them to support the bottom. The upper portion is secured to nearby tree branches with zip ties in three or four places.

[[File:11-setup.JPG|center|300px|The completed choir installed inside the PVC supporting arch.]]

{{Warning|This completed prop is large, heavy and difficult to maneuver. Two people should move and install it. Mounting methods should be appropriate for the local site and capable of resisting expected wind, snow and ice loads. Do not rely on weak branches or temporary supports that could fail.}}

== Animation and Sequencing ==

All in all, it gives a nice effect, and each choir member is animated individually.

There are three sopranos, three altos, three tenors and two basses. When the choir is used, I animate the different vocal sections appropriately with the music.

Sequencing it takes a lot of time....

[[File:12-action.jpg|center|300px|The animated choir operating as part of the Christmas display.]]

== Refurbishment ==

After eight years of use, I decided to refurbish the colors with Metalcast paint again.

Good as new!

[[File:Choir_refurb.jpg|center|300px|The choir figures after repainting and refurbishment.]]

== Modern Lighting Options ==

The original choir was built with clear incandescent rope light and traditional individually controlled AC channels. That method remains practical because rope light is durable, visually continuous and relatively low-maintenance.

Builders creating a similar display today also have several other options:

* LED rope light
* Low-voltage flexible LED neon
* Individually addressable RGB pixel strip inside a diffuser
* Pixel rope or flexible pixel neon
* Seed pixels mounted to wire or narrow plastic strips

Modern pixel-based lighting can provide changing colors and more detailed animation, but it also requires additional planning for data wiring, power distribution, controllers and sequencing.

A modern version could be sequenced with software such as xLights and operated from a compatible pixel controller. However, replacing the original rope light with pixels would substantially change the electrical and mechanical design of the project.

== Lessons Learned ==

* Large wireframe props can become much heavier and harder to handle than expected.
* A full-size projected pattern is an effective way to enlarge a small drawing.
* String provides a simple method for measuring irregular wire and rope-light paths.
* Designing each figure around one continuous lighting path reduces the number of electrical connections.
* Flat black paint helps the supporting structure disappear at night.
* Transparent color coatings can provide durable color while allowing the original light to remain visible.
* A wire garden-fence grid can provide a strong, lightweight base for joining multiple wireframe elements.
* Large props should be designed with installation, removal, transportation and storage in mind from the beginning.

== Final Thoughts ==

This project requires substantial fabrication and sequencing effort, but the completed choir fills a large amount of visual space and provides a distinctive animated element for a Christmas display.

The original rope-light construction has also proven remarkably durable. With occasional repainting and replacement of weathered zip ties, the choir has remained usable for many years.

Pixel Window Frames

2026-07-22T12:33:38Z

ErnieHorning: Added note that picture were AI generated.

''(this page to be completed by some creative person!)'' - dirknerkle
:Well, okay then... 😊

----

Pixel window frames are a good way to outline windows with individually controlled lights while keeping yearly installation reasonably quick and painless. Instead of attaching pixels directly to the house every season, the pixels are permanently mounted to lightweight removable frames. Install the frames, connect power and data, test them, and the windows are ready for the show.

There is no single correct way to build a pixel window frame. Windows, siding, shutters, trim, controllers, and storage space all vary from one display to another. This article describes the basic design considerations and several construction methods that can be adapted to fit a particular house.

[[File:Pixel_Window_Frame_Completed.jpg|center|600px]]

== Advantages of Pixel Window Frames ==

A removable frame requires more work during the original construction, but that time is usually recovered during the first few seasons of use.

Some advantages include:

:* Pixels remain attached to the frame during storage.
:* Pixel spacing remains consistent from year to year.
:* Installation and removal can take only a few minutes per window.
:* Wiring can be secured and protected instead of being temporarily attached each season.
:* Frames can be repaired and tested indoors.
:* The outline remains straight and evenly spaced.
:* The same frame can often remain in service for many years.

The goal is to build the frame once, then make annual installation as simple as possible.

== Planning the Frames ==

Before cutting any material, measure each window carefully. Do not assume that two windows that look identical actually are identical. Brick openings, shutters, trim boards, and window frames are sometimes slightly different from one another.

Measure:

:* Overall width
:* Overall height
:* Depth of the trim or opening
:* Location of shutters, hooks, clips, or other mounting points
:* Distance to the nearest controller or power connection
:* Available storage space during the off-season

It can be helpful to make a simple sketch of every window and write the measurements directly on the drawing.

Allow enough clearance for the frame to be installed and removed without scraping the house. A frame that fits too tightly may be difficult to install in cold weather, particularly after several coats of paint have been added.

If several windows are the same size, one completed frame can be used as a pattern for the others. Even then, test-fit each frame before permanently installing the pixels.

== Choosing the Frame Material ==

Several materials can be used successfully. The best choice depends on the size and shape of the window, the type of pixels, the mounting method, and what materials are already available.

=== PVC Pipe ===

PVC pipe is inexpensive, lightweight, easy to cut, and readily available. Standard fittings make square and rectangular frames simple to assemble. PVC can also be heated and bent for arched windows.

Common sizes include 1/2-inch and 3/4-inch pipe. Half-inch PVC is usually adequate for smaller windows. Larger frames may benefit from 3/4-inch PVC or additional bracing.

PVC should be painted if it will receive extended exposure to sunlight. Flat paint also helps the frame blend into the house during daylight hours.

Advantages:

:* Low cost
:* Easy to cut and assemble
:* Common fittings are available
:* Can be heat-formed for curved windows
:* Lightweight

Disadvantages:

:* Large frames may flex
:* Long unsupported sections may sag
:* PVC can become brittle after extended outdoor exposure
:* Bulky fittings may interfere with close-fitting mounting locations

=== EMT Conduit ===

Electrical metallic tubing, commonly called EMT, makes a strong and relatively thin frame. It is useful where PVC would be too flexible or too bulky.

EMT can be joined with conduit fittings, fabricated corner brackets, or flattened and bolted connections. It can also provide a good attachment surface for magnetic mounting hardware.

Advantages:

:* Strong and rigid
:* Thin profile
:* Handles large frames well
:* Suitable for magnetic mounting systems

Disadvantages:

:* Requires metal-cutting tools
:* Corners require fittings or fabrication
:* Conductive material must be kept clear of exposed electrical connections
:* Heavier than some plastic alternatives

=== Wood ===

Wood strips can also be used, particularly when the frame will be concealed behind trim or mounted inside a window.

Advantages:

:* Easy to cut and fasten
:* Inexpensive
:* Easy to paint
:* Simple to attach clips and brackets

Disadvantages:

:* Can absorb moisture
:* May warp
:* Usually heavier than PVC
:* Requires sealing or exterior paint

=== Plastic Strip or Coroplast ===

Pixels may also be installed in commercial pixel mounting strip, custom plastic strip, or narrow pieces of coroplast. The strip can then be fastened to a rigid outer frame.

This method makes pixel spacing easy to maintain and can simplify replacement of damaged sections.

== Choosing the Pixels ==

Many pixel types can be used for window frames.

Common choices include:

:* 12mm bullet pixels
:* Square pixels
:* Seed pixels
:* Pebble-style pixels
:* RGB strip
:* Other individually addressable outdoor pixels

Bullet pixels are rugged and easy to replace but require relatively large mounting holes or pixel strip. Seed pixels produce a thinner and less noticeable frame, but their smaller wire may require more careful handling.

RGB strip can create a very clean line, although repairing a failed section may be more difficult than replacing an individual pixel.

Choose pixels rated for outdoor use and make sure all joints, connectors, and wire entries are protected from water.

== Choosing Pixel Spacing ==

Pixel spacing is largely a matter of appearance, viewing distance, budget, and the effects that will be used.

Common spacing choices include:

:* 1 inch
:* 2 inches
:* 3 inches
:* 4 inches

Closer spacing produces smoother chases and more detailed effects but requires more pixels, more power, and more controller capacity.

Wider spacing costs less and is usually adequate when the windows are viewed from across the street. Test a short sample before committing to every frame. What appears widely spaced on a workbench often looks perfectly acceptable from normal viewing distance.

Try to keep the spacing consistent around corners. A slightly unusual gap at a corner is usually less noticeable than several pixels crowded together.

== Determining the Pixel Count ==

The approximate pixel count can be calculated from the perimeter of the frame and the desired spacing.

For example, a frame measuring 36 inches wide by 60 inches high has a perimeter of:

:36 + 60 + 36 + 60 = 192 inches

At 2-inch spacing, the frame would require approximately:

:192 / 2 = 96 pixels

The final count may change slightly depending on corner placement and the location of the input and output cables.

It is usually better to lay out the actual pixel positions on the completed frame before cutting a pixel string or drilling all the holes.

== Deciding Where Pixel Number One Goes ==

Before installing the pixels, decide where the first pixel and the controller connection should be located.

The best location is usually near:

:* The controller
:* A power connection
:* The bottom corner of the window
:* A location where the cable can be hidden
:* The output of the previous frame when several frames are daisy-chained

Also decide which direction the data will travel around the frame. Record this information because it will be needed when creating the model in xLights.

A label on the back of the frame identifying the starting corner and data direction can prevent considerable confusion later.

== Constructing a PVC Frame ==

The following is one basic method using PVC pipe.

=== Materials ===

:* 1/2-inch or 3/4-inch PVC pipe
:* PVC elbows
:* PVC T-connectors, if braces are needed
:* Exterior paint suitable for plastic
:* Pixel mounting strip, clips, or zip ties
:* Outdoor-rated pixels
:* Pixel connectors or waterproof cable glands
:* Mounting brackets
:* Stainless steel screws or other exterior fasteners
:* Zip ties
:* Measuring tape
:* PVC cutter or saw
:* Drill and drill bits
:* Marker
:* Safety glasses

=== Assembly ===

:* Measure and cut the PVC pieces.
:* Temporarily assemble the frame without glue.
:* Check that the frame is square by measuring diagonally from corner to corner.
:* Test-fit the frame on the house.
:* Add a center brace if the frame is large or flexible.
:* Mark the orientation and window location on the back.
:* Disassemble and paint the pieces if desired.
:* Reassemble after the paint has cured.

A frame does not always need to be glued. Friction-fit parts can make repairs or storage easier. On the other hand, an unglued frame may pull apart during installation. Small screws through the fittings can secure the frame while still allowing future disassembly.

If PVC cement is used, confirm the frame is square before the cement sets. PVC cement does not provide much time for reconsidering the design.

[[File:Pixel_Window_Frame_PVC.jpg|center|600px]]

== Making Curved Frames ==

Arched windows can be outlined by carefully heating PVC pipe and bending it to match the opening.

A heat gun works well, but heat the pipe gradually and move the heat gun continuously. Concentrating the heat in one spot can scorch, flatten, or kink the pipe.

A plywood form or a pattern traced from the window can help produce a smooth curve. Allow the PVC to cool completely before removing it from the form.

'''Safety Note:''' Work in a well-ventilated area and avoid overheating PVC. Wear gloves and eye protection. The pipe can become hot enough to cause burns even when it does not appear unusually hot.

Another option is to use flexible plastic tubing or segmented mounting strip attached to a rigid frame.

== Mounting the Pixels ==

The pixels may be attached directly to the frame or installed in a separate mounting strip.

=== Pixel Mounting Strip ===

Commercial pixel strip provides consistent spacing and makes layout easy. The loaded strip can be attached to PVC, EMT, or wood with zip ties, clips, screws, or small brackets.

Do not overtighten fasteners. The mounting strip should be secure, but it should still be able to expand and contract with temperature changes.

=== Drilled PVC ===

Holes can be drilled directly into PVC for bullet pixels. This creates a clean installation but requires careful alignment.

A drilling jig will save time and produce more consistent spacing. Mark the starting point, then use the jig to locate each additional hole.

Test the hole size on a scrap piece first. A hole that is too small makes insertion difficult and may damage the pixel. A hole that is too large may not hold the pixel securely.

Direct drilling works best when the pixels face outward from the pipe. Consider how the wires will pass around elbows and fittings before drilling the corner areas.

=== Clips and Zip Ties ===

Pixels can be secured with commercial clips, custom 3D-printed clips, or small UV-resistant zip ties.

Clips make pixel replacement easier and avoid drilling large numbers of holes. They also allow the same frame design to be adapted to different pixel styles.

Use outdoor-rated zip ties. Inexpensive indoor zip ties may become brittle after exposure to sunlight and cold weather.

=== Seed Pixels ===

Seed pixels can be attached along PVC or EMT using small clips, clear tubing, silicone retainers, or carefully placed zip ties.

Do not pull seed-pixel wiring tightly. Leave enough slack to avoid placing stress on the solder joints where the wires enter each pixel.

Seed pixels can make a very lightweight frame, but their fine wire should be supported at regular intervals.

[[File:Pixel_Window_Frame_Pixels.jpg|center|600px]]

== Handling the Corners ==

Corners usually require some compromise.

The exact pixel spacing may not fit perfectly around the perimeter. Several solutions are possible:

:* Adjust the spacing slightly along one side.
:* Place one pixel close to each side of the corner.
:* Leave a slightly larger gap at the corner.
:* Use flexible mounting strip that bends around the corner.
:* Route the pixel wire behind the fitting.

Avoid sharp bends in the pixel wire. A gentle loop behind the frame is usually safer than forcing the wire tightly around a corner.

From normal viewing distance, a small difference in spacing at the corners is rarely noticeable.

== Wiring the Frame ==

Secure the pixel wiring to the back or side of the frame so it cannot flap in the wind or become snagged during installation.

Leave small service loops where needed, especially near:

:* Corners
:* Input connectors
:* Output connectors
:* Power-injection points
:* Removable controller boxes

Label all connectors. At a minimum, identify:

:* Data input
:* Data output
:* Voltage
:* Ground
:* Window location
:* Pixel count
:* Data direction

Do not rely entirely on wire color. Connector manufacturers and pixel vendors do not always use the same color convention.

Before connecting a new pixel string, verify the wiring with a meter and confirm the pinout from the actual pixels being used.

== Controller Location ==

The controller can be located:

:* Directly on the frame
:* In a small enclosure near the window
:* In a central enclosure serving several windows
:* Indoors with cables passing outside
:* In another nearby display element

Mounting a small controller directly to each frame can make the system modular. Each window becomes a self-contained prop requiring only power and network or data.

A central controller may reduce the number of enclosures and power supplies, but it requires longer data and power cables.

There is no universal best arrangement. Choose the design that makes installation, troubleshooting, and storage easiest for the particular display.

Any controller used outdoors should be installed in a suitable weather-resistant enclosure. Position cable entries so water cannot easily run down the cable and into the box. Drip loops are cheap insurance.

== Power Requirements ==

Calculate the expected current before selecting the power supply and wire size.

The maximum theoretical current of a pixel may be considerably higher than the current used during a normal show, particularly when brightness is limited in the controller or sequencing software. Even so, the wiring and power supply should be designed with reasonable safety margin.

Consider:

:* Pixel voltage
:* Total pixel count
:* Maximum brightness
:* Maximum expected current
:* Wire length
:* Wire gauge
:* Voltage drop
:* Power-injection locations
:* Connector current rating

A small frame may need power only at the beginning. Larger frames or closely spaced pixels may need power at more than one point.

When injecting power, make sure all grounds are connected as required by the controller design. Do not accidentally connect the positive outputs of separate power supplies together unless the system was specifically designed for that arrangement.

Fuse each power feed appropriately. The fuse should be selected to protect the wire and downstream wiring from excessive current.

== Power Injection ==

Power injection is simply the addition of power and ground at another point along the pixel string to reduce voltage drop.

Possible injection locations include:

:* Opposite corner from the controller
:* Halfway around the frame
:* Both ends of the string
:* At the beginning of each separate frame

The best location depends on the pixel voltage, wire size, brightness, and total number of pixels.

Test the frame using bright white at the maximum brightness expected during the show. Watch for:

:* Color shifting
:* Flickering
:* Pixels turning pink or yellow instead of white
:* Unstable operation at the far end
:* Warm connectors or wiring

If the frame operates correctly during this test, normal animated effects should be less demanding.

== Mounting the Frames to the House ==

The mounting method is often the most house-specific part of the project.

The frame should be:

:* Secure in wind
:* Easy to install
:* Easy to remove
:* Unobtrusive during daylight
:* Unlikely to damage siding, shutters, brick, or trim

=== Shutter Brackets ===

If the window has shutters, simple metal brackets can be formed to slip behind or around them. The frame can hang from the upper brackets and be secured at the bottom with zip ties, clips, or small straps.

This method can make installation extremely fast because no tools are needed after the brackets are adjusted.

=== Hooks or Screws ===

Small permanent hooks or screws can provide reliable mounting points. Paint them to match the trim so they are less noticeable during the rest of the year.

Use fasteners appropriate for the wall material, and seal penetrations where necessary.

=== Magnetic Mounting ===

Magnets work well where steel flashing, trim, or installed metal plates are available. Magnets should be strong enough to resist wind but not so strong that removing the frame damages it.

Use corrosion-resistant or coated magnets for outdoor applications.

=== Brick Clips ===

Commercial brick clips may work when the brick and mortar profile is compatible. Test them before constructing all the frames because brick dimensions vary.

=== Inside-Mounted Frames ===

Some frames can be mounted inside the window. This protects the pixels from weather and eliminates exterior mounting hardware.

However, reflections from the glass may affect appearance, and screens, blinds, curtains, or window depth may interfere with the lights.

=== Other Methods ===

Other possible mounting methods include:

:* Gutter clips
:* Command-style outdoor hooks
:* Custom 3D-printed brackets
:* Aluminum clips
:* Pipe clamps
:* Spring clips
:* Cable ties around existing structures

Whatever method is chosen, test one frame through wind, rain, and cold weather before duplicating it across the entire house.

[[File:Pixel_Window_Frame_Mounting.jpg|center|600px]]

== Securing Against Wind ==

A frame hanging only from the top may swing, rattle, or pull away from the house.

Secure the bottom or sides with:

:* Zip ties
:* Small straps
:* Clips
:* Magnets
:* Hooks
:* Removable pins

The restraint does not need to support the frame's weight. It only needs to prevent movement.

Avoid creating a large flat surface that catches the wind. Coroplast panels, controller enclosures, and cable bundles should be mounted so they do not act like sails.

== Connectors ==

Outdoor connectors make installation easier but also create possible failure points.

Use connectors that are:

:* Rated for the expected current
:* Polarized
:* Weather-resistant
:* Easy to identify
:* Difficult to connect backward

Apply labels before the frames are installed. A connector marked ''Upper Left Window Input'' is much more useful than one marked ''Cable 7''.

Protect unused output connectors with caps. Position connectors so water does not collect inside them.

When disconnecting, pull on the connector body rather than the wires.

== Testing Before Installation ==

Test every frame indoors before taking it outside.

Verify:

:* Correct pixel count
:* Correct color order
:* Correct data direction
:* Correct starting corner
:* Proper power injection
:* Full-white operation
:* Connector polarity
:* Controller address
:* xLights model configuration

Gently move the frame and wiring while it is operating. Intermittent connections are easier to find on a workbench than on a ladder in cold weather.

It is also helpful to photograph the back of each completed frame. The photograph provides a record of wiring, connectors, injection points, and controller placement.

== Configuring the Frame in xLights ==

A rectangular window frame is normally created as an outline or custom model.

Record:

:* Pixel count on each side
:* Starting corner
:* Direction of data flow
:* Whether the pixels travel clockwise or counterclockwise
:* Controller output
:* Starting channel or universe assignment

If the actual pixel spacing around the corners is slightly uneven, the xLights model does not necessarily need to reproduce every physical gap. The important thing is that the model follows the correct pixel order.

For effects that move around the window, confirm that the model direction matches the intended visual direction.

Name the models clearly. Names such as ''Living Room Left Window'' are much easier to manage than ''Window 1'' after the display grows.

== Installation ==

A well-designed frame should require only a few steps:

:# Carry the frame to the correct window.
:# Hang it on the permanent brackets or clips.
:# Secure the bottom or sides.
:# Connect power and data.
:# Test the frame.

Where possible, use the same connector arrangement on every window. Standardization reduces mistakes and makes spare parts more useful.

After the first installation, note anything that was awkward. A small bracket change made during the off-season may save several minutes every year.

== Removal ==

Before removing the frames, label any cables or connectors that are not already permanently marked.

Disconnect power before unplugging or reconnecting pixel wiring.

Inspect the frame while taking it down. Look for:

:* Loose pixels
:* Cracked clips
:* Brittle zip ties
:* Damaged wire
:* Corroded connectors
:* Water inside enclosures
:* Loose brackets
:* Paint damage

Repairing problems before storage prevents discovering them during installation the following year.

== Storage ==

Storage should be considered before the first frame is built.

Possible storage methods include:

:* Hanging the frames from wall hooks
:* Suspending them from garage ceiling brackets
:* Stacking them vertically with spacers
:* Building a rolling storage rack
:* Separating unglued PVC frames into sections

Do not pile frames directly on top of exposed pixels. Use spacers so the weight is carried by the frame rather than the lights.

Keep the input and output connectors protected. Small bags or caps can keep dust, insects, and debris out during the off-season.

If the controller remains attached to the frame, make sure the storage area is dry.

[[File:Pixel_Window_Frame_Storage.jpg|center|600px]]

== Repairs and Maintenance ==

Even a carefully built frame may eventually need repairs.

Design the frame so individual pixels, sections of strip, connectors, and controllers can be replaced without rebuilding the entire assembly.

Keep a small supply of matching pixels. Replacement pixels purchased several years later may have different wire colors, brightness, or color characteristics.

Useful maintenance items include:

:* Spare pixels
:* Matching connectors
:* Heat-shrink tubing
:* Soldering supplies
:* Waterproof sealant
:* Replacement clips
:* Outdoor zip ties
:* Spare fuses
:* Labels

Test the frames well before the display season. Repairs are much more enjoyable in a warm workshop than outside after dark.

== Lessons Learned ==

A few planning decisions can make a large difference later.

:* Build and test one complete frame before buying or cutting everything for the remaining windows.
:* Measure every window.
:* Plan the mounting system before mounting the pixels.
:* Plan storage before deciding the maximum frame size.
:* Mark the input, output, and data direction permanently.
:* Leave small service loops instead of stretching the wiring tightly.
:* Use outdoor-rated materials.
:* Keep connectors accessible.
:* Use a drilling or spacing jig when making several matching frames.
:* Test at the brightness that will actually be used.
:* Make the yearly installation simple enough that another person could understand it.

The best frame is not necessarily the most elaborate one. A simple design that installs quickly, survives the weather, and works reliably year after year is usually better than a complicated design that must be repaired every season.

== Other Variations ==

The same basic construction ideas can be adapted to:

:* Door outlines
:* Garage-door outlines
:* Roofline sections
:* Arches
:* Columns
:* Signs
:* Indoor window displays
:* Permanent architectural lighting

Frames can also be divided into smaller sections when a single large frame would be difficult to transport or store.

A large window might use four separate side pieces that connect at the corners during installation. This adds connectors but greatly reduces storage space.

== Finished Details ==

[[File:Pixel_Window_Frame_Completed_Closeup.jpg|center|600px]]

Once the frames have been installed, step back and inspect both the overall appearance and the small details. A clean installation not only looks better but is usually easier to maintain year after year.

Look for:

* Consistent pixel spacing around the window.
* Wiring that is neatly secured to the frame.
* Connectors that are protected from the weather.
* Mounting hardware that is secure but easy to remove after the season.
* Frames that sit square and parallel to the window trim.

It is also worth viewing the display from across the street. Small imperfections that are obvious from a few feet away often disappear at normal viewing distance, while uneven spacing or crooked frames become much more noticeable.

== Final Thoughts ==

Pixel window frames combine two useful ideas: the flexibility of individually controlled pixels and the convenience of reusable display hardware.

They require some planning and construction time, but once completed they can turn a time-consuming seasonal job into a quick installation. As with most DIYChristmas projects, the exact materials and methods are less important than building something that fits the house, the display, the available tools, and the builder's own way of doing things.

There are many ways to construct them. This is only a place to start.

----

'''Note:''' ''Pictures used in this article were AI generated and are not actual products that you can purchase.''

Pixel Window Frames

2026-07-22T01:14:03Z

ErnieHorning: Initial version of Pixel Window Frames article. Added complete construction guide, installation methods, wiring, power considerations, storage recommendations, and supporting illustrations.

(this page to be completed by some creative person!)

```wiki
Pixel window frames are a good way to outline windows with individually controlled lights while keeping yearly installation reasonably quick and painless. Instead of attaching pixels directly to the house every season, the pixels are permanently mounted to lightweight removable frames. Install the frames, connect power and data, test them, and the windows are ready for the show.

There is no single correct way to build a pixel window frame. Windows, siding, shutters, trim, controllers, and storage space all vary from one display to another. This article describes the basic design considerations and several construction methods that can be adapted to fit a particular house.

[[File:Pixel_Window_Frame_Completed.jpg|center|600px]]

== Advantages of Pixel Window Frames ==

A removable frame requires more work during the original construction, but that time is usually recovered during the first few seasons of use.

Some advantages include:

:* Pixels remain attached to the frame during storage.
:* Pixel spacing remains consistent from year to year.
:* Installation and removal can take only a few minutes per window.
:* Wiring can be secured and protected instead of being temporarily attached each season.
:* Frames can be repaired and tested indoors.
:* The outline remains straight and evenly spaced.
:* The same frame can often remain in service for many years.

The goal is to build the frame once, then make annual installation as simple as possible.

== Planning the Frames ==

Before cutting any material, measure each window carefully. Do not assume that two windows that look identical actually are identical. Brick openings, shutters, trim boards, and window frames are sometimes slightly different from one another.

Measure:

:* Overall width
:* Overall height
:* Depth of the trim or opening
:* Location of shutters, hooks, clips, or other mounting points
:* Distance to the nearest controller or power connection
:* Available storage space during the off-season

It can be helpful to make a simple sketch of every window and write the measurements directly on the drawing.

Allow enough clearance for the frame to be installed and removed without scraping the house. A frame that fits too tightly may be difficult to install in cold weather, particularly after several coats of paint have been added.

If several windows are the same size, one completed frame can be used as a pattern for the others. Even then, test-fit each frame before permanently installing the pixels.

== Choosing the Frame Material ==

Several materials can be used successfully. The best choice depends on the size and shape of the window, the type of pixels, the mounting method, and what materials are already available.

=== PVC Pipe ===

PVC pipe is inexpensive, lightweight, easy to cut, and readily available. Standard fittings make square and rectangular frames simple to assemble. PVC can also be heated and bent for arched windows.

Common sizes include 1/2-inch and 3/4-inch pipe. Half-inch PVC is usually adequate for smaller windows. Larger frames may benefit from 3/4-inch PVC or additional bracing.

PVC should be painted if it will receive extended exposure to sunlight. Flat paint also helps the frame blend into the house during daylight hours.

Advantages:

:* Low cost
:* Easy to cut and assemble
:* Common fittings are available
:* Can be heat-formed for curved windows
:* Lightweight

Disadvantages:

:* Large frames may flex
:* Long unsupported sections may sag
:* PVC can become brittle after extended outdoor exposure
:* Bulky fittings may interfere with close-fitting mounting locations

=== EMT Conduit ===

Electrical metallic tubing, commonly called EMT, makes a strong and relatively thin frame. It is useful where PVC would be too flexible or too bulky.

EMT can be joined with conduit fittings, fabricated corner brackets, or flattened and bolted connections. It can also provide a good attachment surface for magnetic mounting hardware.

Advantages:

:* Strong and rigid
:* Thin profile
:* Handles large frames well
:* Suitable for magnetic mounting systems

Disadvantages:

:* Requires metal-cutting tools
:* Corners require fittings or fabrication
:* Conductive material must be kept clear of exposed electrical connections
:* Heavier than some plastic alternatives

=== Wood ===

Wood strips can also be used, particularly when the frame will be concealed behind trim or mounted inside a window.

Advantages:

:* Easy to cut and fasten
:* Inexpensive
:* Easy to paint
:* Simple to attach clips and brackets

Disadvantages:

:* Can absorb moisture
:* May warp
:* Usually heavier than PVC
:* Requires sealing or exterior paint

=== Plastic Strip or Coroplast ===

Pixels may also be installed in commercial pixel mounting strip, custom plastic strip, or narrow pieces of coroplast. The strip can then be fastened to a rigid outer frame.

This method makes pixel spacing easy to maintain and can simplify replacement of damaged sections.

== Choosing the Pixels ==

Many pixel types can be used for window frames.

Common choices include:

:* 12mm bullet pixels
:* Square pixels
:* Seed pixels
:* Pebble-style pixels
:* RGB strip
:* Other individually addressable outdoor pixels

Bullet pixels are rugged and easy to replace but require relatively large mounting holes or pixel strip. Seed pixels produce a thinner and less noticeable frame, but their smaller wire may require more careful handling.

RGB strip can create a very clean line, although repairing a failed section may be more difficult than replacing an individual pixel.

Choose pixels rated for outdoor use and make sure all joints, connectors, and wire entries are protected from water.

== Choosing Pixel Spacing ==

Pixel spacing is largely a matter of appearance, viewing distance, budget, and the effects that will be used.

Common spacing choices include:

:* 1 inch
:* 2 inches
:* 3 inches
:* 4 inches

Closer spacing produces smoother chases and more detailed effects but requires more pixels, more power, and more controller capacity.

Wider spacing costs less and is usually adequate when the windows are viewed from across the street. Test a short sample before committing to every frame. What appears widely spaced on a workbench often looks perfectly acceptable from normal viewing distance.

Try to keep the spacing consistent around corners. A slightly unusual gap at a corner is usually less noticeable than several pixels crowded together.

== Determining the Pixel Count ==

The approximate pixel count can be calculated from the perimeter of the frame and the desired spacing.

For example, a frame measuring 36 inches wide by 60 inches high has a perimeter of:

:36 + 60 + 36 + 60 = 192 inches

At 2-inch spacing, the frame would require approximately:

:192 / 2 = 96 pixels

The final count may change slightly depending on corner placement and the location of the input and output cables.

It is usually better to lay out the actual pixel positions on the completed frame before cutting a pixel string or drilling all the holes.

== Deciding Where Pixel Number One Goes ==

Before installing the pixels, decide where the first pixel and the controller connection should be located.

The best location is usually near:

:* The controller
:* A power connection
:* The bottom corner of the window
:* A location where the cable can be hidden
:* The output of the previous frame when several frames are daisy-chained

Also decide which direction the data will travel around the frame. Record this information because it will be needed when creating the model in xLights.

A label on the back of the frame identifying the starting corner and data direction can prevent considerable confusion later.

== Constructing a PVC Frame ==

The following is one basic method using PVC pipe.

=== Materials ===

:* 1/2-inch or 3/4-inch PVC pipe
:* PVC elbows
:* PVC T-connectors, if braces are needed
:* Exterior paint suitable for plastic
:* Pixel mounting strip, clips, or zip ties
:* Outdoor-rated pixels
:* Pixel connectors or waterproof cable glands
:* Mounting brackets
:* Stainless steel screws or other exterior fasteners
:* Zip ties
:* Measuring tape
:* PVC cutter or saw
:* Drill and drill bits
:* Marker
:* Safety glasses

=== Assembly ===

:* Measure and cut the PVC pieces.
:* Temporarily assemble the frame without glue.
:* Check that the frame is square by measuring diagonally from corner to corner.
:* Test-fit the frame on the house.
:* Add a center brace if the frame is large or flexible.
:* Mark the orientation and window location on the back.
:* Disassemble and paint the pieces if desired.
:* Reassemble after the paint has cured.

A frame does not always need to be glued. Friction-fit parts can make repairs or storage easier. On the other hand, an unglued frame may pull apart during installation. Small screws through the fittings can secure the frame while still allowing future disassembly.

If PVC cement is used, confirm the frame is square before the cement sets. PVC cement does not provide much time for reconsidering the design.

[[File:Pixel_Window_Frame_PVC.jpg|center|600px]]

== Making Curved Frames ==

Arched windows can be outlined by carefully heating PVC pipe and bending it to match the opening.

A heat gun works well, but heat the pipe gradually and move the heat gun continuously. Concentrating the heat in one spot can scorch, flatten, or kink the pipe.

A plywood form or a pattern traced from the window can help produce a smooth curve. Allow the PVC to cool completely before removing it from the form.

'''Safety Note:''' Work in a well-ventilated area and avoid overheating PVC. Wear gloves and eye protection. The pipe can become hot enough to cause burns even when it does not appear unusually hot.

Another option is to use flexible plastic tubing or segmented mounting strip attached to a rigid frame.

== Mounting the Pixels ==

The pixels may be attached directly to the frame or installed in a separate mounting strip.

=== Pixel Mounting Strip ===

Commercial pixel strip provides consistent spacing and makes layout easy. The loaded strip can be attached to PVC, EMT, or wood with zip ties, clips, screws, or small brackets.

Do not overtighten fasteners. The mounting strip should be secure, but it should still be able to expand and contract with temperature changes.

=== Drilled PVC ===

Holes can be drilled directly into PVC for bullet pixels. This creates a clean installation but requires careful alignment.

A drilling jig will save time and produce more consistent spacing. Mark the starting point, then use the jig to locate each additional hole.

Test the hole size on a scrap piece first. A hole that is too small makes insertion difficult and may damage the pixel. A hole that is too large may not hold the pixel securely.

Direct drilling works best when the pixels face outward from the pipe. Consider how the wires will pass around elbows and fittings before drilling the corner areas.

=== Clips and Zip Ties ===

Pixels can be secured with commercial clips, custom 3D-printed clips, or small UV-resistant zip ties.

Clips make pixel replacement easier and avoid drilling large numbers of holes. They also allow the same frame design to be adapted to different pixel styles.

Use outdoor-rated zip ties. Inexpensive indoor zip ties may become brittle after exposure to sunlight and cold weather.

=== Seed Pixels ===

Seed pixels can be attached along PVC or EMT using small clips, clear tubing, silicone retainers, or carefully placed zip ties.

Do not pull seed-pixel wiring tightly. Leave enough slack to avoid placing stress on the solder joints where the wires enter each pixel.

Seed pixels can make a very lightweight frame, but their fine wire should be supported at regular intervals.

[[File:Pixel_Window_Frame_Pixels.jpg|center|600px]]

== Handling the Corners ==

Corners usually require some compromise.

The exact pixel spacing may not fit perfectly around the perimeter. Several solutions are possible:

:* Adjust the spacing slightly along one side.
:* Place one pixel close to each side of the corner.
:* Leave a slightly larger gap at the corner.
:* Use flexible mounting strip that bends around the corner.
:* Route the pixel wire behind the fitting.

Avoid sharp bends in the pixel wire. A gentle loop behind the frame is usually safer than forcing the wire tightly around a corner.

From normal viewing distance, a small difference in spacing at the corners is rarely noticeable.

== Wiring the Frame ==

Secure the pixel wiring to the back or side of the frame so it cannot flap in the wind or become snagged during installation.

Leave small service loops where needed, especially near:

:* Corners
:* Input connectors
:* Output connectors
:* Power-injection points
:* Removable controller boxes

Label all connectors. At a minimum, identify:

:* Data input
:* Data output
:* Voltage
:* Ground
:* Window location
:* Pixel count
:* Data direction

Do not rely entirely on wire color. Connector manufacturers and pixel vendors do not always use the same color convention.

Before connecting a new pixel string, verify the wiring with a meter and confirm the pinout from the actual pixels being used.

== Controller Location ==

The controller can be located:

:* Directly on the frame
:* In a small enclosure near the window
:* In a central enclosure serving several windows
:* Indoors with cables passing outside
:* In another nearby display element

Mounting a small controller directly to each frame can make the system modular. Each window becomes a self-contained prop requiring only power and network or data.

A central controller may reduce the number of enclosures and power supplies, but it requires longer data and power cables.

There is no universal best arrangement. Choose the design that makes installation, troubleshooting, and storage easiest for the particular display.

Any controller used outdoors should be installed in a suitable weather-resistant enclosure. Position cable entries so water cannot easily run down the cable and into the box. Drip loops are cheap insurance.

== Power Requirements ==

Calculate the expected current before selecting the power supply and wire size.

The maximum theoretical current of a pixel may be considerably higher than the current used during a normal show, particularly when brightness is limited in the controller or sequencing software. Even so, the wiring and power supply should be designed with reasonable safety margin.

Consider:

:* Pixel voltage
:* Total pixel count
:* Maximum brightness
:* Maximum expected current
:* Wire length
:* Wire gauge
:* Voltage drop
:* Power-injection locations
:* Connector current rating

A small frame may need power only at the beginning. Larger frames or closely spaced pixels may need power at more than one point.

When injecting power, make sure all grounds are connected as required by the controller design. Do not accidentally connect the positive outputs of separate power supplies together unless the system was specifically designed for that arrangement.

Fuse each power feed appropriately. The fuse should be selected to protect the wire and downstream wiring from excessive current.

== Power Injection ==

Power injection is simply the addition of power and ground at another point along the pixel string to reduce voltage drop.

Possible injection locations include:

:* Opposite corner from the controller
:* Halfway around the frame
:* Both ends of the string
:* At the beginning of each separate frame

The best location depends on the pixel voltage, wire size, brightness, and total number of pixels.

Test the frame using bright white at the maximum brightness expected during the show. Watch for:

:* Color shifting
:* Flickering
:* Pixels turning pink or yellow instead of white
:* Unstable operation at the far end
:* Warm connectors or wiring

If the frame operates correctly during this test, normal animated effects should be less demanding.

== Mounting the Frames to the House ==

The mounting method is often the most house-specific part of the project.

The frame should be:

:* Secure in wind
:* Easy to install
:* Easy to remove
:* Unobtrusive during daylight
:* Unlikely to damage siding, shutters, brick, or trim

=== Shutter Brackets ===

If the window has shutters, simple metal brackets can be formed to slip behind or around them. The frame can hang from the upper brackets and be secured at the bottom with zip ties, clips, or small straps.

This method can make installation extremely fast because no tools are needed after the brackets are adjusted.

=== Hooks or Screws ===

Small permanent hooks or screws can provide reliable mounting points. Paint them to match the trim so they are less noticeable during the rest of the year.

Use fasteners appropriate for the wall material, and seal penetrations where necessary.

=== Magnetic Mounting ===

Magnets work well where steel flashing, trim, or installed metal plates are available. Magnets should be strong enough to resist wind but not so strong that removing the frame damages it.

Use corrosion-resistant or coated magnets for outdoor applications.

=== Brick Clips ===

Commercial brick clips may work when the brick and mortar profile is compatible. Test them before constructing all the frames because brick dimensions vary.

=== Inside-Mounted Frames ===

Some frames can be mounted inside the window. This protects the pixels from weather and eliminates exterior mounting hardware.

However, reflections from the glass may affect appearance, and screens, blinds, curtains, or window depth may interfere with the lights.

=== Other Methods ===

Other possible mounting methods include:

:* Gutter clips
:* Command-style outdoor hooks
:* Custom 3D-printed brackets
:* Aluminum clips
:* Pipe clamps
:* Spring clips
:* Cable ties around existing structures

Whatever method is chosen, test one frame through wind, rain, and cold weather before duplicating it across the entire house.

[[File:Pixel_Window_Frame_Mounting.jpg|center|600px]]

== Securing Against Wind ==

A frame hanging only from the top may swing, rattle, or pull away from the house.

Secure the bottom or sides with:

:* Zip ties
:* Small straps
:* Clips
:* Magnets
:* Hooks
:* Removable pins

The restraint does not need to support the frame's weight. It only needs to prevent movement.

Avoid creating a large flat surface that catches the wind. Coroplast panels, controller enclosures, and cable bundles should be mounted so they do not act like sails.

== Connectors ==

Outdoor connectors make installation easier but also create possible failure points.

Use connectors that are:

:* Rated for the expected current
:* Polarized
:* Weather-resistant
:* Easy to identify
:* Difficult to connect backward

Apply labels before the frames are installed. A connector marked ''Upper Left Window Input'' is much more useful than one marked ''Cable 7''.

Protect unused output connectors with caps. Position connectors so water does not collect inside them.

When disconnecting, pull on the connector body rather than the wires.

== Testing Before Installation ==

Test every frame indoors before taking it outside.

Verify:

:* Correct pixel count
:* Correct color order
:* Correct data direction
:* Correct starting corner
:* Proper power injection
:* Full-white operation
:* Connector polarity
:* Controller address
:* xLights model configuration

Gently move the frame and wiring while it is operating. Intermittent connections are easier to find on a workbench than on a ladder in cold weather.

It is also helpful to photograph the back of each completed frame. The photograph provides a record of wiring, connectors, injection points, and controller placement.

== Configuring the Frame in xLights ==

A rectangular window frame is normally created as an outline or custom model.

Record:

:* Pixel count on each side
:* Starting corner
:* Direction of data flow
:* Whether the pixels travel clockwise or counterclockwise
:* Controller output
:* Starting channel or universe assignment

If the actual pixel spacing around the corners is slightly uneven, the xLights model does not necessarily need to reproduce every physical gap. The important thing is that the model follows the correct pixel order.

For effects that move around the window, confirm that the model direction matches the intended visual direction.

Name the models clearly. Names such as ''Living Room Left Window'' are much easier to manage than ''Window 1'' after the display grows.

== Installation ==

A well-designed frame should require only a few steps:

:# Carry the frame to the correct window.
:# Hang it on the permanent brackets or clips.
:# Secure the bottom or sides.
:# Connect power and data.
:# Test the frame.

Where possible, use the same connector arrangement on every window. Standardization reduces mistakes and makes spare parts more useful.

After the first installation, note anything that was awkward. A small bracket change made during the off-season may save several minutes every year.

== Removal ==

Before removing the frames, label any cables or connectors that are not already permanently marked.

Disconnect power before unplugging or reconnecting pixel wiring.

Inspect the frame while taking it down. Look for:

:* Loose pixels
:* Cracked clips
:* Brittle zip ties
:* Damaged wire
:* Corroded connectors
:* Water inside enclosures
:* Loose brackets
:* Paint damage

Repairing problems before storage prevents discovering them during installation the following year.

== Storage ==

Storage should be considered before the first frame is built.

Possible storage methods include:

:* Hanging the frames from wall hooks
:* Suspending them from garage ceiling brackets
:* Stacking them vertically with spacers
:* Building a rolling storage rack
:* Separating unglued PVC frames into sections

Do not pile frames directly on top of exposed pixels. Use spacers so the weight is carried by the frame rather than the lights.

Keep the input and output connectors protected. Small bags or caps can keep dust, insects, and debris out during the off-season.

If the controller remains attached to the frame, make sure the storage area is dry.

[[File:Pixel_Window_Frame_Storage.jpg|center|600px]]

== Repairs and Maintenance ==

Even a carefully built frame may eventually need repairs.

Design the frame so individual pixels, sections of strip, connectors, and controllers can be replaced without rebuilding the entire assembly.

Keep a small supply of matching pixels. Replacement pixels purchased several years later may have different wire colors, brightness, or color characteristics.

Useful maintenance items include:

:* Spare pixels
:* Matching connectors
:* Heat-shrink tubing
:* Soldering supplies
:* Waterproof sealant
:* Replacement clips
:* Outdoor zip ties
:* Spare fuses
:* Labels

Test the frames well before the display season. Repairs are much more enjoyable in a warm workshop than outside after dark.

== Lessons Learned ==

A few planning decisions can make a large difference later.

:* Build and test one complete frame before buying or cutting everything for the remaining windows.
:* Measure every window.
:* Plan the mounting system before mounting the pixels.
:* Plan storage before deciding the maximum frame size.
:* Mark the input, output, and data direction permanently.
:* Leave small service loops instead of stretching the wiring tightly.
:* Use outdoor-rated materials.
:* Keep connectors accessible.
:* Use a drilling or spacing jig when making several matching frames.
:* Test at the brightness that will actually be used.
:* Make the yearly installation simple enough that another person could understand it.

The best frame is not necessarily the most elaborate one. A simple design that installs quickly, survives the weather, and works reliably year after year is usually better than a complicated design that must be repaired every season.

== Other Variations ==

The same basic construction ideas can be adapted to:

:* Door outlines
:* Garage-door outlines
:* Roofline sections
:* Arches
:* Columns
:* Signs
:* Indoor window displays
:* Permanent architectural lighting

Frames can also be divided into smaller sections when a single large frame would be difficult to transport or store.

A large window might use four separate side pieces that connect at the corners during installation. This adds connectors but greatly reduces storage space.

== Finished Details ==

[[File:Pixel_Window_Frame_Completed_Closeup.jpg|center|600px]]

Once the frames have been installed, step back and inspect both the overall appearance and the small details. A clean installation not only looks better but is usually easier to maintain year after year.

Look for:

* Consistent pixel spacing around the window.
* Wiring that is neatly secured to the frame.
* Connectors that are protected from the weather.
* Mounting hardware that is secure but easy to remove after the season.
* Frames that sit square and parallel to the window trim.

It is also worth viewing the display from across the street. Small imperfections that are obvious from a few feet away often disappear at normal viewing distance, while uneven spacing or crooked frames become much more noticeable.

== Final Thoughts ==

Pixel window frames combine two useful ideas: the flexibility of individually controlled pixels and the convenience of reusable display hardware.

They require some planning and construction time, but once completed they can turn a time-consuming seasonal job into a quick installation. As with most DIYChristmas projects, the exact materials and methods are less important than building something that fits the house, the display, the available tools, and the builder's own way of doing things.

There are many ways to construct them. This is only a place to start.

File:Ixel Window Frame PVC.jpg

2026-07-22T00:55:15Z

ErnieHorning: ErnieHorning moved page File:Ixel Window Frame PVC.jpg to File:Pixel Window Frame PVC.jpg

#REDIRECT [[File:Pixel Window Frame PVC.jpg]]

File:Pixel Window Frame PVC.jpg

2026-07-22T00:55:15Z

ErnieHorning: ErnieHorning moved page File:Ixel Window Frame PVC.jpg to File:Pixel Window Frame PVC.jpg

File:Pixel Window Frame Completed Closeup.jpg

2026-07-22T00:36:14Z

ErnieHorning:

File:Pixel Window Frame Storage.jpg

2026-07-22T00:35:56Z

ErnieHorning:

File:Pixel Window Frame Mounting.jpg

2026-07-22T00:35:35Z

ErnieHorning:

File:Pixel Window Frame Pixels.jpg

2026-07-22T00:35:14Z

ErnieHorning:

File:Pixel Window Frame PVC.jpg

2026-07-22T00:34:59Z

ErnieHorning:

File:Pixel Window Frame Completed.jpg

2026-07-22T00:34:43Z

ErnieHorning:

PVC Window Frames

2026-07-21T23:47:17Z

ErnieHorning: Added a few white space lines where needed.

Window frames are one of the easiest ways to create a clean, professional-looking display while dramatically reducing yearly installation time. This project uses lightweight PVC pipe to create durable, reusable frames that can be installed in just a few minutes each season while remaining nearly invisible during daylight hours.

[[File:2009_display.JPG|center|600px]]

:Here's how to build long-lasting, low maintenance window frames that can be almost invisible on the house during the daytime.

:These frames were constructed using 1/2" PVC pipe, T-connectors, and corner connectors, then painted flat black to match the window shutters. The paint serves several purposes: it helps the frames blend into the shutters during daylight hours, provides additional UV protection for the PVC, and creates a slightly rougher surface that helps prevent zip ties from slipping while securing the light strings. Because the lights could not be installed without a small amount of overlap, they were routed to make the overlap as inconspicuous as possible. In practice, unless you know where to look, it is hardly noticeable.

[[File:Hung1.JPG|300px]] [[File:Hung2.JPG|180px]] [[File:Hung3.JPG|320px]]

:The frames are mounted onto the shutters with a pair of hand-formed aluminum brackets. The brackets can be easily formed in a vice using a hammer and a wooden dowel for the shape, then hand-clamped around the PVC. Slip the brackets over and behind the shutters to hang the frame.

[[File:Bracket1.JPG|200px]] [[File:Bracket2.JPG|200px]] [[File:Bracket3.JPG|200px]] [[File:Bracket4.JPG|200px]]

:The frames are secured against wind with a pair of zip ties passed through small holes drilled in the shutter corners. Each frame uses its own four-channel wireless controller to independently control the four light strings while requiring only a single A/C power connection. This makes installation extremely quick—each window takes less than two minutes to hang and secure. Although this project originally used wireless AC controllers, the same frame design can easily be adapted for incandescent lights, LED strings, or modern smart pixel controllers.

[[File:Fasten1.JPG|300px]] [[File:Hung4.JPG|250px]] [[File:Miniren84.jpg|200px]]

:PVC makes it easy to form curved shapes using a heat gun, as we did for the arch window above the front door. Since there were no shutters on this window, we used four simple pipe clamps (painted flat black) to attach the frame to the house: two clamps support the weight at the bottom and one clamp on either side to hold it against the house.

[[File:Arch1.JPG|300px]] [[File:Arch2.JPG|300px]] [[File:Arch3.JPG|200px]]

:Storage is simple—hang the frames on a couple of wall brackets in the garage during the off-season. At the time this article was originally written, the frames had already been in service for approximately 25 years. Aside from periodically replacing aging incandescent light strings, repairing one frame that was accidentally dropped during takedown, and upgrading to quality LED strings in 2010, the PVC frames themselves have required essentially no maintenance.

[[File:DSCI0630.JPG|500px]]

PVC Window Frames

2026-07-21T23:44:33Z

ErnieHorning: Added a brief introduction describing the benefits of reusable PVC window frames, clarified the discussion of UV protection, paint, and light routing for improved readability, updated the controller description to note compatibility with modern LED and pixel lighting systems, refined the long-term maintenance discussion to emphasize the exceptional durability of the design, and preserved the original construction methods, installation techniques, engineering rationale, and photographic documenta

Santa Cap

2026-07-21T23:30:27Z

ErnieHorning: Added a brief introduction describing the project and its intended use, clarified the LED wiring and battery life descriptions, improved several assembly instructions for readability, added an editor's note explaining that the construction method can be adapted to modern wearable lighting controllers, updated the video introduction, and preserved the original construction process and photographs documenting this simple wearable lighting project.

A lighted Santa cap is an easy wearable lighting project that works well for Christmas displays, parades, parties, and caroling. The soft cap provides plenty of room to conceal the controller and battery while the illuminated fur band creates a highly visible animated effect.

A Santa cap is perhaps one of the easiest wearable blinky-flashy items because the cap has ample space to hold the controller while also offering a highly visible display piece. The following video shows the completed Santa cap in operation: [https://vimeo.com/64474706 '''SANTA CAP VIDEO''' ]

'''Materials in this build:'''
* Inexpensive felt Santa Cap purchased via eBay
* HeadBlinker wireless controller with 9-volt battery
* 12 RGB LEDs, 12 RGB LEDs wired in parallel with all red, green, and blue elements grouped together on three control channels. This allows all LEDs to change color simultaneously while minimizing the number of controller outputs required. Wired in parallel so that all red, all green and all blue on on their own circuits. This requires only 3 channels to control all the leds, reducing some current draw and helping the battery to run a bit longer. A standard 9-volt alkaline battery typically provides about an hour of operation, while appropriately sized rechargeable LiPo battery packs can often power the cap for 3–5 hours, depending on the animation pattern and brightness. A 9v should last about an hour. Rechargeable LiPo batteries last 3-5 hours.
* 12 RGB led carriers.

'''Assembly:'''
* Assemble the HeadBlinker controller, attach battery to bottom with double-stick foam tape. The tape also acts as an insulator so you don't short out the solder pads.

[[File:Cap0.JPG|400px]] [[File:Cap1.JPG|400px]]

* Solder the LEDs to the led carriers.

[[File:Led_carriers.JPG|400px]]

* Solder the carriers into a strip long enough to fit around the cap's white headband. Connect the strip to the controller and test.

[[File:Carrier_strip.jpg|400px]]

* Poke holes for the Leds in the white fur headband; poke through from behind, tucking the connection wire down near the bottom of the headband.

[[File:Tuck_leds.JPG|400px]] [[File:Leds.JPG|400px]]

* Place the completed controller assembly inside the cap. When worn, the folded top of the Santa cap helps retain the controller, while gravity keeps it positioned inside. Tack-stitching the fur headband from the inside also helps keep the wiring hidden and securely in place. Drop the controller into the inside of the cap. When wearing, the top will be flopped over to the side and gravity will keep the controller in. You can also see that the fur headband has been tack-sewed from the inside to make sure the wires stay tucked down behind the fur.

[[File:Cap2.JPG|400px]]

'''Editor's Note (2026):''' Although this project was originally built using the HeadBlinker controller, the same construction technique can be adapted to many small modern controllers capable of driving RGB LEDs or pixels.

Trees/Tree Wraps

2026-07-21T23:19:34Z

ErnieHorning: Added a brief introduction describing the challenges of decorating large outdoor trees, improved the organization and readability of the tree cup and tree wrap techniques, clarified several descriptions for easier understanding, added a note that the methods are applicable to modern incandescent, LED, and pixel lighting systems, and preserved the original installation techniques and photographic examples contributed by the DIYChristmas community.

Decorating large outdoor trees can be challenging because of their height, branch structure, and the amount of lighting required. The techniques below have been used successfully by DIYChristmas members to safely decorate trees while minimizing installation time and maximizing the visual impact of the display.

== Techniques ==

* [[Slingshot Method]] - what to do when your ladder isn't long enough

And in the example below, twelve strings of multi-colored LED light strings were suspended from the outer branches around the entire perimeter of the tree. The strings were then gathered and secured to the trunk, creating a large illuminated "cup" effect. By assigning each string to its own controller channel, the entire tree could be animated much like an oversized mega tree. Each string was also given its own channel so that the tree could be animated, sort of a mega, mega-tree.

[[File:Tree.jpg|center|400px]]

== Tree Wraps ==
Some people wrap lights around the trunk of the tree by winding them around and around and around.... taking hours to do. From normal viewing angles, many of the lights wrapped around the back of the trunk are hidden from view, meaning a significant portion of your installation effort isn't visible to your audience. Then simply bend the fencing and wrap it around the trunk of the tree; tie it in the back of the tree and your tree is done in about five minutes. This tree used two wrap sections totaling 12 strings of 50 lights which allowed for some nice vertical animation.

[[file: Tree_wrap-front.JPG | 200]] [[file: Tree_wrap-back.JPG | 200]]

[[file: Wrap-1.jpg |200px]] [[file: Wrap-2.JPG | 200px]] [[file: Wrap-3.JPG | 200px]] [[file: Wrap-4.JPG | 200px]]

Today these same techniques can be used with incandescent lights, LED strings, smart pixels, or Seed pixels, depending on the desired appearance and animation effects.

Building an Octoscroller Matrix Display

2026-07-21T21:33:34Z

ErnieHorning: Added historical context identifying the Octoscroller and BeagleBone Black as early HUB75 matrix controller platforms, updated several references to reflect current Linux-based controller systems and modern Falcon Player capabilities, clarified wording in a few instructional sections, recommended verifying and updating legacy external links, and preserved the original step-by-step construction, configuration, and educational content documenting one of the DIYChristmas community's pioneering P10

== Overview ==
:An "octoscroller" is simply a message display that happens to use a BeagleBoneBlack microcomputer (abbreviated BBB in this document), an 8-port "octoscroller" daughter card that plugs onto the BBB, and inexpensive RGB LED panels of the P-10 type that use the Hub75 connection method. Powered by low-voltage DC power supplies (5vdc), these units are connected together by short ribbon cables with plug-in IDC connectors and controlled by the same marvelous Falcon Player that runs on the Raspberry Pi. The P-10 panels are particularly well suited for displaying moving text but can also display low-definition pictures and video. The budget for the project outlined here was a very affordable $200. Understand that this Wiki document is only ONE way to build a matrix display; ''it is not the ONLY way''. Note that construction of the Octoscroller board itself is not addressed here -- it's a rather simple board to assemble as it has mostly header connectors. Attaching it to the BBB is a matter of plugging it onto the top of the BBB. It's called an "octoscroller" because it can accommodate up to 8 panels per output, and as it has 8 outputs, it can "scroll" messages or text across 8x8=64 panels.

'''Historical Note (2026):''' The Octoscroller and BeagleBone Black were among the earliest popular controller platforms for P10 RGB LED panels in the DIYChristmas community. While many builders today use newer Falcon, Kulp, Colorlight, or Raspberry Pi-based panel solutions, the concepts presented here remain applicable to HUB75 matrix displays.

[[File:Octo-2.jpg | 500px | center]]

== Skills you'll need to have ==
:* Working understanding of using xLights/Nutcracker to create and save sequences.
:* Working understanding of how to use your Internet browser
:* Working understanding of basic TCP/IP networking
:* Working understanding of how to download software, unzip/install it
:* Working understanding of how to use SD Card formatting software and disk imaging software
:* Working understanding of how to use and configure Falcon Player software
:* Working understanding of basic electrical connectivity issues of low voltage electronics.
:* Working skills with common household tools.
:* A basic familiarity with Linux-based controller systems can be helpful, although Falcon Player handles most configuration through its web interface.

: '''Note:''' by "working" it is meant that you can actually can DO these things, not merely having heard or read about them once. This document will not teach you how to do electronics or how to configure TCP/IP networking, how to use your computer or how to format a flash drive, etc. These are expected skills that you should either have before you attempt working on this project or skills that you will need to acquire during this project.

== Materials/Components you'll need ==
:* BeagleBone Black (or Green) microcomputer and suitable A/C power supply
:* Octoscroller daughter card
:* 4 P-10 RGB LED panels
:* Assorted ribbon connection cables (purchased with the panels)
:* 5amp 5vdc power supply (for the panels)
:* Angled aluminum stock (optional)
:* 3M VHB tape (optional)

== Software tools you'll need ==
:* xLights/Nutcracker
:* Falcon Player
:* Appropriate version of Linux for the Falcon Player
:* Internet browser (to connect to the BBB and control the Falcon Player)

== Sources/Places to get more information ==

:'''Editor's Note (2026):''' Some of the original links below may no longer be active due to changes in websites, vendors, or software projects. Where possible, updated resources should be substituted while preserving the historical references contained in this article.

:* Panels and cables used by the author to make this project:
::http://www.aliexpress.com/item/Indoor-320-160mm-32-16pixels-3in1-SMD-1-8-scan-RGB-P10-full-color-LED-module/1615047851.html

:* Information, downloads links and more about installing Falcon Player on BeagleBone
::http://falconchristmas.com/forum/index.php/topic,2742.0.html

:* xLights/Nutcracker software downloads and information
::http://www.xlights.org/

:* Putty SSH Terminal. You may or may not need this telnet client, but it's very handy to have if you find you do need it.
::http://www.putty.org/

== Step-by-step Panel Assembly ==

:1. Plan your matrix. Decide on where you're going to put it, what you want it to look like, whether it will be tall and narrow, short and wide, square, etc. Also determine how far it will be away from viewers because text or pictures are a little hard to read if the distance is too great and the text size too small. The author's design used four panels in horizontal orientation, creating a 50"W x 6"H sign. Planning is important because if you think you may want to increase the size of your display at a later date, you might be better off buying all the panels you may need up-front so they'll be an electrical and aesthetic match. The colors and brightness from panel to panel will likely be more consistent if you purchase them all together, too. Of course, don't ignore your budget, either.

:2. Gather the materials, equipment, and software you'll need. If you're unfamiliar with Linux-based controller platforms such as the BeagleBone Black or Raspberry Pi, spending a little time learning the basics can be helpful. Falcon Player performs most tasks through its web interface, although utilities such as PuTTY may occasionally be useful for advanced troubleshooting or maintenance.

:3. Once you have all the materials, you can proceed. '''Reminder: make sure nothing is powered on when you connect or disconnect any cables!''' Connecting the panels is dirt-simple as long as you understand how they relate to one another. To do that, assemble the panels in the orientation the Falcon Player requires, which is shown at the top of this photo: O-1 refers to octoscroller port 1 and all four panels are connected to that port. If your display is 2 panels tall, the second row would connect to O-2, etc.

[[File:Panel orientation data flow.jpg | 1000px]]

:: If you look closely at the backs of the panels you'll see arrows that point to the panel tops and to the direction of the flow of data. All the panels are identical and don't take an order number until you connect them together. Notice that the BBB connects to the start but that isn't panel #1. When you view the FRONT of the display, panels count from left-to-right as 1-2-3-4. But on the back side, it's reversed. As you view the FRONT of the display, the top left corner is pixel #1 and the last pixel is on the bottom right. Therefore if you want the text to appear from the right and scroll to the left, you're actually scrolling ''backwards'', from panel 4 to panel 1. Also notice that each panel requires its own power connection/injection. Each of these panels required about .8A at 5vdc when fully on so a simple 5A power supply was sufficient. Your power requirements may differ, so be sure to provide ample current at the required voltage. It's likely that all the panels can be powered from one supply like this example, so all power connections were made common and simply connected to the power supply.

[[File:Panel orientation front.jpg | 1000px]]

::Panels are connected together with a short ribbon jumper: Notice the "output" of one goes to the "input" of the next panel, and because the cable connectors are keyed and fit only one way, it's pretty hard to make a mistake:

[[File:Panel to panel.jpg | 500px | center]]

:4. How you physically interconnect the panels for mounting is personal preference. The mounting holes/screws may differ from one manufacturer or panel version to the next, and if you plan to use them, you might purchase them at the same time as the panels. In this design, the author opted for a simpler mounting method using 3M VHB tape and angled aluminum stock. Affixing the VHB tape to the aluminum, it was a simple matter to place the panels face-down on a flat surface, tape them together so they wouldn't move, and then press the taped side of the aluminum stock onto the back edges of the top and bottom of the panels. This proved to be a very secure and quick method that should make mounting easy later on.

:5. This display is 1-panel tall by 4 panels wide, so it uses only one Octoscroller output. For a matrix that's 2 panels tall, use two outputs; 3 panels, use 3 outputs, etc.

== Configuring the Falcon Player for Octoscroller ==

''Editor's Note (2026):'' Current versions of Falcon Player have evolved considerably since this article was originally written. While some menus and screenshots may differ, the overall configuration process remains very similar.

:Installing the FPP software on your BBB computer is ably described at the Falcon Christmas site and will not be addressed here. Likewise, this document will not address connecting to the BBB via your browser or any other networking issues as well as navigating through the Falcon Player software. However, some pertinent screen displays will likely prove helpful. First, a few calculations:
::* Each panel is 32 RGB pixels wide x 16 RGB pixels tall, for a total of 512 RGB pixels. Therefore, 3 universes will be required for each panel. Four panels would therefore require 12 universes and total 6144 "channels." Configuring the FPP e1.31 page is necessary. It isn't necessary to "enable" the output but it does need configuration. The Unicast/Multicast setting doesn't appear to matter because the matrix is physically connected to the BBB and not to the network:

[[File:Fpp e131 page.png | 700px | center]]

::* The LED Panels screen requires configuration as well (but not the BBB panel). Note that the author's setup is 4 panels wide by 1 panel high, and the pixel "start corner" is defined as "top left" which is as if you were viewing the FRONT side of the matrix. For simplicity, this BBB controller is set to control only this display piece, so it will start with channel 1 and control 6144 channels (matching our calculations above). The order of the colors for these panels was set to RGB (changeable later if you discover your panels are GBR or some other order). FPP makes it easy to configure the Octoscroller panels -- just remember that you're configuring them as if your viewing the BACK side of the panels: the left-to-right order is 4-3-2-1. Also note that the author connected the matrix to Octoscroller output #1 on the Octoscroller daughter card:

[[File:Panel orientation -FPP.png | 700px | center]]

::* The FPP test page should be helpful at this point, and you can try various settings to see what happens to the matrix display. Be sure to "enable" the test to activate the display:

[[File:Fpp test page.png | 750px | center]]

::* You might consider turning off "logging" in the Falcon Player. This is found on the FPP Settings page: uncheck any boxes that may contain checkmarks. You'll probably discover that the display will run a little smoother with logging turned off.

== Configuring xLights/Nutcracker ==

This document will not address the details in how to use xLights/Nutcracker software, and the author claims no expertise whatsoever in using this powerful sequencing tool. However, the following settings worked for this 4x1 Octoscroller matrix display.

:* Create the lighting network/infrastructure that xLights will use for the matrix. For simplicity, this setup incorporates only the matrix itself. Note that the settings are consistent with what was defined earlier in the Falcon Player: starting with universe #1, total of 12 universes, in this case only ONE output and the last channel is 6144. Use MULTICAST for convenience, and afterward, be sure that each of them is "enabled" (far right column).

[[File:Xlights-networksetup.png | 1000px | center]]

:* Create the matrix display element itself (the "layout model"). Here's where you need to think of the combined P-10 panels as if they were "strings" of lights: because they're interconnected, the four 32x16 panels essentially become one 128 x 16 panel. Converting that to the concept of strings, you'd have 16 strings of 128 pixels each. Also consistent with the Falcon Player setup is the starting channel and the starting corner (top left).

[[File:Xlights-layout model.png | 800px | center]]

:* At the xLights sequencer screen, add the matrix to the sequence and click on the timing area to drag open a duration for the display to run (you can adjust it later). Then complete the details for your sign, including the font, font size, color and movement direction it's to scroll. (Note: Your display screen may appear different.) Anytime you make a change to these settings, click the Update button (or press F5).

[[File:Xlights-sequencer.png | 1000px | center]]

:* All that's left to do is "save" the sequence, upload the corresponding .fseq file to the Falcon Player, include that .fseq in a playlist and then "play" it in FPP to display it on the matrix panel. See the Falcon Christmas site for more information on using the Falcon Player.

----

== Legacy Hardware ==

Although the Octoscroller platform has largely been superseded by newer controller hardware, it played an important role in introducing affordable RGB LED matrix displays to the DIYChristmas community. Many of the design principles described in this article—including panel orientation, data flow, power distribution, and display configuration—remain valuable references for today's HUB75 matrix projects.