HeliosPlus

An open source tool for automatically changing your display settings from a Windows Shortcut. Allows you to temporarily change your display settings while you play a game.

This program is heavily based on the amazing HeliosDisplayManagement created by Soroush Falahati!

Download

The latest version of this application is available for download via the release page.

Donation

No need to donate! I am doing this work to scratch a programming itch I've had for a while. It's pretty fun to take something carefully crafted by another developer and extend it with a lot of other awesome features. Thanks to Soroush for making HeliosDisplayMangement and licensing it under GPL2 so I could make the improvements I was longing for!

What it does

Provides an overview of saved profiles for easy editing and switching, as well as functions to automatically switch to a selected profile then run a chosen program, including reverting to the previous profile after the executed application has closed. Useful to change resolution, or merge displays into a single desktop for gaming, then return to normal desktop configuration when finished.

Please read through the README for features (current and planned) and issues you may encounter while using the program.

Feel free to report missing features or bugs using the project issue tracker.

Current features

• Supports saving of an unlimited number of display profiles
• Ability to switch to a display profile via the desktop context menu
• Ability to create a shortcut for a profile for fast and easy switch
• Ability to switch before executing a program or game and reverting back after exiting the program
• Support games with a launcher
• Supports Steam games
• Supports NVIDIA Surround and NVIDIA Mosaic settings

Planned features

• Edit saved profile via the application's user interface (20% done)
• Create new profile vis the application's user interface (Stalled by the previous task)
• Notification icon while the program waits for a game to exit
• Automatic update check and notifications
• Possibility to install components separately (especially the Shell Extension)
• Support of AMD Eyefinity (Needs a C# wrapper for AMD ADL)
• Save and restore taskbar location (90% done)

Features to be considered

• Save and restore monitor colour calibration settings (Needs expanding of underlying wrappers)

Known issues

• Cannot restore custom colour profiles (colour tunings)
• In some circumstances the Windows Taskbar may not return to its original location
• Command line cannot parse hyphens in -a or --arguments options

Usage

Initial Setup:

1. Install 'Helios Display Management' and restart your computer
2. Run 'Helios Display Management'
3. Use 'Windows Display Settings' or 'NVIDIA Control Panel' to configure your display(s) as desired
4. Save the current profile in 'Helios Display Management' by selecting the Active Profile and using Clone button
5. Repeat from step 3 and clone each configuration you want to be able to switch to later

Switch via Application Window

• Select a from the left panel to save (Clone), switch to (Apply), Edit (currently unsupported), or Create a Shortcut

• Create Shortcut: Creates a windows shortcut

  • Temporarily switch with process monitoring: Give 'Helios Display Management' a program to execute after switching profile, and monitor to keep the profile active until the program is closed, then revert to the last used display profile.

    • Monitoring an application

      • Executable Address: Path of executable to run, or browse to select the executable.

      • Waiting Process: Keep selected profile active while 'Process' is running. When it is detected that the process has ended 'Helios Display Management' will revert to the previous display profile. This is useful for games that have a separate launcher.

      • Timeout: Maximum time (in seconds) to wait for the main process to start after launcher exits. Will revert the display profile automatically if the process was not detected in this time.

      • Arguments: Arguments to be passed to the executing application

    • --OR--
    • Monitoring a Steam Game

      • Steam Game: - AppID of Steam Game to launch - enter manually, or select from the auto-detected list of installed Steam games (Can take some time to populate with recent installations as it tries to download the game title and icon from SteamDB).

      • Timeout: Maximum time (in seconds) to wait for Steam Game/App to begin. Will revert the display profile automatically if the game fails to start in this time.

      • Arguments: Arguments to be passed to the Steam Game

  • Save shortcut in a chosen folder with a chosen name

Switch via Shell Extension

• Switch to a profile
  • Right click on your desktop
  • Navigate to 'Display Profiles' menu
  • Select a profile and navigate to the sub-menu
  • Apply, Edit or Create Shortcut for the selected profile

• Temporarily switch to a profile with application monitoring
  • Right click on an executable file or shortcut (Game, Application, Steam Shortcut)
  • Navigate to 'Open under Display Profile' menu
  • Select a profile and navigate to the sub-menu
  • Run, Run as Administrator or Create Shortcut for the selected profile

Switch via Command Line

Command:

HeliosPlus.exe {arguments}

Arguments:

• -a [SwitchProfile|CreateShortcut|EditProfile], --action [SwitchProfile|CreateShortcut|EditProfile]
• -p "{ProfileID}", --profile "{ProfileID}"
• Temporary switch
  • Application or Game
    • -e "{ApplicationPath}", --execute "{ApplicationPath}" -- (Default: None) -- The path to program executable to be run after switching display profile
    • --arguments "{ProgramArguments}" -- (Default: None) -- Arguments to send to the program executable
    • -w "{ProcessName}", --waitfor "{ProcessName}" -- (Default: None) -- 'ProcessName' to wait for; will (If different than the executed program, ie if executing a game launcher that would close when the game is run)
    • -t {TimeoutInSeconds}, --timeout {TimeoutInSeconds} -- (Default: 30) -- Maximum time in seconds to wait for the program to start. Will revert to previous display profile if the program fails to start in this time.
  • Steam Game
    • -s {SteamAppID}, --steam {SteamAppID} -- (Default: 0) -- AppID of the Steam game
    • --arguments "{SteamArguments}" -- (Default: None) -- Arguments to send to Steam (launch options)
    • -t {TimeoutInSeconds}, --timeout {TimeoutInSeconds} -- (Default: 30) -- Maximum time in seconds to wait for the game to start. Will revert to previous display profile if the game fails to start in this time.

Example:

"C:\Program Files\Helios Display Management\HeliosDisplayManagement.exe" -a SwitchProfile -p "{00000000-0000-0000-0000-000000000000}" -e "C:\Games\Game Folder\GameExecutable.exe" -w "GameProcessName" --arguments "nosplash" -t 30

Related Projects

• WindowsDisplayAPI: WindowsDisplayAPI is a .Net wrapper for Windows Display and Windows CCD APIs

• EDIDParser: EDIDParser is a library allowing all .Net developers to parse and to extract information from raw EDID binary data. (Extended Display Identification Data)

• NvAPIWrapper: NvAPIWrapper is a .Net wrapper for NVIDIA public API, capable of managing all aspects of a display setup using NVIDIA GPUs

License

Copyright © Terry MacDonald 2020-2021 Original HelioDisplayManagement copyright © Soroush Falahati 2017-2020

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Credits

Thanks for the work and the time that all of our contributors put into making this a better project. Following is a short list, containing the name of some of these people:

• Original HelioDisplayManagement project created by the amazing Soroush Falahati
• Readme file created by @timegrinder