Home

NVidia Surround Assistant (NVSA) Wiki

How it works

1. Add application into the detection list by clicking on the add button (main screen 1.)
2. When any application in the detection list is launched, the configured application specific surround profile is loaded. If "Save window positions" is enabled the window positions are saved and minimized before the switch.
3. NVSA will continue to monitor for the exit of the application.
4. Once the exit/close of the application is detected the default profile is loaded. If "Save window positions" is enabled the window positions that were saved before the switch are applied and maximized.

Notes

• The user is also able to launch an application directly from NVSA. Some applications will work this way and others need to be launched via their respective launchers.
• The "Save window positions" feature is a best effort feature and no guarantee is given that this will work every time with every application.
• The toggle between Surround and default profile will only switch between the Surround profile and the default profile but if a custom profile is active it will switch back to the default profile.
• There is also a system tray icon that can be used via a right-click that has a menu with functions available.

Main Screen

1. Add application to detection list. Opens "Add/Edit Application" window
2. Toggle between default and surround profile. If the surround/custom profile is active it will switch to the default profile. If the default profile is active it will switch to the surround profile.
3. Open settings.
4. Toggle enable/disable the detection of said application. A green tick is enabled and a red cross is disabled.
5. Exit application. This will also exit NVSA if the close to tray is enabled.
6. Launch application
7. Edit application
8. Remove application form database/detection list

Add/Edit Application

1. Enable/disable the detection of said application. A green tick is enabled and a red cross is disabled.
2. At launch of application pause it until the profile switch has finished and then un-pause 3 Text that will be displayed on the main screen thumb
3. Fullpath to the exe that is used for detection
4. Display profile that will be switched to when the application is detected. This will default to the default surround profile
5. How long to wait after application was detected to start checking for exit. Some applications start and exit multiple instances before actually launching the application. (Max 600 sec = 10 min)
6. How long to wait before switch back after the application exit's. (Max 120 sec = 2 min)
7. List of found applications that match the search string.
8. The name to search on IGDB for. Matches will be populated in 8.
9. Start the search
10. Allows the user to select a new cover image from the file system.
11. Delete the current cover image
12. Cover image to be displayed with the thumb on the main screen
13. Open a file dialog to change the exe to be detected.
14. Apply changes
15. Cancel changes

Settings

1. Enable to have NVSA start with windows. Disable to remove application form start
2. Enable to have NVSA start minimized to the system tray. Disable to start NVSA maximized
3. When the close button is clicked will minimize to tray and not exit application
4. Click to open a context menu to select how to save the current display configuration. Can be saved as default, surround or custom profile
5. Click to open a context menu with all available profiles. The profile can then be clicked and will then be applied.
6. Launch the setup wizard.
7. Default wait for start time used for newly added applications.
8. Default switchback time used for newly added applications.
9. Select what should happen when NVSA is closed and surround profile is active.
   • Ask -> ask the user to select what to do
   • Always -> always switch back to default profile
   • Never -> leave the current profile active and exit
10. Select what should happen when an application in the detection list is closed and surround profile is active.
    • Ask -> ask the user to select what to do.
    • Always -> always switch back to default profile
    • Never -> leave the current profile active
11. Save the current window positions of open application, used to try and restore the desktop, to the same state as before the switch to surround, once the detected application exits.
12. Show the log window at the bottom of the main window.
13. Choose the log level. Each level disables the previous level. So if debug is selected all levels besides for trace are enabled.
    • Trace -> all info of what is happening is saved
    • Debug -> info required to debug the application
    • Info -> main events
    • Warning -> waring and error
    • Error -> only errors
14. Apply settings
15. Open about window
16. Cancel settings