Xlights Portable: The Ultimate Portable Light-Show Controller

How to Set Up Xlights Portable for Mobile Holiday Displays

Overview

This guide walks you step-by-step to set up xLights Portable for mobile holiday displays (truck/van/trailer). It assumes basic familiarity with xLights concepts (sequences, controllers, layouts) and that you’re using the portable build to run shows on a laptop or compact PC in a vehicle.

What you’ll need

• Computer: Laptop or compact PC with xLights Portable installed.
• Power & mounting: Secure, ventilated place to run the computer; stable power source (battery/inverter or vehicle power).
• Ethernet adapter(s): USB-to-Ethernet if your computer lacks ports.
• DMX/E1.31 controllers or pixel controllers: e.g., Falcon, HolidayCoro, Advatek, etc.
• Network switch (if using multiple controllers): Gigabit recommended.
• Cables: Ethernet, power, and any controller-specific wiring.
• Backup drive or USB stick: For sequence copies and troubleshooting.
• Optional: USB hub, UPS, audio interface, GPS/timer for syncing.

1. Install xLights Portable

1. Download the latest xLights Portable package from the official xLights site (choose the portable/tactical build).
2. Extract the zip to a dedicated folder on your internal drive or an external SSD.
3. Run the xLights executable from that folder — the portable build keeps settings local to the folder.

2. Prepare your show folder and sequences

1. Copy your show folder (Layouts, Sequences, Logs, Documents) into the xLights Portable directory or point xLights Portable to your show folder via Preferences → Folders.
2. Verify sequences play in the desktop environment before mobile deployment. Use lower resolution test sequences if hardware is constrained.

3. Configure Network and Controllers

1. Assign a static IP to your computer’s primary Ethernet adapter suitable for your controllers (commonly 2.x.x.x for E1.31/Art-Net devices). Example: 2.0.0.10.
2. Connect the computer to the network switch, then controllers to the switch. For a single controller, connect directly with a crossover or straight-through cable as appropriate.
3. In xLights: Controllers → Add. Select the correct controller type (e.g., E1.31, Falcon, Advatek) and set the controller IP address and universe mappings to match your hardware.
4. For pixel controllers, ensure pixel counts, channels, and mappings match the layout definitions.

4. Build a Mobile Layout

1. Open Layout Editor → New Layout. Choose units (pixels vs. channels).
2. Model your vehicle: add models representing the roofline, trailer outline, starbursts, props, and underbody. Use compact pixel spacing to reflect real pixel counts.
3. Assign controllers and universes to each model segment to mirror wiring. Use clear names (e.g., “Trailer_Roof_US-1_U1”).
4. Save layout inside the portable show folder.

5. Optimize Performance for Mobile Use

• Use a single monitor or reduced preview resolution to lower CPU/GPU load.
• Reduce GUI refresh rate in Preferences → Performance.
• Limit simultaneous high-channel sequences; stagger effects across universes.
• Pre-render or pre-cache large audio/video assets to local storage.
• Disable unneeded services and background apps on the laptop.

6. Audio Sync and Playback

1. If using onboard audio, set Audio Device in xLights Preferences → Audio to the correct sound card or USB interface.
2. For vehicle-wide audio, run a line-out to your amplifier; test levels before shows. Consider using compression/limiters to prevent clipping.
3. For GPS or time-based triggers, configure the trigger device or use a USB GPS/time module; alternatively, run sequences manually with cueing software.

7. Test Run Before Going Live

1. Do a full wired test with all controllers connected. Play the entire playlist and watch for dropped pixels, timing offsets, or network errors.
2. Check logs for packet loss or timeout warnings.
3. Confirm audio sync on-device and at speaker outputs.
4. Note power draw for all controllers and lights; ensure vehicle power can handle the load.

8. Operational Checklist for Show Night

• Computer mounted securely and ventilated.
• Ethernet connections checked and labeled.
• Spare cables, USB-Ethernet adapters, and a backup bootable drive present.
• Power plan set to prevent sleep; disable automatic updates.
• Volume and broadcast levels tested.
• Emergency stop procedure for disabling lights quickly.

9. Troubleshooting Tips

• No lights: Confirm controller IP and universe settings; ping controllers.
• Pixel order wrong: Swap direction in Layout Editor or reverse wiring on controller settings.
• Skipping frames/dropouts: Lower refresh rate, reduce channels per sequence, or check network cabling.
• Audio out-of-sync: Re-time sequence, ensure audio device buffer settings are correct.

10. Helpful Best Practices

• Keep the portable folder self-contained for quick swaps between computers.
• Label wiring and document universe-to-model mappings in a text file in the show folder.
• Use conservative pixel counts per controller to reduce congestion.
• Regularly backup your portable show folder to a separate drive.

If you want, I can create a sample mobile layout file structure or a compact pre-show checklist you can print and tape in the vehicle.