A professional LED video wall layout designer for live events, concerts, and installations.

Design LED cabinet layouts, plan the real-world stage layout, configure data flow paths, plan power distribution, and export production documentation.

1. Download the latest Mac release (a .dmg file)
2. Open the .dmg and drag LED Raster Designer onto the Applications folder shown in the window
3. Open LED Raster Designer from your Applications folder (or Launchpad)
4. When macOS asks, allow it to access devices on your Local Network, this is required so other devices (and your own browser) can reach the app
5. Your browser opens automatically, start designing
6. Look for the 💡 in your menu bar to reopen the browser or quit

Why Applications matters: macOS only shows the Local Network permission prompt for apps installed in /Applications. If you run it from the Downloads folder or directly from the disk image, the prompt never appears and the app can't be reached over your network. Always install it to Applications first.

If you ever need them, logs live in ~/Library/Logs/LED Raster Designer/ (also reachable via the app's Show Logs → Open Folder button).

1. Download the latest Windows release
2. Unzip the file
3. Double-click LED Raster Designer.exe
4. Your browser opens automatically, start designing
5. Look for the lightbulb in your system tray (bottom-right) to reopen the browser or quit

Other devices on your local network can use the app by going to http://[your-ip]:8050 in their browser (the exact address is shown when the app starts).

A clean, desktop-style "Studio" interface: titled docked panels, beveled neutral-gray surfaces, a system typeface, and a red accent. The app icon and toolbar carry the new logo.

• Accent color, choose the interface accent in Preferences → Appearance (red, blue, green, amber, purple, teal). It applies app-wide and is remembered.
• Resizable side panels, drag the inner edge of either sidebar to make it wider or narrower; each side's width is remembered. The ‹ / › chevrons still collapse a sidebar entirely.
• One-click color picker, clicking any color control opens the picker directly: a built-in color wheel on Windows, the native OS picker on macOS.
• Per-canvas color, each canvas's Screens header is tinted with that canvas's identity color, so canvases are easy to tell apart at a glance.

A project can hold multiple independent canvases, each with its own raster size, workspace position, perspective, and layers. Think of one canvas per processor / per stage / per tour leg.

• Right-sidebar Screens panel groups layers by canvas. Each canvas has a color swatch, name, eye toggle (visibility), and a + Add button to drop new layers in.
• Drag a canvas by its dashed outline to reposition it in the workspace. Magnetic snap aligns edges with neighboring canvases.
• Drag (Shift+Drag) a screen layer onto another canvas to move it there. Cmd/Alt+Shift+Drag duplicates instead. The layer snaps to (0,0) in the new canvas.
• Per-canvas raster: the toolbar Raster: W x H and the Show Look raster always reflect the active canvas. Each canvas can be sized independently.
• Per-canvas Front/Back perspective for Data and Power. Switching the active canvas updates the toggle.
• Cross-canvas multi-select: Shift+click layers in different canvases and bulk-edit them at once (panel size, voltage, processor type, etc.). The selection survives the active-canvas auto-switch.
• Hidden canvases are excluded from the Data/Power totals and from exports by default.
• Per-canvas presets: a new screen added to a canvas inherits hardware settings (voltage, amperage, panel size, processor type) from the most recent screen already in that canvas.

• Add, duplicate, delete, and reorder screen layers
• Add image/logo layers with scale control
• Add text label layers (per-tab visibility, alignment, fonts, etc.)
• Multi-select screens (Shift+click range, Cmd/Ctrl+click toggle, drag-select on canvas)
• Layer locking, visibility toggle, and drag reorder
• Double-click a layer name to rename it
• Save layers as presets to reuse across projects

Drag-select any group of panels in Pixel Map view, then bulk-toggle their state, or use modifier keys for fast single-panel edits.

Half-tiles count as 0.5 panel for data/port math and 0.65 panel for power/weight (the typical industry derate).

• 8 serpentine flow patterns (all corner starts × horizontal/vertical)
• Custom data path mode, click panels in order to draw your own port routing, or drag-select a region and apply a flow pattern just to that region
• Port capacity calculator supporting:
  • NovaStar (Legacy, Armor, COEX)
  • Brompton Tessera
  • Megapixel HELIOS
• Configurable bit depth (8 / 10 / 12-bit) and frame rate
• Editable port labels with templates and per-port overrides (auto-increments soca numbers like S1-1..S1-6, S2-1..S2-6 from any starting template)
• Over-capacity error detection with visual overlay
• Per-screen primary / backup port colors and label sizes
• Optional per-port info display directly on the panel
• Front / Back view perspective, independent toggle in the sidebar. Back view horizontally mirrors the canvas geometry (so wiring matches what you see standing behind the wall) while keeping every label readable, shows a "BACK VIEW" badge in the corner, and auto-appends _back to the export filename suffix.

• Circuit-based serpentine routing with configurable voltage, amperage, and watts
• Custom power path mode, draw circuits manually for non-standard wiring
• Color-coded circuit visualization with customizable per-circuit colors
• Organized and max-capacity mapping modes
• 1-phase and 3-phase power calculations
• Circuit start labels with directional pointers
• Per-circuit label overrides
• Front / Back view perspective, same independent toggle as Data, with mirrored geometry and "BACK VIEW" badge.

• Save / open projects as .json files (preserves all layers, settings, and panel state)
• Recent Files menu in the File menu
• Auto-update check (notifies when a new release is available)
• Per-panel state (hidden, half-tile) survives column/row resizes (state is anchored to grid position, not sequential id)
• v0.7 → v0.8 auto-migration on load: opens any older project and converts it into the multi-canvas format with one canvas containing all the original layers. A one-time toast reminds you to save in the new format. v0.7 builds opening a v0.8 file get a clean "format newer than supported" error.

• Multi-view PNG export, pick which views (Pixel Map, Cabinet ID, Show Look, Data, Power) to render in one go
• Multi-canvas aware (v0.8): the Export dialog adds a Canvases section above Views. Each (canvas × view) is one PNG / one PSD / one PDF page. PDF page headers include canvas + view name. Resolume XML now emits one <Screen> per canvas, sized to that canvas's raster.
• PSD export with per-screen layers (per-canvas filtered, only that canvas's layers in each PSD)
• PDF export (multi-page across selected canvases × views)
• Resolume Arena Advanced Output XML export (one <Screen> per canvas, named after the canvas)
• Configurable export filename suffixes per view (saved as defaults)
• Project-name input flags illegal filename characters (\ / : * ? " < > |) and auto-sanitizes them on export

• Built-in panel presets for many manufacturers (ROE, Leyard, Barco, INFiLED, ARTFOX, etc.)
• ⭐ marker on panels with verified specs (cross-checked against manufacturer datasheets)
• Live catalog refresh, ↻ Refresh button in the Add Screen modal pulls the latest panel_catalog.json from GitHub without needing to reinstall the app. Boot-time silent check shows a "📦 Update available" pill when newer panels are out. Refreshed catalog persists per browser.
• Favorites, heart any panel in the catalog to pin it to the left column alongside your saved presets. Drag-reorder the left column to suit your typical workflow. Per-user, persists in localStorage.
• "Submit a correction" / "Add missing panel" link inside the app opens a pre-filled GitHub issue (with a confirmation that the user must click "Submit new issue" on GitHub for it to actually reach us, submissions used to silently drop)

• Default raster size, grid colors, flow patterns, and line widths
• Default processor, bit depth, frame rate, voltage, and amperage
• Default panel size (mm) and weight unit (kg / lb)
• Default label / screen-name font size, the screen name now uses this same size on every tab (Pixel Map, Cabinet ID, Data, Power), so it stays consistent
• Appearance: pick the interface accent color
• Settings persist across sessions

If you want to build the app yourself instead of downloading the release:

• Python 3.10+, Download from python.org
• Windows users: During Python install, CHECK the box "Add Python to PATH"

1. Clone or download this repo
2. Open Terminal and run:

   cd "/path/to/LED Raster Designer"
   make mac
   

3. The app appears in the folder, double-click LED Raster Designer.app

1. Clone or download this repo
2. Double-click Build Windows.bat
3. The app appears in the folder, double-click LED Raster Designer App\LED Raster Designer.exe

• Mac: make clean
• Windows: Build Windows.bat clean (from Command Prompt)

Source code is in the src/ folder. See BUILD.md for more details.

Open an issue at github.com/kman1898/LED-Raster-Designer/issues. For feature suggestions please include the use case, and for bug reports please attach the relevant log (Help → Show Logs… → Copy).

Versions follow vMAJOR.MINOR.PATCH (e.g. v0.8.11). PATCH is a fix or small change; MINOR is new features; MAJOR is reserved for the 1.0 milestone and beyond. The version string is kept in sync across README.md, src/VERSION.txt, src/templates/index.html, and src/led_raster_designer.spec.

Every public release is git-tagged vX.Y.Z and gets release notes drawn from the matching src/VERSION.txt entry, never the auto-generated PR list alone, so the GitHub Releases page reads consistently. Internal test builds are produced via the workflow's manual dispatch and are not tagged, so the public release history has no gaps.

For questions or feedback during beta testing, please contact the development team.