Windows display profiles in one click. Save which monitors are on, which one is primary, HDR and brightness for each, then switch from a desktop shortcut when the task changes: work, gaming, sim racing. The built-in guide explains every setting, including the ones outside the app (OSD, NVIDIA Control Panel, Windows) that decide whether a high refresh 4K signal arrives clean.
The interface and the in-app guide are currently in Italian.
- Profiles: monitors on/off, primary, position, and per monitor HDR and brightness (DDC/CI), each one optional ("leave as is").
- Desktop shortcuts: each profile gets a
.lnkthat applies it without opening the window. Errors and warnings show up in a message box; on success nothing is shown. - Signal health: color format, bits per channel, HDR and G-SYNC per monitor, with a warning when a monitor falls back to YCbCr 4:2:2/4:2:0 or fewer than 8 bits (typically DSC off at 4K high refresh).
- Joined mode (NVIDIA Surround): the monitors become a single surface (e.g. 11520×2160) for games that do not handle multiple screens. Experimental, see below.
- Command line: the same executable is a CLI, used by the shortcuts.
- Guide: setup checklist with the reason behind each setting (DSC, color settings, G-SYNC, hardware GPU scheduling, X3D power plan, HDR, cables), when to regenerate profiles, FOV and side monitor angle for sims.
- Windows 10 2004 or later, x64; tested on Windows 11. HDR control prefers the Windows 11 24H2 API and falls back to the older one.
- .NET 10 Desktop Runtime. The Windows App SDK is bundled.
- DDC/CI enabled in the monitor OSD for brightness.
- NVIDIA GPU and driver for joined mode and G-SYNC readout; everything else works with any GPU.
dotnet build MonitorRig.csproj -c Release
dotnet test tests/MonitorRig.Tests
dotnet publish MonitorRig.csproj -c Release -o dist
Run dist\MonitorRig.exe. Desktop shortcuts point to the executable that
created them, so publish to a stable folder first.
| Command | |
|---|---|
monitorrig |
opens the window |
monitorrig applica <profile> |
applies a profile (exit code 3 = applied with warnings) |
monitorrig salva <name> [n..] [--hdr n=si|no] [--lum n=0-100] |
saves the current layout, optionally only monitors n |
monitorrig salva-unito <name> [bezel px] |
saves a joined (Surround) profile |
monitorrig profili |
lists profiles |
monitorrig list |
lists monitors |
monitorrig stato |
signal, HDR, brightness, Surround and G-SYNC status |
monitorrig hdr <n> si|no |
turns HDR on/off on monitor n |
monitorrig luminosita <n> [0-100] |
reads or sets brightness of monitor n |
Monitor numbers go left to right, as shown by list. Profiles are JSON files
in %LOCALAPPDATA%\MonitorRig\profili.
- Layout: Windows CCD API (
QueryDisplayConfig/SetDisplayConfig). A profile is a snapshot of paths and modes; adapter LUIDs change at every boot, so profiles store the adapter device path and remap on apply. - Monitors are identified by adapter + target id (stable per port), so identical monitors with identical EDIDs are told apart.
- A profile is applied in phases: layout, wait for the monitors, HDR, brightness. A failure after the layout is reported as a warning and does not undo the layout.
- HDR:
DisplayConfigSetDeviceInfowithSET_HDR_STATE(24H2+), falling back toSET_ADVANCED_COLOR_STATE, verified by reading the state back. - Brightness: only the standard MCCS VCP code
0x10. Manufacturer-specific VCP codes are never written. - Surround: NVAPI Mosaic grid functions through direct P/Invoke on
nvapi64.dll(on GeForce the grid needs theimmersiveGamingflag).
- Tested on one setup: three identical 4K 160 Hz DisplayPort monitors on an RTX 5090. Mixed monitors, other GPUs and laptops are untested.
- Joined mode has only been validated, never applied: the driver accepts the 3×1 grid at native resolution and refresh, but switching into Surround and back has not been tried on real hardware yet.
- With HDR on, many monitors lock brightness and ignore DDC/CI: MonitorRig does not write brightness to a monitor in HDR and reports it.
- Re-create profiles after changing cables, ports, DSC or color format: a profile re-imposes the timing it was saved with.
MIT. NVAPI-derived definitions are covered by NVIDIA's MIT license, see THIRD-PARTY-NOTICES.md.

