Configuring your FPP Remote

Configuring your FPP Remote

The beta release of ESPixelStick lets you use your Solo2Go, Tetra2Go, or Octa2Go as an FPP Remote, playing sequences directly from an onboard SD card and syncing with your show player. You'll need the SD Card Module to take advantage of this functionality.

⚠️
This will NOT work on the Duo2Go. FPP Remote requires the SD Card Module, which is only available for the Solo2Go, Tetra2Go, and Octa2Go.
⚠️
ESPixelStick v4 is still in beta. It has not been officially released, and you may encounter issues. Fully test any setup before relying on it for a show.
Don't have ESPixelStick installed yet? See our ESPixelStick Flashing Guide first, then note the IP address of your installation before continuing below.
Part 1 — Configure ESPixelStick
1 Open the Web Interface

Browse to your controller's ESPixelStick web interface by entering its IP address into your web browser.

ESPixelStick web interface home page
2 Configure Your Outputs

Open the Device Setup tab and make sure your outputs are enabled — typically WS2811, though this can vary depending on your pixel type. Once enabled, set the color order, brightness, and pixel count for each output.

3 Configure Your Inputs

Still on the Device Setup screen, set your Primary Input to either E1.31 or DDP, depending on preference. DDP is generally easier to configure than E1.31. Set your Secondary Input to FPP Remote.

ESPixelStick device inputs configuration
4 Reboot the Device

Click the Admin tab, then click Reboot. Allow about 15 seconds for the controller to come back online before continuing.

ESPixelStick admin reboot button
Part 2 — Configure in xLights
5 Open xLights and Select Your Show Folder

Open xLights. Under the Controllers tab, make sure you're pointed at the correct Show folder.

xLights show folder selection
6 Discover Your Controller

If your controller isn't already detected, click Controllers → Discover. It should be found automatically if it's on the same network as your xLights workstation.

xLights discover button xLights discover results showing controller found

Click Save to keep the newly discovered controller.

7 Verify Your Layout

Open the Layout tab and confirm the props connected to your controller are correct. The Visualize button is a quick way to check this.

xLights visualize button xLights visualization preview

Your props will look different — this is just an example.

8 Upload Output Settings

Once your outputs look correct, click Upload Output on the Controllers tab.

⚠️
This will overwrite your existing output settings on the controller.
xLights upload output button
9 Double-Check Output Settings

Back in the ESPixelStick web interface, verify the output settings match what xLights expects. Depending on your firmware version, you may need to re-set the Primary and Secondary inputs — double-check those as well.

Checking output settings match in ESPixelStick
10 Preview the Sequence

Finish your sequence in xLights. You can preview it live by clicking the lightbulb icon to output directly to your lights.

💡
This uses significant resources — confirm playback works correctly, then turn it off before continuing.
xLights lightbulb live preview icon
Part 3 — Set Up the SD Card and Upload Your Sequence
11 Insert the SD Card

Make sure an SD card is inserted into the SD Card Module. This module is required for FPP Remote functionality.

SD card module with card inserted
12 Verify the SD Card Is Detected

In the ESPixelStick web interface, confirm a File Management tab is present. If you see it, click in to verify the size of the installed SD card is detected correctly.

ESPixelStick file management tab showing SD card
13 Upload via FPP Connect

From xLights, click Tools → FPP Connect.

xLights Tools menu FPP Connect option

Your controller's FPP Remote daemon should be detected automatically — make sure it's checked, and select your show player as well. Check the sequence(s) you'd like to upload, then click Upload in the lower right corner.

💡
This may take a while — ESPixelStick only supports uncompressed sequences.
xLights FPP upload dialog xLights FPP upload progress
14 Confirm the Upload

Once the upload window closes, your sequence has been transferred to the SD card. Return to the File Management tab in the ESPixelStick web interface to verify the file is present.

Part 4 — Play Your Show
15 Configure Your Show Player

In FPP, go to Status/Control → FPP Multisync and confirm your devices are listed. If your network doesn't support multicast, check the Unicast Sync box.

FPP multisync configuration showing connected devices
16 Start the Sequence

You can start the sequence from your show player, or play it directly from the controller. To do the latter, go back to the Device Setup tab in the ESPixelStick web interface, scroll to FPP Remote Configuration, and choose the FSEQ file to play from the dropdown.

ESPixelStick FPP remote configuration FSEQ file dropdown

After choosing your sequence, scroll to the bottom and click Save Changes — your sequence will start playing.

🎉
Your controller is configured as an FPP Remote!
Questions or run into an issue? Contact us at jason@rgb2go.com.