Skip to content

Repository files navigation

TrueRes

Switch your Windows display resolution fast, from a small tray app.

Made for stretched-res gaming: set a custom resolution in your GPU driver once, then apply it here in one click instead of digging through the control panel every match.

Download

Grab the latest release from the Releases page:

https://github.com/logm1lo/TrueRes/releases

Run TrueRes.exe. No install, no admin rights needed.

Quick start

  1. Add your stretched resolution in your GPU control panel first. TrueRes can only switch to modes your driver already knows about.
  2. Open TrueRes. Your current resolution is shown at the top.
  3. Click a resolution to apply it. Done.

Using TrueRes

  • The list shows common stretched presets plus every mode your display supports. The active mode is highlighted.
  • Custom resolution: type one in the box, for example 1440x1080 or 1440x1080@144, then press Apply.
  • Restore native: switch straight back to your monitor's native mode.
  • Refresh: re-read available modes after you change GPU settings.
  • Display: if you have more than one monitor, pick which one to switch.
  • Tray icon: closing the window keeps TrueRes in the system tray. Right click the tray icon to switch resolution or quit without tabbing out.
  • Restore on exit: TrueRes switches back to your native resolution when you quit. This can be turned off in the settings file (below).

Settings

Settings are stored in a plain text file:

%LOCALAPPDATA%\TrueRes\config.json

It remembers your last resolution, window position, chosen display, and the two options below. Edit it while TrueRes is closed.

  • close_to_tray: true keeps the app in the tray when you close it.
  • restore_on_exit: true switches back to native resolution on quit.

FAQ

Why does TrueRes say a resolution is not registered?

That mode is not known to your GPU driver yet. Add it in the GPU control panel first:

NVIDIA: NVIDIA Control Panel, Display, Change Resolution, Customize, Create Custom Resolution. AMD: AMD Software, Display, Custom Resolutions, Create New. Intel: Intel Graphics Software, Display, Custom Resolutions.

The screen looks wrong after I switch.

Switch when the game is on the fill or agent select screen. Loading into a new match resets the resolution, and switching too early gives you black bars.

Building from source

Requires Python 3.10 or newer on Windows.

From the project folder:

pip install -e ".[dev]" pyinstaller python -m PyInstaller --clean --noconfirm trueres.spec

The exe is written to dist\TrueRes.exe. build.bat does the same in one step.

To run from source without building:

python trueres.py

License

Released under the MIT License. See the LICENSE file for details.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages