ShowSpark 8
Start Here · First-Time Setup

Welcome. Let's Light Something Up.

Everything you need is on this page, in the order you need it. About fifteen minutes from now your controller will be on your network, your lights will be lit, and you will know where every setting lives.

8 light ports No software to install No computer needed to run a show
Let's Get Started

First, Gather Your Bits

Worth laying out on a table before you start, so the whole setup runs without a trip back to the shed.

You Definitely Need

  • Your ShowSpark 8 controller.
  • A DC power supply that matches your lights - the panel below covers how to choose one.
  • A network cable running from the controller to your home router or a network switch.
  • Any device with a web browser - a laptop, a phone, a tablet - connected to that same home network.
  • At least one string of lights plugged into the first light port, so you have something to look at.

Nice To Have Later

  • An SD card (formatted FAT32) if you want the controller to run shows all by itself with no computer switched on.
  • Sequencing software such as xLights, if you want to design your own shows. You do not need it today.
  • The optional audio add-on - the little board with a headphone jack - if you want music playing in time with your lights.
Before you wire anything Switch the power off before you connect or move a light string. Electricity is the one part of this hobby that does not forgive a shortcut.

Choosing a Power Supply

Pixel lights are particular about power in a way most household electronics are not, and the wrong supply damages them rather than simply not working. Two minutes here settles it.

Your wall socket supplies AC power. Your controller and your lights both run on DC power. They cannot be connected to each other directly. In between you need an AC-to-DC power supply - the brick or metal box that plugs into the wall and gives you low-voltage DC on the other side. Light strings are usually sold without one, so it is often a separate purchase.

Getting the voltage right

The supply has to match the lights you bought. There is no universal answer, and no setting on the controller that compensates for a mismatch:

  • 5V lights need a 5V DC supply.
  • 12V lights need a 12V DC supply. This is the most common choice for outdoor displays, because the power carries further down a long run.
  • 24V lights turn up on larger installations, where the longer runs make the higher voltage worth it. It demands more of your wiring and fusing than 5V or 12V does, so treat it as a deliberate choice to research rather than a default.

Your lights will say which they are - on the strip itself, on the reel, or in the listing you bought them from. Where the marking has worn off or the listing is vague, the seller can confirm it faster than testing will.

Worth a second look 12V through 5V lights destroys them in seconds, and there is no recovering the string afterwards. Because the failure is instant and permanent, this is the one connection worth confirming twice - and again after anyone else has been near the wiring.

Making sure it is big enough

A supply also has to be strong enough for how many lights you are asking it to feed - a small one running eight full ports will sag, flicker, or simply give up. Your light supplier can tell you what size you need for the number of lights you are running, and it is always worth leaving yourself some headroom.

The shortcut for setting up indoors

None of the above has to happen today. The controller runs happily from its USB-C socket - a phone charger or a spare port on your laptop is plenty - which is enough to bring it up on your network and work through every screen in this guide at the kitchen table.

USB-C will even light some pixels, so you can watch a test pattern run on a short string at your desk. It is a genuinely useful way to get familiar with the controller before anything goes outside.

How far USB-C stretches A USB socket supplies a small amount of low-voltage power - a fraction of what a display needs. It is fine for a handful of lights on the bench, and nowhere near enough for a full run, let alone eight of them. Ask too much of it and you will see dim or wrong colors, flickering, or the controller restarting mid-pattern. That is the USB supply running out, not a fault - and it is the point at which the proper DC supply has to take over.

Eight Small Steps

Do them in order the first time. After that you can jump straight to whichever one you need. Every change you make is saved on the controller itself and survives being unplugged.

1
1 minute Power on

Plug It In and Watch for the Wink

Connect the network cable from the controller to your router, then apply power. That is the whole step.

If you are doing this at a desk rather than out at the display, a USB-C cable from a phone charger or your laptop will wake the controller up on its own, and will even light a short test string. You can work through steps 2 to 6 that way, in the warm, before anything goes outside - just keep it to a few lights, since USB supplies only a trickle of power compared with a real display.

What you should see

A red dot sweeps back and forth across the first few lights on port 1, like the front of a certain 1980s television car. That little swoosh is the controller saying hello. It only happens at start-up, and it is your first proof that power, the controller, and your wiring are all doing their jobs.

