OpenNOW README

The project's README from github.com/OpenCloudGaming/OpenNOW. As one markdown file: README.md.

OpenNOW cloud logo

OpenNOW

An open-source desktop client for GeForce NOW.

Download desktop builds Download Android Build Read the documentation Join Discord

Total GitHub release downloads GitHub stars

Downloads · Features · Architecture · Build from source · Contribute

Paper design preview of current OpenNOW Home, with a compact sidebar, full-width continue-playing card, and favourites.

Desktop Home, from the OpenNOW Paper design.

OpenNOW is a community-built GeForce NOW client. The desktop app uses Qt Quick for the interface and Rust for account services and streaming. Use a keyboard and mouse, or switch to the console layout for a controller. Both layouts run in the same app.

[!NOTE] OpenNOW 1.0.0 rebuilds the desktop client with Qt Quick and a native Rust streaming engine. It replaces the retired Electron app. See the announcement post for a first look at the new UI.

[!IMPORTANT] You need your own GeForce NOW account. Your subscription, region, and hardware determine which games and stream settings you can use. OpenNOW is not affiliated with, endorsed by, or sponsored by NVIDIA. NVIDIA and GeForce NOW are trademarks of NVIDIA Corporation.

[!WARNING] The Qt app is still under development. Expect bugs, including platform-specific streaming and GPU issues. It has no Chromium/WebRTC fallback. Publishing a build does not mean it has passed every check in the acceptance checklist.

Get OpenNOW

Look for packages starting with OpenNOW-Qt- in GitHub Releases. Older releases may contain the retired Electron app, so check the release notes before downloading. If there's no published Qt nightly, sign in to GitHub and download the artifacts from a successful qt-ci run on dev.

Platform Qt package How to run it
Windows x64 / ARM64 .msi, portable .zip Install the MSI, or extract the entire ZIP and run bin/OpenNOW.exe.
Linux x64 / ARM64 .AppImage, recommended Make the file executable, then launch it.
Linux x64 / ARM64 .deb Your distribution must provide Qt 6.8+ and SDL3. Use the AppImage on stock Ubuntu 24.04.
macOS Apple Silicon, macOS 13+ .dmg, nightlies Open the DMG and drag OpenNOW into Applications. Intel Macs are not included.

Nightly platform packages are unsigned. Windows may show an unknown-publisher warning. The macOS app is not notarized; if Gatekeeper blocks it, use System Settings → Privacy & Security → Open Anyway when offered. Do not disable Gatekeeper globally. Published update-enabled nightlies use signed update manifests. Older builds without a pinned signing key need one manual upgrade. Checksums alone detect corrupted downloads; they do not verify who published a package.

The nightly guide covers these packages. The signed 1.0.0 candidate workflow currently builds Windows and Linux only; see the release-candidate guide. The separate OpenNOW-Mac project is also available.

Other platforms

These projects are separate from the Qt desktop app.

Inside the client

These images come from the OpenNOW Paper design. The boards follow the current Qt layouts, but they aren't app screenshots. The games, account details, and statistics are sample content, not proof of game availability or performance.

Desktop library

Paper design preview of the current desktop Library, showing the compact sidebar, collection controls, store filters, and larger game covers.

Controller-first console layout

Paper design preview of console Home, showing a controller-focused game grid, navigation dock, and button prompts.

You can:

The Qt app guide lists hardware requirements, experimental features, and platform limitations.

How it works

Qt draws the interface and handles windows, navigation, focus, and overlays. The Rust core runs in a separate process. It manages accounts, settings, and catalog requests, then prepares the session. Qt talks to it over a versioned JSON protocol.

The native Rust streamer handles NVST transport, decoding, audio, gameplay input, and recording. Qt loads it in the desktop process through a versioned C ABI. Video stays on the GPU, and Qt draws menus over it in the same window. The app doesn't embed a browser or open a separate video window. The streamer guide explains the graphics backends and how Qt uses them.

Build from source

Use main for the release source or dev for ongoing development. Before building, install:

Linux also needs pkg-config, libwayland-dev, and wayland-protocols, even for X11 builds. Check the build guide for platform-specific details.

git clone --branch main https://github.com/OpenCloudGaming/OpenNOW.git
cd OpenNOW
cmake -S opennow-qt -B build/opennow-qt -DCMAKE_BUILD_TYPE=Debug
cmake --build build/opennow-qt
ctest --test-dir build/opennow-qt --output-on-failure

You don't need Node.js or npm to build or run the desktop app. The repository uses JavaScript for tools such as the localization checker.

Testing login and gameplay requires a GeForce NOW account. Without one, you can run the smoke tests, screenshot fixtures, and performance checks in the Qt app guide and acceptance runbook.

Documentation

Start at opennow.zortos.me for setup and configuration help.

For players For contributors
Getting started Development guide
Configuration Qt application
Native streamer Protocol, release, and acceptance docs

Repository map

opennow-qt/               Qt Quick desktop app, C++ integration, and Qt tests
native/opennow-core/      Rust accounts, settings, catalog, and session services
native/opennow-streamer/  Native NVST transport, media, input, and Qt FFI
locales/                 English source and Crowdin-managed translations
docs/                    Architecture, protocols, acceptance, and release guides
scripts/                 Repository-only localization tooling
.github/                 CI workflows and contributor guidance

Contributing

For code changes, read the contributing guide and repository guidance. Keep pull requests focused on one change. For translations, edit only locales/en.json. Crowdin manages the other locale files.

Found a bug? Open a GitHub issue with your build, OS, GPU, and steps to reproduce it. For streaming bugs, include a diagnostic export. Check attachments for personal information before posting them. You can also ask for help on Discord.

Sponsors

Blacksmith sponsors OpenNOW's CI.

Star history

Star History Chart

License

OpenNOW uses the MIT License.

OpenNOW (OpenCloudGaming/OpenNOW)

Searching Database…

3.4K ·GitHub
这是什么?OpenNOW 是社区打造的开源 GeForce NOW 云游戏桌面客户端。它用 Qt Quick 做界面,用原生 Rust 引擎处理账号服务和串流。
这是原生应用,还是只是内嵌浏览器来串流游戏?它是完全原生的桌面应用:Qt 负责绘制界面,由一个独立的 Rust 进程处理 NVST 串流传输、解码和输入。没有内嵌浏览器,也没有 Chromium/WebRTC 回退方案。
OpenNOW 怎么安装?从 GitHub Releases 获取适合你系统的 OpenNOW-Qt 构建:Windows 上安装 .msi 或运行便携版 .zip,Linux 上使用 AppImage(推荐)或 .deb,macOS 上把 .dmg 里的应用拖进应用程序文件夹。
使用它需要 GeForce NOW 订阅吗?需要——你要有自己的 GeForce NOW 账号,而订阅、所在地区和硬件决定了你能访问哪些游戏和串流设置。
这个 Qt 应用稳定到能日常使用了吗?还没有——它仍在积极开发中,难免有 bug,包括特定平台的串流和 GPU 问题;nightly 构建未签名(Windows 会显示未知发布者警告,macOS 构建也未经公证)。
桌面客户端支持哪些操作系统?Windows x64/ARM64、Linux x64/ARM64(AppImage 或 .deb,需要 Qt 6.8+ 和 SDL3),以及运行 macOS 13+ 的 Apple Silicon Mac。此构建不支持 Intel Mac。
我的电脑需要很强的 GPU 才能运行 OpenNOW 吗?基本不需要——游戏实际运行在 NVIDIA 的云端服务器上,你的机器主要任务是解码传来的视频流;渲染好的视频留在你的 GPU 上,Qt 再在上面绘制菜单。
OpenNOW 在手机或游戏主机上也能用吗?可以,但属于独立项目:有通过 TestFlight 提供的 iOS 测试版(另有 SwiftUI 原型分支)、Google Play 上的安卓应用,以及面向改装版任天堂 Switch 自制系统的 OpenNOW-Switch。
项目为什么从 Electron 迁移到 Qt 和 Rust?1.0.0 版用 Qt Quick 和原生 Rust 串流引擎重写了客户端,取代已停用的 Electron 应用,目标是更原生、更高性能的串流管线。
除了串流游戏,我在应用里还能做什么?你可以浏览游戏目录、把收藏保存到合集、调整分辨率/帧率/码率/编码器,不离开画面就能打开串流统计;可以截图、把串流录制为 Matroska 文件,还能导出诊断报告用于提交 bug。
Size
241.1 MB
Stars
3.4K
Age
2y
Commits · 90 Days