Table of Contents

switcheRoo Display Manager — User Guide

switcheRoo (binary name xRoo.exe) is a small system-tray utility for Windows that switches monitor resolutions, refresh rates, rotation and screen layouts, and stores your favourite setups as presets.

Everything is done from the tray icon; the program has no main window.

Requirements

switcheRoo uses the standard Windows display APIs, so anything Windows can display, switcheRoo can switch to. No driver or service is installed.

Installing

  1. Run xRoo_Installer.exe.
  2. Accept the license agreement, choose a folder (default C:\Program Files\xRoo) and finish the wizard. The Add to PATH component is optional; select it to run xRoo.exe from any command prompt without typing the full path.
  3. The installer creates a desktop shortcut, an xRoo folder in the Start menu, and copies license.txt into the installation folder.

Administrator rights are required because the program is installed for all users of the computer.

Starting switcheRoo

Start switcheRoo from the desktop shortcut, the Start menu, or by enabling Start with Windows (see below). It then lives in the notification area (the “system tray”) near the clock.

  1. Only one copy runs at a time. Starting it again shows “xRoo is already running in the system tray.”
  2. Hover the tray icon to see a summary of every display: number, monitor name,(primary) marker and current resolution with refresh rate.
  3. The icon may be hidden in the overflow area (the ^ arrow next to the clock); drag it onto the taskbar to keep it visible.

Closing the menu does not exit the program — use Exit in the menu.

The tray menu

Left-click or right-click the tray icon to open the menu.

The top section lists the displays that are currently part of the Windows desktop, in physical layout order: left to right within a row, then top to bottom across rows. The tray tooltip uses the same order. Displays are numbered in menu order, and that number is what --list-displays and --set-display use on the command line.

Menu conventions:

Display settings

Open a display's submenu to change it:

 GIGABYTE M32U                       ← monitor name (header)
 ✓ Display on                        ← click to switch this display off
 Rotation                          ▸ ← Landscape / Portrait / flipped
 ──────────────────────────────────
 3840x2160                         ▸ ← multiple refresh rates
 2560x1440                         ▸
 1920x1080 @ 60 Hz                   ← only one refresh rate

Resolutions

Display on / off

Rotation

Rotation offers:

EntryOrientation
Landscapenormal (0°)
Portrait (90 deg)90° clockwise
Landscape (flipped)180°
Portrait (270 deg)270°

The current orientation has a checkmark; the Rotation entry itself is bold when the display is not in normal landscape. Switching to a portrait mode swaps width and height automatically. Rotation is saved by Windows and survives a reboot.

Screen layouts

Screens controls which displays are active at all:

Examples:

Presets

A preset is a named snapshot of the resolution and refresh rate of every display that is switched on at the time it is saved.

Saving a preset

  1. Set up all displays the way you want them.
  2. Presets › Save current setup as preset…
  3. Enter a name in the dialog and confirm with OK.

The dialog proposes New preset; if that name is already used, a number is appended (New preset (2)). Names are limited to 64 characters, leading and trailing spaces are removed, and an empty name is not accepted.

Presets are written to disk immediately, so they survive reboots and updates.

Applying a preset

Click the preset name in the Presets menu. The name is shown in bold while the displays match that preset exactly.

When applying, switcheRoo:

The whole preset is applied immediately; there is no confirmation prompt.

Renaming and deleting

What a preset contains

For each display: the monitor identity, resolution, and refresh rate.

Not included: rotation, display position/arrangement, scaling, colour profile and HDR settings. Rotation is changed with the display's Rotation submenu instead.

Preset order

Presets are listed in the order they were created. That order also decides which preset a hotkey applies (first preset = Ctrl+Alt+1, and so on).

Hotkeys

ShortcutAction
Ctrl+Alt+1 … Ctrl+Alt+9Apply the 1st … 9th preset

Show all modes

Monitors report many legacy modes (640×480, 800×600, …). To keep the menu short, switcheRoo hides small modes by default:

Enable Show all modes to list every mode the monitor reports. The entry carries a checkmark and is bold while the option is on, and the setting is remembered for the next start.

Start with Windows

Start with Windows adds or removes switcheRoo in HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run (value name xRoo). The entry carries a checkmark and is bold while autostart is enabled.

This affects the current Windows user only and needs no administrator rights.

Identify and refresh

About and Exit

Keyboard and mouse