No sweep? Two things to check first: the string is in the first port, and the data arrow printed on it points away from the controller. If you are running on USB-C, try it with just a few lights attached - a longer string can ask for more power than a USB socket can give, which shows up as nothing happening at all. A power cycle after any change costs nothing.
2
2 minutes Find it

Open the Control Center in Your Browser

Everything you configure lives on a web page served by the controller itself. There is nothing to download and nothing to install. On any device on the same network, open a browser and type this in the address bar:

pixelsetup.local

The control center appears. Have a look around - the list down the left side is where every setting lives, and we will visit the important ones next.

A phone or tablet works just as well as a computer here, and is often the easier choice when the controller is out at the display rather than on your desk. The whole control center is built to work on a small screen.

The one thing that matters on a phone It has to be on Wi-Fi from the same router the controller is plugged into. A phone sitting on mobile data is on a different network entirely and will never find the controller, however close you are standing to it - so check the Wi-Fi symbol before assuming something is wrong.
On Windows If that name does not load on a Windows PC, it is almost always Windows being cautious, not a fault with your controller. Windows blocks the reply while your network is marked Public. Open Settings > Network & Internet > Ethernet and set Network profile type to Private, then try the address again. This is why the name often works on a phone first.

Quicker still: skip the Windows setting and use a phone or tablet instead. Connect it to the Wi-Fi from the same router, type pixelsetup.local into its browser, and carry on from there - every step on this page works the same on a small screen.

Or let the USB cable find it for you

With the network cable still connected, plug a USB-C cable from the controller into your computer. A small drive called ShowSpark appears, just like a memory stick. Open it and double-click START HERE - your browser opens straight onto the control center, wherever on your network the controller happens to be. No typing, no guessing.

On a Mac, open ShowSpark Setup on that drive instead; it shows the address to type into your browser.

Or look it up

Out of the box the controller takes its address from your router, the same way a phone does, so your router's list of connected devices shows it - look for a name starting ShowSpark. If you use xLights, its Discover button finds it too.

Once you are in, Device Information at the top of the Firmware & Backup page tells you the exact address the controller is using. Write it on a sticky note.

No router at all? Plugging the controller straight into a laptop with a network cable works too. With nobody handing out addresses, the controller and the laptop each pick a matching one by themselves, so pixelsetup.local and the USB shortcut both still find it.
3
3 minutes Network

Give It a Permanent Address and a Name

Out of the box the controller asks your router for an address, and your router is free to hand it a different one next week. That is fine for a first look, but a show controller should live at a fixed address - like a house number that never changes - so your show software always knows where to find it.

You will also have noticed an amber banner across the top of the screen. It is not an error - it is the controller pointing out that it is still answering to its setup name, which is the thing this step switches off. Here is that page, and the banner, as they look right now:

Warning — Setup discovery is ON
This controller can be reached by name at http://pixelsetup.local/. That is only meant for first-time setup. Once you have set your IP address, turn Setup discovery OFF so it isn't reachable by name and multiple boards don't clash on the same name.
Go to Network settings Dismiss for now
×
Device Identity
Device Name
ShowSpark-8
Network Settings
DHCP
Automatically assign IP from router
Setup discovery (pixelsetup.local)
Reach the board by name during setup. Turn off for permanent installs so multiple boards don't share the name.
DHCP is enabled - the device will request an IP from your router on boot. Check your router's DHCP lease table to find the assigned IP.
Save Settings Reload Reset Defaults

The Network page as it arrives: DHCP on, setup discovery on, banner showing. This step turns both switches off, and the banner goes with them.

So, on Network, three things:

  1. Switch off the automatic address option and enter a fixed address that suits your network. The easiest safe choice is one close to the address the controller is already using - if it is sitting at 192.168.1.100, something like 192.168.1.50 that nothing else has claimed. Press Check Availability beside the address box and the controller asks your network whether anything is already using it. The mask and gateway boxes need to match the rest of your network; if the page has already filled them in correctly, leave them as they are.
  2. Give it a friendly name, such as "Roof Line" or "Front Yard". It saves working out which is which once there are two of them on the network.
  3. Turn setup discovery off. The pixelsetup.local name is a welcome mat for first-time setup only - if two controllers both answer to it, they trip over each other.

