Skip to content

[UX] Add back prime check with more information - #5411

Merged
flavioislima merged 5 commits into
mainfrom
add-back-nvidia-primer-option
May 12, 2026
Merged

flavioislima merged 5 commits into
mainfrom
add-back-nvidia-primer-option

Conversation

@arielj

@arielj arielj commented Mar 15, 2026 •

Copy link
Copy Markdown
Collaborator

This PR adds the option to configure Nvidia Optimus and AMD hybrid GPUs directly from the UI instead of the user having to set the PRIME env variables.

This was removed because users would use it incorrectly, now this PR adds a lot more information for the user to understand when they should is it and when not, with a link to this new Wiki page with even more details and the lists of GPUs that might need this, and explaining this should NOT be used for DirectX games.

With the new name of the option and all the extra context, this might fix the issue of users enabling this incorrectly and at the same time be clear enough so users that need it can use it.

I did not ad this in the Legacy tab because it's technically not Legacy, it's not that OpenGL is planned to automatically detect the correct GPU, so I put it back in Other.

image

Use the following Checklist if you have changed something on the Backend or Frontend:

  • Tested the feature and it's working on a current and clean install.
  • Tested the main App features and they are still working on a current and clean install. (Login, Install, Play, Uninstall, Move games, etc.)
  • Created / Updated Tests (If necessary)
  • Created / Updated documentation (If necessary)

@arielj
arielj requested review from a team, BananaWorks07, CommandMC, biliesilva, flavioislima and imLinguin and removed request for a team March 15, 2026 17:03
@arielj arielj added the pr:ready-for-review Feature-complete, ready for the grind! :P label Mar 15, 2026

@CommandMC CommandMC left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

On the Wiki: I don't think having a list of models makes sense. Most of these graphics cards have desktop & laptop variants, so just the model number alone is not enough to verify Optimus being in use

Comment thread src/frontend/screens/Settings/components/NvidiaPrime.tsx Outdated
Comment thread src/frontend/screens/Settings/components/NvidiaPrime.tsx Outdated
@arielj
arielj requested a review from CommandMC March 22, 2026 22:37
Comment thread src/frontend/screens/Settings/components/NvidiaPrime.tsx Outdated
// if not linux, hide this setting
// if only 1 GPU is detected, hide it, but only if this was unset
// we want to still show it if less than 1 GPU and is set so users can disable it
if (!isLinux || (numberOfGPUs < 2 && !nvidiaPrime)) {

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added one more change here, if a user has the setting enabled and for some reason their setup changes and they don't have 2 GPUs, we have to still show the option so users can disable it

I'm not sure exactly how this works but we had a report of a user changing from nvidia to amd with this setup already turned on and maybe this is needed just in case for people to turn off the setting (I think users will still have 2 GPU if replaced, but if the dGPU is removed and we still have the env variables set I think it can create issues)

handleChange={() => setNvidiaPrime(!nvidiaPrime)}
title={t(
'setting.nvidiaprime.description',
'Force use of NVIDIA Optimus or AMD Dynamic Switchable Graphics dGPU. ONLY use this for OpenGL and Vulkan games.'

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OpenGL and Vulkan are the only APIs on Linux. I think its redundant to mention them

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what I meant here is that it's not needed when using DXVK, I can remove that or replace it with something different

what I want to avoid is users enabling it for DXVK, what I meant there is that when the game itself uses opengl or vulkan instead of vulkan through dxvk, does that make more sense? not sure how to explain it better for the user

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

MAybe it could be "Native OpenGL and Vulkan..."

@arielj arielj mentioned this pull request Mar 29, 2026
@arielj arielj added this to the 2.21 milestone Apr 18, 2026

@flavioislima flavioislima left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@flavioislima flavioislima linked an issue Apr 21, 2026 that may be closed by this pull request
@flavioislima flavioislima modified the milestones: 2.21, 2.22 Apr 22, 2026
@arielj
arielj force-pushed the add-back-nvidia-primer-option branch from eb8109a to 2be0757 Compare May 6, 2026 12:36
@flavioislima
flavioislima merged commit 7a7f9a3 into main May 12, 2026
10 checks passed
@flavioislima
flavioislima deleted the add-back-nvidia-primer-option branch May 12, 2026 10:13
@Heroic-Games-Launcher Heroic-Games-Launcher locked and limited conversation to collaborators May 12, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

pr:ready-for-review Feature-complete, ready for the grind! :P

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Re-add "Use Dedicated Graphics Card" option

4 participants