Overview
A Mosaic Video Wall allows displays of different sizes and positions to show different portions of a single video source. All displays must be mounted in either landscape or portrait orientation and may be rotated in 90° increments.
Each display acts as a window into a larger virtual image called the Canvas. Every Receiver crops and positions its own view of that Canvas based on physical measurements.
Mosaic Video Walls are supported on all MaxColor, Ultra, and Omega Series Receivers and require no external video wall processor.
Quick Start (Experienced Technicians)
- Mount all displays
- Measure the overall Canvas
- Measure each display’s viewable area and position
- Decide how content should align within the Canvas
- Send one
vw mosaiccommand to each Receiver
If seams do not line up, the issue is almost always display scaling, source format, or measurement accuracy — not the command.
Requirements
- One Receiver per display
- All displays rotated in 0°, 90°, 180°, or 270°
- justOS firmware B1.2.1 or later
- Static IPs and Telnet access (port 23)
Core Concept: Canvas vs Displays
Think of the system as one large image (Canvas) viewed through multiple smaller cutouts (Displays).
- The Canvas defines the total video area
- Each display defines what portion of that Canvas it shows
- Receivers do not scale independently — they crop and position
Download Spreadsheet Assistant
This Excel spreadsheet assists with programming the displays in the Mosaic Video Wall. Make a measurement, enter it in the spreadsheet, and it will provide the command to be sent to each Receiver.
Content Alignment (Critical Decision)
Most video content is produced at a 16:9 aspect ratio. Mosaic Video Walls often are not. Alignment determines how the video is handled when the Canvas does not match the source.
If alignment is not specified, the system defaults to Center.
Alignment Modifier (-a)
Use the -a modifier to control how the video is positioned within the Canvas.
- center (default) — Centers the content within the Canvas
- fit — Scales and distorts the image to fill the Canvas
- tl — Lock to top-left corner
- tc — Lock to top-center side
- tr — Lock to top-right corner
- cl — Lock to center-left side
- cr — Lock to center-right side
- bl — Lock to bottom-left corner
- bc — Lock to bottom-center side
- br — Lock to bottom-right corner
center. Only use fit when
content distortion is acceptable or expected.
Measure the Wall
All measurements may be taken in any unit (inches, millimeters, centimeters), as long as the same unit is used consistently throughout the wall.
Measurements are based on viewable pixels only. Do not include bezels, frames, or mounting hardware.
Step 1: Measure the Canvas
The Canvas represents the total video area across all displays. It defines the coordinate space that every Receiver references.
-
Canvas Width (CW)
Measure from the left-most viewable pixel of the left-most display to the right-most viewable pixel of the right-most display. Display frames and bezels are not included. -
Canvas Height (CH)
Measure from the top-most viewable pixel of the highest display to the bottom-most viewable pixel of the lowest display.
Step 2: Measure Each Display’s Viewable Area
Each display’s viewable area defines how large its window into the Canvas will be. Rotation does not change how these measurements are taken.
-
Viewable Width (VW)
Measure the horizontal distance between the first and last visible pixels on the display, regardless of rotation. -
Viewable Height (VH)
Measure the vertical distance between the first and last visible pixels on the display, regardless of rotation.
Step 3: Measure Display Position (Offsets)
Offsets define where each display is located within the Canvas. These values determine which portion of the source image the Receiver shows.
-
Left Offset (LO)
Measure from the left edge of the Canvas to the left-most viewable pixel of the display. -
Top Offset (TO)
Measure from the top edge of the Canvas to the top-most viewable pixel of the display.
Step 4: Record Display Rotation
Rotation tells the Receiver how the physical display is mounted. Only right-angle rotations are supported for Mosaic Video Walls.
- ROT — 0°, 90°, 180°, or 270°
Important: Rotation does not change how VW, VH, LO, or TO are measured. Always measure in physical screen space, not perceived orientation.
Program the Receivers
Command template:
vw mosaic -c w:CW,h:CH -v w:VW,h:VH -o l:LO,t:TO -r ROT -a ALIGN
Example:
vw mosaic -c w:500,h:300 -v w:160,h:90 -o l:10,t:100 -r 180 -a center
The command syntax is identical across Maxcolor, Ultra, or Omega Series Receivers.
Troubleshooting
- Disable all display scaling, zoom, and overscan
- Use progressive sources only (720p, 1080p, 2160p)
- Re-check offsets and viewable measurements
Further troubleshooting steps are available here.