The menu can be used entirely without a mouse:

KeyAction
Up / DownMove the selection
RightOpen the selected submenu
LeftGo back one level
EscGo back one level; at the top level, close the menu
Enter / SpaceActivate the selected entry
Home / EndJump to the first / last entry

With the mouse:

The menu follows the Windows light/dark theme and is scaled for the monitor it appears on.

Command line

When started with an option, switcheRoo performs the requested action and exits. The tray program is not started (and an already running tray program is not affected), so the command line is ideal for scripts and shortcuts.

xRoo.exe -ld
xRoo.exe -s 1 1920x1080@60
xRoo.exe -s 3 off
xRoo.exe --set-display "DELL U2415" 1920x1200
xRoo.exe -s 1 2560x1440 -s 2 1920x1080@60
xRoo.exe -p Work
xRoo.exe --topology extend
xRoo.exe --topology only-2
xRoo.exe --version

Options

OptionDescription
-s, --set-display <display> <mode>Set a display to a resolution and optional refresh rate, or on / off
-p, --load-preset <name>Apply a stored preset
--topology <extend | only-<N>>Extend all displays, or keep only display N
-ld, --list-displaysList the displays with index, name, device and current mode
-lp, --list-presetsList the stored preset names
-v, --versionPrint the version
-h, --helpPrint the built-in help

Options may be written with --, - or / and are case-insensitive (/s, -LD, --Version all work). They are processed from left to right, and several --set-display / --load-preset options may be combined in one call.

`<display>`

One of:

`<mode>`

--topology accepts extend or only-<N> where <N> is a display number (only-1, only-2, …). Additional layouts such as “show only the primary display” can be built from only-<N> plus --list-displays.

Output and exit codes

Exit codeMeaning
0Success
1Invalid command line
2The operation failed (unknown display/preset, unsupported mode, …)

Settings files

switcheRoo stores its data per Windows user:

FileContents
%APPDATA%\db&w\xRoo\presets.jsonAll presets
%APPDATA%\db&w\xRoo\config.jsonMenu options (showAllModes)

The files are UTF-8 JSON. Presets are written after every change; the menu options are written when switcheRoo starts and exits.

presets.json looks like this:

{
  "version": 1,
  "presets": [
    {
      "name": "Work",
      "displays": [
        {
          "device": "\\\\?\\DISPLAY#GSM5B08#5&2b1f3c4&0&UID4353#{e6f07b5f-ee97-4a90-b076-33f57bf4eaa7}",
          "name": "GIGABYTE M32U",
          "width": 3840,
          "height": 2160,
          "frequency": 120
        }
      ]
    }
  ]
}

Deleting a file resets the corresponding settings:

Good to know

Troubleshooting

ProblemSolution
Nothing happens when I click the iconUse a single left or right click; double-click has no special meaning. Check the tray overflow area.
“xRoo is already running in the system tray.”The program is already running. Open its tray icon instead of starting a second copy.
A display is missing from the menuUse Refresh Displays; check the cable; press Win+P and choose Extend. Monitors that Windows does not detect cannot be listed.
Only a few resolutions are offeredEnable Show all modes.
“Failed to change display settings … Error …”The monitor or driver rejected that mode. Try another resolution/rate, or update the graphics driver.
A preset warns “no mode <width>x<height>”That mode is no longer offered (different monitor or driver). Save the preset again with the current setup.
The display does not come back after switching it offUse Screens › Extend all displays, press Win+P and choose Extend, or reboot. The saved Windows layout restores it.
Ctrl+Alt+<n> does nothingThere is no n-th preset, or another program owns that shortcut.
A display stays dark after rotationWait a moment; layout changes are asynchronous. If it persists, press Win+P and choose Extend again.
Settings are not rememberedCheck that %APPDATA% is writable and not on a read-only roaming profile.
The menu looks wrong after a Windows theme changeClose and reopen the menu; it re-reads the theme.

Uninstalling

  1. Open the Start menu, folder xRoo, and run Uninstall (or use Settings › Apps › Installed apps if the entry is listed there).
  2. Confirm the removal.

The uninstaller removes the program, its shortcuts, the uninstall registry key and license.txt. Your presets and settings in %APPDATA%\db&w\xRoo are kept on purpose; delete that folder manually if you also want to remove them.


switcheRoo Display Manager · © 2026 db&w GbR · Version 2.0