DMX Mapping Window

Last updated 12 June 2026

DMX Mapping Window

The DMX Mapping window is a visual pixel-mapping editor for ArtNet outputs. It displays the output's pixel grid and shows which pixels are mapped to which Art-Net universes and DMX channels. Use it to inspect, create, and edit pixel-to-universe mappings for LED fixtures and Art-Net devices.

[USER-ACTION-REQUIRED: Attach a screenshot of the DMX Mapping window showing a populated grid with the minimap and nav overlay visible]

Opening the window

Open the DMX Mapping window in either of two ways:

  • View menu > DMX Mapping

  • Select an ArtNet output in the Outputs panel, expand the DMX Mapping section in the Inspector, and click Show Mapping Window.

The window remembers the last ArtNet output you viewed, per user. If no ArtNet output is selected, the window shows an output selector dropdown.

Grid

Grid settings and controls

The grid represents the ArtNet output's pixel space. Each cell is one output pixel. The grid dimensions match the output's width and height.

Setting

Description

Values / Range

Cell colour

Each mapped pixel is colour-coded by its assigned Art-Net universe. Unmapped pixels are dark grey.

Automatic hue per universe

Channel numbers

At the highest zoom level, each cell displays its DMX start channel number for the currently selected universe.

1–512 (visible at full zoom only)

Rulers

Column numbers along the top and row numbers along the left edge. Show the first and last visible index.

1-based

Grid lines

Visible when cells are large enough (6 px or more on screen). Hidden automatically at small zoom levels.

Automatic

Navigation

Navigation controls

Control

Description

Values / Range

Mouse wheel

Zoom in and out, anchored at the cursor position. At maximum zoom, wheel scrolling pans the grid toward the cursor.

Scroll up = zoom in, scroll down = zoom out

Middle-mouse drag

Pan the grid. Drag direction moves the view in that direction.

Free drag

Fit button (nav overlay)

Top button of the three-button overlay in the top-right area (below the minimap). Zooms out to fit the entire grid in the window.

Click

Zoom button (nav overlay)

Middle button of the nav overlay. Click and drag vertically to zoom (drag up = zoom in, drag down = zoom out). Zooms about the view centre.

Drag

Pan button (nav overlay)

Bottom button of the nav overlay. Click and drag to pan the view.

Drag

Minimap

A small overview in the top-right corner shows the entire grid. A white rectangle marks the currently visible portion. Click or drag the minimap to reposition the view. Mouse wheel over the minimap zooms about the view centre.

Click or drag

Live Data Overlay

Live data overlay

Enable the Live data checkbox (top of the window, next to the output selector) to colour each mapped pixel by the actual DMX RGB values currently being sent. The minimap also reflects live data when this mode is active.

The data refreshes every frame. If the send thread is busy, the previous frame's snapshot is kept, so the UI never stalls.

Selection and Editing

Selection and editing controls

Action

Description

Details

Left-click

Select a single pixel. If the pixel is mapped, its universe becomes the selected universe automatically.

Universe auto-select syncs with the Inspector's Selected Universe dropdown

Left-click + drag

Select a horizontal or vertical line of pixels. The selection locks to whichever axis you drag further along.

Selection is always a single row or column, never a rectangle

Hover tooltip

Shows the pixel's grid coordinates. For mapped pixels, also shows the universe number and DMX channel.

Format: X:N Y:N / Universe N Ch N. During drag, shows pixel count.

Inspector sync

When the selection covers a single mapping entry, the corresponding entry in the Inspector's Pixel Mappings list is highlighted and scrolled into view.

Automatic

Right-Click Context Menu

Context menu actions

Right-click on the grid to open a context menu. The available actions depend on whether the clicked pixel is mapped or unmapped, and whether an active selection exists.

Menu Item

Description

Condition

Add pixel mapping

Creates a new pixel mapping entry for the selected universe using the current selection's position, direction, and pixel count. DMX address auto-increments from existing entries.

Right-click on unmapped pixel within a selection

Delete mapping

Removes the mapping entry that covers the selected pixel(s). If a selection spans multiple entries, all intersecting entries are removed.

Right-click on a mapped pixel

Locate submenu

Light up specific pixels on the physical fixture to identify them. Options: Locate selected (highlights the selected pixels), Locate row, Locate column. "Dim other pixels during locate" dims non-located pixels for contrast.

Output must be routed (connected). Locate row/column require a single-pixel selection.

Skip DMX address

Marks the DMX start channel(s) of the selected pixel(s) as skipped. Skipped channels are omitted from the Art-Net output.

Selection on mapped pixels

Re-Enable DMX address

Removes a skip from a previously skipped DMX address. Shows a submenu listing all currently skipped addresses for the selected universe.

Selected universe has skipped addresses

Stop Locating

Stops the active locate operation and restores normal output.

Inside the Locate submenu; active only during locate

ArtNet Output Selector

Output selector

A dropdown at the top-left of the grid lets you switch between ArtNet outputs without leaving the DMX Mapping window. Selecting an output here also activates the Outputs panel and selects that output in the Inspector, so both views stay in sync.

When the window first opens, it restores the last ArtNet output you viewed (saved per user across sessions).

Inspector: DMX Mapping Section

Inspector controls for ArtNet outputs

When an ArtNet output is selected, the Inspector shows a DMX Mapping section with universe and pixel mapping controls. These are the same data the grid window visualizes.

File operations

Setting

Description

Values / Range

Import CSV

Import a pixel mapping from a CSV file.

Button

Export CSV

Export the current pixel mapping to a CSV file.

Button

Save Pixelmask

Save a pixel mask image based on the current mapping.

Button

Universe management

Setting

Description

Values / Range

Add Universe

Add a new Art-Net universe. The IP address is copied from the previous highest universe. The new universe is auto-selected.

Button. Universe range: 1–32768.

Selected Universe

Choose which universe to view and edit. Keyboard Up/Down arrows cycle through universes when focused.

Dropdown

Edit Universe

Change the universe number. If the target number is already taken, it skips to the next available number in the same direction.

Integer input, 1–32768

IP

Set the destination IP address for this universe's Art-Net packets.

IPv4 address (default: 127.0.0.1)

Remove Selected Universe

Delete the currently selected universe and all its pixel mappings.

Button

Pixel Mappings

The Pixel Mappings collapsible section lists all mapping entries for the selected universe. Each entry maps a line of output pixels to consecutive DMX channels.

Setting

Description

Values / Range

X

Start position X coordinate in the output grid.

1 to output width

Y

Start position Y coordinate in the output grid.

1 to output height

Pixel

Number of pixels mapped from the start position in the selected direction.

0+

Direction

Direction the pixel run extends from the start position.

Up / Down / Left / Right

DMX address

DMX start channel for the first pixel of this mapping entry. Each pixel consumes 3 channels (RGB).

1–512

Skip addresses

Comma-separated list of DMX start channels to skip within this entry. Skipped channels are omitted from the output.

Comma-separated integers (1–512)

Add pixel to DMX mapping

Add a new mapping entry. Position and direction are based on the previous entry. DMX address auto-increments.

Button

Remove

Remove this mapping entry.

Button (per entry)

Undo Support

All universe and pixel mapping edits are fully undoable. Adding, editing, renumbering, or removing universes and mapping entries can each be undone and redone as a single step. Changes made in both the grid window (via context menu) and the Inspector fields are tracked by the same undo history.

Tips

  • Use the grid window's drag-to-select to create new mappings visually. Drag a horizontal or vertical line, then right-click and choose Add pixel mapping. The direction and pixel count are set from your selection automatically.

  • Import a CSV file for large or complex installations rather than building mappings pixel by pixel. Export to CSV to share or back up mappings.

  • Enable Live data to verify that the right content reaches the right fixture. Each pixel shows its actual RGB colour as sent over Art-Net.

  • The Locate feature is invaluable for commissioning. Right-click a pixel, row, or column and choose Locate to light it up on the physical fixture. Enable Dim other pixels during locate for maximum contrast.

  • Left-clicking a mapped pixel auto-selects its universe in both the grid window and the Inspector. This is the fastest way to identify which universe a specific pixel belongs to.

How to Set Up ArtNet and sACN Pixel Output — step-by-step guide to creating ArtNet and sACN pixel outputs.

Play a Video on a Segmented LED Screen — how to play content on a segmented LED screen.

How to Preview LED Content in the Scene View (LED Simulation) — LED simulation preview in the Scene View.

Outputs — Outputs reference page.