Press Save. Because the address changed, the controller restarts to move to it. The page shows the new address and waits - usually somewhere between ten seconds and a minute - then takes you there by itself as soon as the controller answers. Leave the power on while it does.

Good to know The address is the only setting that needs a restart. Everything else in the control center takes effect the moment you save - no reboot button to hunt for and no "apply changes" ceremony.
4
4 minutes Your lights

Describe the Lights You Have

The controller has eight light ports, numbered 1 to 8, matching the eight connectors on the board. Nothing to assign, nothing to move - port 3 on screen is the third connector in your hand.

Open Pixel Outputs and you get eight cards, one per port. This is what a single card looks like on a controller straight out of the box:

Pixel Outputs Up to 8 independent LED ports (800 per port)
1 Port 1 Ch 1-900
Pixel Type WS2811
Model Name (from xLights)
800 kHz - 12V - reset >=300 us
Color Order RGB
Pixel Count 300
Start Ch. auto
Group Size 1
Brightness % 100%

One port card. The green tag on the right does the channel arithmetic for you - 300 lights using three channels each lands this port on channels 1 to 900.

For each port you have wired up, set:

  • On or off. Turn off the ports you are not using.
  • How many lights are on that string. An exact count matters here - the controller uses it to work out where each port's pixels begin and end.
  • What type of lights they are. The box or listing your lights came in almost always names the type. If you cannot find it, leave the setting as it arrived and see how the test in the next step looks - you can come straight back and try another.
  • Color order. Some strings expect their colors in a different order. If red comes out green in the next step, this is the setting to change.
  • A model name, if you like - "Roof Line", "Mega Tree" - so you can tell your ports apart at a glance. It is optional, and if you use xLights it fills these in for you (step 6).

Leave Start Ch. on auto. That tells the controller to lay your ports out end to end, one after another, which is exactly how show software expects to find them.

The last two fields can stay as they are. Group Size is for treating several lights as one big pixel, and Brightness % trims one individual port - useful when a single run is brighter than the rest of your display, but not something you need on day one. Press Save.

Everything looks dim? Brand-new controllers ship at 30 percent brightness on purpose - a wall of lights at full power indoors is genuinely dazzling, and it is kind to a small power supply. When you are ready, turn it up on the Display page.
5
3 minutes Prove it works

Run the Light Test Before You Go Any Further

This is the most satisfying step, and the one that saves the most time. You can start the test from the Pixel Test button at the bottom of the Pixel Outputs page you have just saved (the same button is on Diagnostics and Display), or by tapping the small Pixel Test button on the controller itself.

Each press moves to the next test, and the screen shows which one is running:

  1. Color Wash - a slow sweep through every color. Start here. A dead section or a wrong color order jumps straight out at you.
  2. Red, green, blue, white - one second each, so you can see exactly which color is misbehaving.
  3. Solid red, then green, then blue - handy when you are up a ladder staring at one run.

One more press turns the test off. Holding the button on the controller turns it off from wherever you are in the cycle.

Why this step comes before the rest If a string stays dark, or red and green have swapped places, step 4 is where the count, the type, and the color order get corrected. Everything from here on builds on those settings being right, so it is far quicker to settle them now than to unpick them from a finished show.
6
2 minutes Talking to your show

Pick the Language Your Show Software Speaks

When a computer streams a show to your lights, it has to send the data in a format the controller understands. Think of it as choosing a language - both ends have to pick the same one.

Open Live Input. The four options - DDP, E1.31 (sometimes written sACN), Art-Net and Glediator - are competing standards that do much the same job. What they stand for matters far less than both ends picking the same one.

Your controller arrives set to DDP, which is the simplest of the four and the one most people use. Unless you have a reason to change it, leave it alone and set your show software to DDP as well. Here is the page:

Input Protocol
Protocol selectable. DDP uses the proven absolute-channel input path on UDP 4048. E1.31/sACN (UDP 5568) and Art-Net (UDP 6454) both map sequential universes starting at the selected Start Universe.
Input Protocol DDP - UDP 4048
DDP and Glediator are linear/offset packets; E1.31 and Art-Net are universe/channel packets.
Active UDP Port 4048
Point your xLights/FPP DDP unicast output at this controller IP.
FPP Start Channel 1
Absolute/channel-range start number where the linear stream begins. For a clean test use 1.
Save

