Skip to content

About

Windows display profiles in one click: layout, primary, HDR, DDC brightness, NVIDIA Surround, signal health check — every setting explained.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

MonitorRig

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.

Screens page: monitors drawn to scale with the live signal readout

The interface and the in-app guide are currently in Italian.

Features

  • 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 .lnk that 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.

Profiles page with a thumbnail of each layout

Requirements

  • 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.

Build

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 line

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.

How it works

  • 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: DisplayConfigSetDeviceInfo with SET_HDR_STATE (24H2+), falling back to SET_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 the immersiveGaming flag).

Caveats

  • 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.

License

MIT. NVAPI-derived definitions are covered by NVIDIA's MIT license, see THIRD-PARTY-NOTICES.md.

About

Windows display profiles in one click: layout, primary, HDR, DDC brightness, NVIDIA Surround, signal health check — every setting explained.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages