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.

Or just use the number

Every controller also answers at a plain numeric address. If something else on your network already claimed the first one, the controller quietly takes the next free address, so try these in order until one opens:

192.168.1.100.101.102.103.104.105

Once you are in, the Status page tells you the exact address the controller is using. Write it on a sticky note. Your router's list of connected devices will show it too.

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. 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. The controller switches to its new address straight away, so your browser page goes quiet. That is expected - just browse to the new address you chose and carry on.

Good to know Saving takes effect immediately anywhere in the control center. There is 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
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.

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 on the Status page, 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, set it to eight ports, then assign each of your props to the port it is really plugged into. The Help page inside the control center walks through those xLights screens with pictures.
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 25 patterns built in - among them Rainbow, Chase, Twinkle, Fire, Plasma, Lightning, Bouncing Balls and Fireworks - 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

From the same page you can play anything by hand to test it, and group your shows into playlists. The buttons are color-coded so nothing that stops a show ever looks like something that starts one: green plays a show or playlist, blue plays music, and red stops or deletes.

FSEQ 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)
Sequence 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, add an entry, and choose the playlist, the days of the week, and the start and stop times. Tick the date-range option if it is only meant to run for a season - a range that crosses New Year is handled properly. 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
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.

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 - put both on the card, then switch on audio output and set the volume in Content Manager. 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 starts up and everything returns to how it left the factory - address, ports, all of it.

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 it costs you nothing but the few minutes of this page.

What Every Page Is For

The menu down the left of the control center, in plain English. You will only need the first few today.

Network
Where the controller lives on your network, and what it is called.
Pixel Outputs
How many lights are on each port, and what kind they are.
Live Input
How a show streamed from a computer reaches the controller.
Effects
Built-in patterns and palettes. Instant lights, no software.
Content Manager
Your SD card: upload shows and music, build playlists, press play.
Show Scheduler
Days and times for shows to start and stop on their own.
Clock / Time
Time zone and clock, so the schedule fires when you expect.
Display
Overall brightness and color smoothing for the whole display.
Status
How everything is doing right now, including its exact address.
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 eight, 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, try the numeric addresses from step 2 one after another, or open your router's list of connected devices and look for the controller there. 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 changed a setting and now I cannot reach it

This is exactly what the Factory Reset button is for. Hold it for five seconds while the controller starts up and it returns to how it arrived, ready at pixelsetup.local again.

Only your settings are lost - sequences and music on the SD card are untouched, and steps 3 to 6 put the rest back 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.

Five Things Worth Remembering

  1. Saving happens immediately. There is no reboot step anywhere in the control center. Change it, save it, done.
  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, upload your sequences again so both ends agree.
  5. 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.