Live Input as it arrives. The only box you touch is the top one.

Do not be put off by the wording around it. Those grey notes are there for people wiring this into unusual software, and the dashed box simply reports the number the controller is listening on - it fills itself in when you choose a protocol. Leave FPP Start Channel at 1. Then press Save, and the setup is finished: your controller is on the network, it knows about your lights, and it is listening.

Scroll down that page and you will also find a table showing which channels each of your eight ports has been given. Nothing to fill in - it is the controller showing its working, and a quick way to confirm the ports line up end to end the way step 4 set them.

Using xLights? Run its discovery and your controller introduces itself automatically. Add it, choose the same language you picked here, and set it to Vendor MICROCYB, Model M8-PI. Then, on xLights' Controllers tab, click Visualise, drop each of your props onto the port it is really plugged into, and click Upload Output. The controller configures its own ports from that - light counts, color order and model names - so you do not have to type step 4 in twice. The Help page inside the control center walks through those xLights screens with pictures.

Afterwards, the control center's Visualiser page shows which prop landed on which port. If you plugged something into a different socket than you planned, drag it to the right port there and press Apply to Ports - no trip back to xLights needed tonight. Make the same move in xLights when you next sit down with it, because the next Upload Output replaces this layout with xLights' own.

Running your show from an FPP player? If a Falcon Player (FPP) on a Raspberry Pi or BeagleBone runs your show, the controller can follow it and play the same sequence from its own SD card in step with it. At the bottom of Live Input, switch on Follow an FPP player's MultiSync (multicast) and press Save - no restart. The controller then shows up on FPP's MultiSync page, and a sequence started on FPP starts here too, as long as a file with exactly the same name is on this controller's card. Leave it off if FPP streams the show to the controller instead (DDP or E1.31) - that needs nothing extra.
7
Right now The fun part

Light Up Your Display With No Software At All

You do not need a computer, a sequence, or an SD card to see something beautiful. Open Effects, pick a pattern and a color palette, and press Start Effect. The controller invents the show itself.

Built-In Effects
Runs on the controller - no computer needed. The effect is drawn across every enabled port as one continuous strip. Starting an effect takes over the pixel outputs: live streaming input and SD sequence playback are paused while it runs. Press Stop to hand the outputs back to your live show.
Effect Rainbow Cycle
Pattern drawn across all enabled ports.
Color Palette Rainbow
Most palettes supply their own colors. Choose Primary Color to use the color you pick below.
Speed (128)
How fast the pattern animates.
Intensity (128)
Density, tail length or spread - varies per effect.
My Effects
Name this effect Save Effect
Start Effect Stop

The Effects page. Two dropdowns, two sliders, and a button that starts the show.

There are 35 patterns built in - among them Rainbow, Chase, Twinkle, Fire, Plasma, Lightning, Bouncing Balls, Fireworks, Candy Cane, Snowfall, Icicle Drip and Halloween Eyes - and 15 color palettes, including ready-made Christmas, Halloween, Thanksgiving, Valentine's, Patriotic, St. Patrick's, Easter, Winter and Hanukkah sets. Drag the speed and intensity sliders while it is running and the display changes under your hands.

The pattern flows across all of your enabled ports as one continuous run, so a sweep travels over the whole display instead of restarting on every port. Press Stop to hand the lights back.

When you hit a combination you like, name it in the My Effects box and press Save Effect. It keeps the pattern, palette, color, speed and intensity exactly as you set them, and one click loads it back later. Presets are the one part of this page that does need an SD card in the slot, since that is where they are kept.

Secretly a test tool An effect is also the fastest way to prove every port and every pixel is alive. Start one, walk the display, fix what is dark.
8
When you are ready Hands-free shows

Let It Run the Whole Season By Itself

Slide an SD card in, put your show files on it, and the controller becomes a complete show player - no computer left running in the garage all December.

Getting your shows onto the card

Open Content Manager and drag your show files and music onto the Upload Files panel, or click it to browse. A progress bar tracks each one and it appears in the library below. Upload one at a time and let each finish. If you use xLights, its FPP Connect feature sends shows to the card the same way - both methods happily live side by side.

