Unofficial client for Nvidia's GeForce NOW game streaming service, providing a native Linux desktop experience with Wayland support, Steam Deck integration, and Discord rich presence.

• Disclaimers
  • Legal
  • Expectations
• Installation
  • Manual Installation
• Features
• Usage
  • Keyboard Shortcuts
  • Command-line Arguments & Environment Variables
• Development
  • Requirements
  • Clone
  • Build
• Update
• Contributing
• Links
• License

This project and its contributors are not affiliated with Nvidia, nor its GeForce NOW product. This repository does not contain any Nvidia / GeForce NOW software. It is simply an Electron wrapper that loads the official GFN web application page, just as it would in a regular web browser.

This is a free and open-source project. Everyone who has contributed to it has done so voluntarily, out of their own free time and goodwill. Contributors are under no obligation to keep working on or maintaining the project, and cannot be expected to do so when life does not afford them that luxury.

If things slow down or go quiet for a while, please be understanding. Documentation may occasionally fall behind, and some issues may linger without an immediate fix — we ask for your patience. If you find the project useful and have some time and development experience, please consider contributing yourself.

Note: The main version of this project, which receives the most support, is the flatpak version hosted on FlatHub!

• Go to the latest release.
• Download the specific file that best fits your distro.

Note: Manual installations are possible but not supported. Please use the flatpak version if you have any trouble with the manual installation!

• Native Wayland support — runs as a native Wayland client when a Wayland compositor is detected, avoiding XWayland overhead and enabling proper compositor overlays
• Steam Deck integration — automatically launches in fullscreen and enables the virtual keyboard overlay when running on Steam Deck
• Discord rich presence — shows what you're playing via Discord RPC (disable with --disable-rpc or GFN_DISABLE_RPC=1)
• Hardware-accelerated video — enables VA-API, GPU rasterisation, and zero-copy video decode for smooth streaming
• Stability fallback — automatically recovers from GPU crashes by retrying with a different OpenGL backend, falling back to software rendering if needed
• Keyboard shortcuts — fullscreen toggle (F11 / Super+F), home (Alt+Home), quit (Alt+F4), devtools (Ctrl+Shift+I), create desktop shortcut (Ctrl+Shift+P)
• Direct game launch — supports --direct-start <cmsId> (or GFN_DIRECT_START_ID=<cmsId>) to jump straight into a game
• Stream quality override — intercepts session requests to report your true physical resolution and a configurable refresh rate, overcoming the web client's defaults (GFN_RESOLUTION_WIDTH, GFN_RESOLUTION_HEIGHT, GFN_REFRESH_RATE)

• Basic usage
  • Changing the keyboard layout
  • Directly launching a game from the desktop
• Integrations
  • Discord
    • Using native GFN + flatpak Discord
• Troubleshooting
  • Gamepad controls are not detected
  • Steam Deck controls are not detected

You will need Node.js 20 or later and npm (bundled with Node.js). On most distributions, installing the nodejs and npm packages is sufficient.

Once you have npm, clone the wrapper to a convenient location:

git clone https://github.com/hmlendea/gfn-electron.git

npm install
npm start

On subsequent runs, npm start will be all that's required.

Simply pull the latest version of master and install any changed dependencies:

git checkout master
git pull
npm install

Contributions are welcome.

Please:

• keep the pull requests focused and consistent with the existing style
• update the documentation when the behaviour changes

• GeForce NOW
• FlatHub release
• FlatHub repository
• Basic usage
• Troubleshooting

Licensed under the GNU General Public License v3.0 or later. See LICENSE for details.