Pixel Mapper xModel
xModel pixel mapping tool
Free · Designed for iPad. Not verified for macOS.
Point your camera at your light display and auto-build an xLights custom model — no clicking pixel by pixel. Works over DDP and sACN / E1.31.
Pixel Mapper turns your iPhone or iPad into an automatic layout tool for
xLights. Point your camera at your light display, and the app lights each
WS2811 / WS2812 pixel, finds it in the camera image with computer vision, and
builds a ready-to-import xLights Custom model — no manual clicking pixel by
pixel.
Perfect for Christmas light displays, props, matrices, megatrees, and any
irregular pixel layout that's painful to map by hand.
HOW IT WORKS
1. Target — enter your controller's IP and pixel count. Output goes over DDP or
sACN / E1.31, the same protocols xLights and FPP already speak.
2. Scan — choose a mode:
• Fast (base-3): every pixel lights in every frame, colored by one base-3
digit of its index, so all pixels are identified in only ~log3(N)+2 frames
(about 500 pixels in 8 frames). Two checksum digits reject misreads.
• Sequential: light one pixel at a time and find the single bright blob.
Slower, but dead simple and rock solid.
Both modes subtract a black reference frame to ignore ambient hotspots.
3. Review — see the detected layout over your photo, drop bad points, tap to
place or move a node, and re-scan individual pixels. Zoom and pan to fine-tune.
4. Export — save a standard xLights .xmodel file that imports into both old and
new versions of xLights.
WHY PIXEL MAPPER
• No more mapping hundreds of pixels by hand.
• Works with the gear you already own — any DDP or sACN/E1.31 pixel controller.
• Fast base-3 scan maps large models in seconds of capture.
• Checksum-protected so misread pixels get rejected, not placed wrong.
• Best results in a dim room; the app locks camera exposure and focus where
the device supports it.
REQUIREMENTS
• A WS2811 / WS2812 (or compatible) pixel controller reachable on your network.
• The controller set to receive DDP or sACN / E1.31.
• An iPhone or iPad on the same Wi-Fi network as the controller.
Pixel Mapper is an independent tool and is not affiliated with or endorsed by
the xLights project. xLights is a trademark of its respective owners.
Ratings & Reviews
- This app hasn’t received enough ratings or reviews to display an overview.
The developer, S&B Designs, indicated that the app’s privacy practices may include handling of data as described below. For more information, see the developer’s privacy policy .
Data Not Collected
The developer does not collect any data from this app.
Accessibility
The developer has not yet indicated which accessibility features this app supports. Learn More
Information
- Seller
- S&B Designs LLC
- Size
- 23.8 MB
- Category
- Utilities
- Compatibility
Requires iOS 13.0 or later.
- iPhone
Requires iOS 13.0 or later. - iPad
Requires iPadOS 13.0 or later. - iPod touch
Requires iOS 13.0 or later. - Mac
Requires macOS 11.0 or later and a Mac with Apple M1 chip or later. - Apple Vision
Requires visionOS 1.0 or later.
- iPhone
- Languages
- English
- Age Rating
4+
- 4+
- Copyright
- © S&B Designs LLC