Upload Files
Upload .fseq sequences and .mp3 audio straight to the SD card. Files appear in the library below once each upload finishes. Uploads run one at a time.
Drag & drop files here, or click to browse Accepts .fseq and .mp3

Playing and organizing

The File Library on the same page lists everything on the card, and you can play anything by hand to test it. The buttons are color-coded so nothing that stops a show ever looks like something that starts one: green plays a show, blue plays music, and red stops or deletes.

Then open Playlists to group your shows into an evening. Press + New Playlist, give it a name, and add your shows with Add Sequence. A playlist can mix them with the built-in effects from step 7: save an effect on the Effects page first, then add it with Add Effect and choose how long it runs - "five minutes of Candle, then Wizards in Winter" is a perfectly good evening. Tick Repeat playlist continuously if it should go round and round, then press Save Playlist Set to SD Card.

File Library
Turn off the live stream to this device before playing local files.
Refresh SD Card List Files Stop Playback
Repeat - replay the playing sequence until Stop is pressed (FSEQ only)
File NameTypeSizeActions
Wizards.fseqFSEQ1.1 MB Play Delete
Wizards.mp3Audio3.1 MB Play Delete
Silent Night.fseqFSEQ887 KB Play Delete

Everything on the card, with the paired sequence and song sitting together.

Putting it on a timer

Open Show Scheduler and pick a saved playlist from the list. Turn on Enabled and choose the days of the week and the start and end times. Leave Restart if it finishes early ticked so a playlist that is shorter than its time window starts again instead of leaving the display dark. Tick the date-range option if it is only meant to run for a season - a range that crosses New Year is handled properly. Press Save Schedule to SD Card.

Then visit Clock / Time once to pick your time zone so your show starts when you think it will. Daylight saving is handled for you, forever.

Playlists
Christmas Nightly 5:00 PM - 10:00 PM
Halloween Not set up
Schedule for Christmas
Enabled
Restart if it finishes early
Start Time 17:00
End Time 22:00
Active Days SuMo TuWe ThFr Sa
Limit to a date range
Only runs on the selected days that also fall between these dates (inclusive). A range like Dec 1 to Jan 5 that crosses New Year is fine.
Save Schedule to SD Card

One window per playlist. A green dot means it is scheduled; grey means it is not.

Watching it run

Show Overview, the first page in the menu, shows what is playing right now. While a playlist plays, its Playlist Queue lists every item with the one playing marked and how far through it is. Previous and Next jump between items - handy for checking a song without waiting for the whole evening to come round. They wrap around at either end, so a press never ends the show.

Playlist Queue
Christmas - Item 2 of 3 | repeats continuously
1. Candle (effect) runs 5:00
2. Wizards.fseq 1:12 / 3:05 - Now playing
3. Silent Night.fseq plays 2x
Previous Next

The Playlist Queue appears on Show Overview whenever a playlist is playing.

Stop does not end a scheduled show While a schedule's time window is open, the schedule is in charge. Show Overview says so in an amber notice, and Stop Playlist or Stop SD Playback only pause the show for a moment - the schedule starts it again on its next check. To end the evening early, untick Enabled on that playlist in Show Scheduler and save.
Music in time with the lights With the optional audio add-on fitted, give the sound file the same name as the show file - Wizards.fseq and Wizards.mp3 - and put both on the card. Then open Audio Output, switch on Enable audio output and set the Master Volume. They start together and stay locked in step. Plain MP3 files work best, without embedded album artwork.

The Two Buttons On the Board

That is all there is. One shows off, one starts over.

Pixel Test

Tap it to step through the light tests from step 5, without touching a computer at all. Perfect when you are outside on a ladder with a phone in your pocket.

Hold it to switch the test off from any point in the cycle.

Factory Reset

Hold it for five seconds - while the controller is running, or while it starts up - and every setting returns to how it left the factory: address, ports, model names, all of it. Everything on the SD card - sequences, music, playlists and schedules - is left alone. The same reset is a button under Device Controls on the Firmware & Backup page.

This is your way back if you ever set an address you cannot reach. It is not a repair tool, it is an undo button - and if you saved a backup first (see below), one click puts your whole setup back afterwards.

Updates and Backups

