switcheroo
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| switcheroo [2026/11/19 13:16] – [The tray menu] lightwolf | switcheroo [2026/11/19 13:29] (current) – lightwolf | ||
|---|---|---|---|
| Line 9: | Line 9: | ||
| ## Requirements | ## Requirements | ||
| - | - Windows 10 or later (64-bit) | + | * Windows 10 or later (64-bit) |
| - | - One or more displays attached to the computer | + | |
| switcheRoo uses the standard Windows display APIs, so anything Windows can | switcheRoo uses the standard Windows display APIs, so anything Windows can | ||
| Line 17: | Line 17: | ||
| ## Installing | ## Installing | ||
| - | 1. Run `xRoo_Installer.exe`. | + | - 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 | Administrator rights are required because the program is installed for all users | ||
| Line 33: | Line 30: | ||
| (the " | (the " | ||
| - | - Only one copy runs at a time. Starting it again shows | + | |
| - | | + | - Hover the tray icon to see a summary of every display: number, monitor name, |
| - | - Hover the tray icon to see a summary of every display: number, monitor name, | + | - The icon may be hidden in the overflow area (the `^` arrow next to the clock); drag it onto the taskbar to keep it visible. |
| - | | + | |
| - | - The icon may be hidden in the overflow area (the `^` arrow next to the clock); | + | |
| - | | + | |
| Closing the menu does not exit the program — use **Exit** in the menu. | Closing the menu does not exit the program — use **Exit** in the menu. | ||
| Line 57: | Line 51: | ||
| * **Bold** = the entry is currently in effect (current resolution, matching preset). | * **Bold** = the entry is currently in effect (current resolution, matching preset). | ||
| - | |||
| * **Checkmark** = the exact item or option is active (current refresh rate, current rotation, a display that is switched on, an enabled option). | * **Checkmark** = the exact item or option is active (current refresh rate, current rotation, a display that is switched on, an enabled option). | ||
| - | |||
| * An arrow `▸` means the entry opens a submenu. | * An arrow `▸` means the entry opens a submenu. | ||
| Line 78: | Line 70: | ||
| ### Resolutions | ### Resolutions | ||
| - | - The list is sorted by size, largest first. | + | * The list is sorted by size, largest first. |
| - | - The current resolution is shown in **bold**. | + | |
| - | - If a resolution supports more than one refresh rate, it opens a submenu; | + | |
| - | the active rate carries a checkmark. | + | |
| - | - If it supports only one rate, the menu shows it directly | + | |
| - | | + | |
| - | - Clicking a resolution or refresh rate applies it immediately. Windows stores | + | |
| - | | + | |
| ### Display on / off | ### Display on / off | ||
| - | - The first entry reads **Display on** with a checkmark while the display is | + | * The first entry reads **Display on** with a checkmark while the display is active, and **Display off** when it is switched off. |
| - | | + | |
| - | - Clicking it toggles the display. switcheRoo waits briefly for the layout change | + | |
| - | | + | |
| - | | + | |
| - | - switcheRoo refuses to switch off the last active display, so you cannot end up | + | |
| - | | + | |
| - | - Turning a display off is a temporary layout change: it is **not** written to | + | |
| - | | + | |
| - | | + | |
| - | | + | |
| - | - Depending on the graphics driver, a display may disappear from the list while | + | |
| - | | + | |
| - | | + | |
| ### Rotation | ### Rotation | ||
| + | |||
| + | {{ :: | ||
| **Rotation** offers: | **Rotation** offers: | ||
| Line 124: | Line 106: | ||
| **Screens** controls which displays are active at all: | **Screens** controls which displays are active at all: | ||
| - | - **Extend all displays** — switch every connected display back on, using the | + | * |
| - | | + | |
| - | | + | |
| - | - **Each display by name** — keep only that display and switch all others off. | + | |
| - | | + | |
| - | checkmark. | + | |
| Examples: | Examples: | ||
| - | - Presenting on a projector: **Screens › Projector**, | + | * Presenting on a projector: **Screens › Projector**, |
| - | | + | |
| - | - Working on a laptop screen only: **Screens › Laptop**. | + | |
| ## Presets | ## Presets | ||
| + | |||
| + | {{ :: | ||
| A preset is a named snapshot of the resolution and refresh rate of every display | A preset is a named snapshot of the resolution and refresh rate of every display | ||
| Line 144: | Line 123: | ||
| ### Saving a preset | ### Saving a preset | ||
| - | 1. Set up all displays the way you want them. | + | - 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 | The dialog proposes `New preset`; if that name is already used, a number is | ||
| Line 161: | Line 140: | ||
| When applying, switcheRoo: | When applying, switcheRoo: | ||
| - | - skips displays that are already in the target mode, | + | * skips displays that are already in the target mode, |
| - | - switches on a display of the preset that is currently off, if Windows still | + | |
| - | | + | |
| - | - uses the closest available refresh rate if the exact rate is no longer offered | + | |
| - | | + | |
| - | - shows a warning box listing any display that could not be set (for example | + | |
| - | | + | |
| The whole preset is applied immediately; | The whole preset is applied immediately; | ||
| Line 173: | Line 149: | ||
| ### Renaming and deleting | ### Renaming and deleting | ||
| - | - **Presets › Rename preset ›** *name* — opens the same naming dialog, prefilled | + | * **Presets › Rename preset ›** *name* — opens the same naming dialog, prefilled with the current name. Renaming to an existing name adds a number instead of creating a duplicate. |
| - | | + | |
| - | | + | |
| - | - **Presets › Delete preset ›** *name* — asks for confirmation (the default | + | |
| - | | + | |
| ### What a preset contains | ### What a preset contains | ||
| Line 198: | Line 171: | ||
| | `Ctrl+Alt+1` … `Ctrl+Alt+9` | Apply the 1st … 9th preset | | | `Ctrl+Alt+1` … `Ctrl+Alt+9` | Apply the 1st … 9th preset | | ||
| - | - Hotkeys work while switcheRoo is running, from any application. | + | * Hotkeys work while switcheRoo is running, from any application. |
| - | - The hint `Hotkeys: Ctrl+Alt+1..9` is shown inside the Presets menu once at | + | |
| - | least one preset exists. | + | |
| - | - If another program already owns one of these combinations, | + | |
| - | does nothing for switcheRoo. Pick another key combination in the other program | + | |
| - | if this happens. | + | |
| - | - Presets beyond the ninth are still available from the menu. | + | |
| ## Show all modes | ## Show all modes | ||
| Line 211: | Line 181: | ||
| switcheRoo hides small modes by default: | switcheRoo hides small modes by default: | ||
| - | - a mode is hidden when it is smaller than 1280×960 (both dimensions below the | + | * a mode is hidden when it is smaller than 1280×960 (both dimensions below the threshold), |
| - | | + | |
| - | - the current mode is always shown, whatever its size. | + | |
| Enable **Show all modes** to list every mode the monitor reports. The entry | Enable **Show all modes** to list every mode the monitor reports. The entry | ||
| Line 230: | Line 199: | ||
| ## Identify and refresh | ## Identify and refresh | ||
| - | - **Identify Displays** overlays a large number on every active monitor for about | + | * **Identify Displays** overlays a large number on every active monitor for about three seconds. Use it to find out which physical screen belongs to which menu entry. |
| - | | + | |
| - | | + | |
| - | - **Refresh Displays** re-reads the display list. The list is also refreshed | + | |
| - | | + | |
| - | | + | |
| ## About and Exit | ## About and Exit | ||
| - | - **About xRoo...** shows the application name, version (for example | + | * **About xRoo...** shows the application name, version (for example `Version 2.0.0.0`), build date, copyright line and a link to the switcheRoo |
| - | | + | |
| - | | + | |
| - | | + | |
| - | - **Exit** closes switcheRoo and removes the tray icon. Display settings and | + | |
| - | | + | |
| - | | + | |
| ## Keyboard and mouse | ## Keyboard and mouse | ||
| Line 262: | Line 222: | ||
| With the mouse: | With the mouse: | ||
| - | - hovering an entry opens its submenu after the usual system menu delay, | + | * hovering an entry opens its submenu after the usual system menu delay, |
| - | - clicking an entry with a submenu opens it, and clicking the same entry again | + | |
| - | | + | |
| - | - clicking a normal entry applies it and closes the menu, | + | |
| - | - clicking outside the menu closes it. | + | |
| The menu follows the Windows light/dark theme and is scaled for the monitor it | The menu follows the Windows light/dark theme and is scaled for the monitor it | ||
| Line 309: | Line 268: | ||
| One of: | One of: | ||
| - | - the 1-based number from the tray menu or `--list-displays` (`1`, `2`, …), | + | * the 1-based number from the tray menu or `--list-displays` (`1`, `2`, …), |
| - | - the monitor name exactly as listed, in quotes if it contains spaces | + | |
| - | | + | |
| - | - the Windows device name (`\\.\DISPLAY1`). | + | |
| ### `< | ### `< | ||
| - | - `< | + | * `< |
| - | | + | |
| - | - Without a refresh rate, the current rate is kept when possible; otherwise the | + | |
| - | | + | |
| - | - `on` or `off` switches the display on or off instead of setting a mode. | + | |
| `--topology` accepts `extend` or `only-< | `--topology` accepts `extend` or `only-< | ||
| Line 328: | Line 284: | ||
| ### Output and exit codes | ### Output and exit codes | ||
| - | - Started from a console, the output appears in that console. | + | * Started from a console, the output appears in that console. |
| - | - When the output is redirected, plain text is written instead, so | + | |
| - | | + | |
| - | - Started without a console (for example from the Run dialog), results are shown | + | |
| - | | + | |
| | Exit code | Meaning | | | Exit code | Meaning | | ||
| Line 376: | Line 330: | ||
| Deleting a file resets the corresponding settings: | Deleting a file resets the corresponding settings: | ||
| - | - delete `presets.json` to start with no presets (back it up first — this cannot | + | * delete `presets.json` to start with no presets (back it up first — this cannot be undone), |
| - | | + | |
| - | - delete `config.json` to return the menu options to their defaults. | + | |
| ## Good to know | ## Good to know | ||
| - | - **Display off is temporary.** Windows' | + | * **Display off is temporary.** Windows' |
| - | | + | |
| - | | + | |
| - | - **No display can switch itself off alone.** switcheRoo blocks switching off the | + | |
| - | | + | |
| - | - **Mode changes are checked.** If Windows or the driver rejects a resolution or | + | |
| - | | + | |
| - | | + | |
| - | be made, the previous layout is left in place. | + | |
| - | - **Presets are matched by monitor, not by display number.** Each entry stores | + | |
| - | | + | |
| - | | + | |
| - | | + | |
| - | - **Displays that are off at save time are skipped**, because Windows reports no | + | |
| - | | + | |
| - | - **HDR / advanced colour is not managed** by switcheRoo. | + | |
| - | - **Single instance.** Only one tray copy runs; command-line calls are separate | + | |
| - | | + | |
| ## Troubleshooting | ## Troubleshooting | ||
| Line 419: | Line 361: | ||
| ## Uninstalling | ## Uninstalling | ||
| - | 1. Open the Start menu, folder **xRoo**, and run **Uninstall** | + | - Open the Start menu, folder **xRoo**, and run **Uninstall** (or use *Settings › Apps › Installed apps* if the entry is listed there). |
| - | (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 | The uninstaller removes the program, its shortcuts, the uninstall registry key and | ||
switcheroo.1795090593.txt.gz · Last modified: by lightwolf
