You’ve got your GEUSA props sitting in the yard, your 12v pixel strings pushed into the coro holes, and your pixel controller powered up. Now comes the moment of truth: Getting xLights to talk to your hardware.
For years, setting up a pixel controller felt like managing a complex enterprise IT network. You had to manually map out "Universes," calculate individual DMX start channels, and match them up line-by-line across multiple screens.
Fortunately, it is no longer 2015. Modern sequencing software has completely automated this process. Here is the modern, frustration-free way to connect and configure your hardware using the xLights Visualizer.
Step 1: The Golden Rule of IP Addresses
Before xLights can configure your controller, both your computer and your controller need to be on the exact same network "sub-network."
-
Plug your pixel controller into your home internet router using a standard Cat5 or Cat6 network cable.
-
Power on the controller and look at its built-in LCD screen (or use a network scanning tool) to find its IP address (for example:
192.168.1.50). -
Important: Make sure your computer is connected to that same router (either via Wi-Fi or another ethernet cable). If your computer is on a guest network or a different router, they won't be able to see each other!
Step 2: Adding the Controller in xLights
Open up xLights on your computer and navigate to the Controllers tab at the top left. Forget about setting up manual universes—we are letting the software handle the math.
-
Click Add Ethernet at the bottom of the screen.
-
In the setup panel on the right, give your controller a name (like Main House Controller).
-
Type your controller's exact IP address into the IP Address field.
-
Under Vendor, select your controller type (e.g., Falcon, Kulp, Baldrick, etc.). Select the exact model from the dropdown.
-
Set the Auto Layout checkbox to True. (This is the magic button that lets xLights take total control of the hardware mapping!)
Step 3: Visual Mapping (The Drag-and-Drop Method)
Now that xLights knows your controller exists, you need to tell it which props are plugged into which actual physical plugs on the box.
-
Click the Visualizer button next to your controller list.
-
A window will pop up. On the left side, you will see a list of every single physical output port on your controller. On the right side, you will see a list of every digital prop you drew on your Layout screen (your rooflines, wreaths, and arches).
-
Simply click on a prop from the right column and drag it over to the physical port on the left where you plugged it in.
-
Chaining props back-to-back? Just drag multiple props onto the exact same port, stack them in the physical order they are wired, and xLights will automatically manage the start and stop data paths behind the scenes.
Step 4: Pushing the Config (The "One-Click" Save)
Once your visualizer layout looks exactly like your yard wiring setup, close the visualizer window and save your work.
Look at the bottom of your controller tab list and click Upload Input and Upload Output.
xLights will instantly log into your controller across your home network, overwrite all the old internal firmware settings, and configure the ports perfectly to match your layout. You don't have to change a single number manually inside your controller's backend page ever again.
Step 5: The Ultimate Test
To verify everything is working smoothly:
-
Click the Discover button to ensure the status light turns green.
-
Go to the Tools menu at the top of xLights and click Test.
-
Select your controller, turn on the "Output to Lights" checkbox, and hit the Solid RGB test button.
If your yard suddenly bursts into bright, synchronized color, congratulations! You have successfully configured your display layout and are officially ready to start sequencing your favorite holiday songs.