Two things worth knowing about once everything works. Both live on the Firmware & Backup page.

New Firmware, One Button

Press Check for Updates. If MicroCyb has released something newer, the button becomes Install Now and the page lists what changed. One press downloads it, checks it, and installs it over the network. The controller restarts once, the page reconnects on its own, and your settings are kept. It takes about a minute - just leave the power on.

Anything running is stopped first - a show from the card, scheduled or not, and any live stream from your computer - so pick a moment when the display is not entertaining anyone.

If a new version ever gives you trouble, Show previous versions lists the earlier releases, and you can go back to one the same way. Each one says whether your settings carry over; where they might not, it tells you to save a backup first.

Who talks to whom The check uses the internet connection of the computer or phone you are browsing on. The controller itself never contacts MicroCyb and sends nothing about you or your show. On a show network with no internet, the check simply says it could not reach the update server, and nothing else is affected.

Back Up Your Whole Setup

Under Backup & Restore, press Download Backup. One small file on your computer now holds everything you set up: network, ports, model names, the xLights layout, protocol, clock, audio, playlists, schedules, and your saved effects and colors. (Your sequence and music files stay on the SD card.)

Restore from File puts it all back in one go - after a factory reset, or onto a replacement controller so it is set up exactly like the old one. The controller restarts and the page reconnects by itself.

Setting up a second controller? Restoring asks whether to bring the network settings across too. Leave that off when you are copying a setup to an extra controller, so the two do not end up fighting over one address. Turn it on when the new controller is replacing the old one.

What Every Page Is For

The menu down the left of the control center, in plain English and in the same order - Your Show, then Controller Setup, then System. Setup today mostly happens in the middle group.

Show Overview
What is playing right now, the Playlist Queue with Previous and Next, and whether a schedule is in charge.
Content Manager
Your SD card: upload shows and music, see what is on it, and play a file to test it.
Playlists
Line up shows and saved effects into an evening, then play it.
Show Scheduler
Days and times for each playlist to start and stop on its own.
Audio Output
Sound on or off, and the volume, for the optional audio add-on.
Network
Where the controller lives on your network, and what it is called.
Pixel Outputs
How many lights are on each port, what kind they are, and what to call them.
Visualiser
Which prop is on which port, as xLights sent it. Drag one to another port to rewire on screen.
Live Input
How a show streamed from a computer reaches the controller, and following an FPP player.
Effects
Built-in patterns and palettes. Instant lights, no software.
Clock / Time
Time zone and clock, so the schedule fires when you expect.
Display
Overall brightness and color smoothing for the whole display, and the start-up sweep.
Diagnostics
How the controller is coping right now, port by port, plus the light test.
Firmware & Backup
Its exact address and firmware version, updates, backup and restore, restart and factory reset.
Help
The full illustrated guide, including the xLights screens.
About
Which firmware version you have, plus license and safety notes.

If Something Is Not Right

Almost every first-day hiccup is one of these nine, and none of them mean anything is broken.

The web page will not open at all

On a Windows PC, set your network to Private as described in step 2 - this is by far the most common cause, and it is a Windows setting, not a fault.

On a phone or tablet, check it is on Wi-Fi from the same router rather than mobile data. This one hides well, because the phone still shows a full connection either way.

Otherwise, use the USB shortcut from step 2 - plug in a USB-C cable and double-click START HERE on the drive that appears - or look for the controller in your router's list of connected devices. The network cable being seated at both ends is worth a glance too.

No lights at all, anywhere

Start with power. The network cable carries the show, not the electricity, so your lights need a DC supply of their own. If the controller's web page loads happily but nothing glows, that supply is the first thing to look at.

Running on USB-C? It will light a few pixels, but a full string asks for far more power than a USB socket can provide, and the usual result is a display that stays dark. Connect the proper supply before concluding anything is broken.

Then check direction: light strings are one-way, and the little arrow printed on them must point away from the controller. A string wired backwards stays perfectly dark and looks exactly like a broken one.

Finally, make sure the port is switched on in Pixel Outputs and its light count is not zero.

The colors are wrong - red comes out green

Harmless and expected. Different manufacturers send their colors in a different order. Go to Pixel Outputs, change the color order for that port, save, and run the light test again. Work through the options until red really is red.

Only part of a string lights up

Usually the light count for that port is lower than the number of lights actually hanging there. Re-count the string and correct the number in Pixel Outputs.

If the string dies at the same physical spot every time no matter what you set, that is hardware - a damaged light or connector. Everything after a failed light goes dark, so the first dark light is the one to replace.

Everything works but it all looks a bit feeble

Your controller arrives at 30 percent brightness deliberately - it is gentle on a small bench supply and much kinder to your eyes indoors. Raise it on the Display page whenever you are ready.

Before you push it to full outdoors, make sure your power supply is comfortable with every light at maximum. That is when a display draws the most - and if turning the brightness up brings on flicker or odd colors, the last entry on this list is the one you want.

A show on the SD card will not start

Live streaming always wins. If a computer is streaming a show to the controller, it will not play from the card at the same time - stop the stream and the card takes over again within a few seconds. The control center tells you when this is what is happening.

Otherwise: is the card actually in, and formatted as FAT32? Use Refresh SD Card if you swapped cards while it was running. If a file genuinely cannot play, the controller says so in plain language and tells you what to change - follow that message, it is usually a one-click fix.

I pressed Stop and the show started again by itself

That is the schedule doing its job. While a playlist's time window is open, the schedule keeps it running, so a Stop only lasts until its next check - a few seconds. Show Overview says when a schedule is in charge.

To finish early tonight, open Show Scheduler, untick Enabled for that playlist and press Save Schedule to SD Card; the show stops and stays stopped. Remember to tick it again before tomorrow evening.

I changed a setting and now I cannot reach it

Try the USB shortcut from step 2 first: plug in a USB-C cable and double-click START HERE. It always points at the address the controller is really using, so even after a typo you can see where it went - and if that address suits your network, you are straight back in to correct it.

If that cannot reach it either, this is exactly what the Factory Reset button is for. Hold it for five seconds and the controller returns to how it arrived, ready at pixelsetup.local again.

Only your settings are lost - everything on the SD card is untouched. If you saved a backup, Restore from File on the Firmware & Backup page puts everything else back in one step; otherwise steps 3 to 6 do it in about ten minutes.

Dim, flickering or color-shifted lights on a proper DC supply

These are the same symptoms as asking too much of USB-C, and the underlying cause is the same: the lights are drawing more power than is actually reaching them. On a real supply it shows up in two distinct ways, and the pattern tells you which one you have.

The whole display misbehaves at once. Every pixel draws current, and across hundreds of them it adds up quickly - a supply that cannot deliver the total sags under load. The giveaway is that it gets worse the brighter you go. Turn the master brightness down on Display: if everything steadies, the supply has reached its limit rather than the controller doing something wrong. (If it looks uniformly dim but perfectly stable, that is the 30 percent factory brightness above, not a power problem.)

The start of a run looks right and the far end fades. Colors drift as you walk along it - whites going yellow, then orange, then red toward the end. Power is being lost along the length of the wire itself, so the last pixels receive noticeably less than the first. The cure is power injection: running a second pair of wires from your supply to the far end of the string, and to the middle as well on long runs, so power arrives from both directions instead of trickling the whole way down. Feed injected power from the same supply, and keep the ground shared.

This is also why longer outdoor runs tend to be 12V rather than 5V - the higher voltage loses less over distance. How many lights you can run before injection becomes necessary depends on the strings you bought, so your supplier's guidance beats any general rule of thumb here.

Six Things Worth Remembering

  1. Saving happens immediately. Change it, save it, done. The one exception is the network address, which restarts the controller - and the page follows it to its new home for you.
  2. Live streaming always wins. If a computer starts streaming a show, the controller hands the lights straight over and picks its own schedule back up afterwards.
  3. Leave the start channels on auto. Unless you have a very deliberate reason not to, auto keeps your controller and your show software in perfect agreement.
  4. Re-send your shows after you rewire anything. If you change light counts or move a prop to a different port, update xLights, press Upload Output, and upload your sequences again so both ends agree.
  5. Download a backup once it all works. One file on your computer, and a factory reset or a replacement controller is a one-click restore instead of an evening.
  6. The Help page is the deep end. This page got you running; the Help page inside the control center covers every screen in detail, with pictures, whenever you want more.