git404hub

what is gfnow-sync fr?

supernebuleux/gfnow-sync — explained in plain English

Analysis updated 2026-05-18

4PythonAudience · generalComplexity · 2/5Setup · easy

tl;dr

Adds your GeForce NOW cloud games into Steam on Steam Deck by reading local GFN cache files and writing Steam shortcuts with cover art. No API keys needed.

vibe map

mindmap
  root((repo))
    What it does
      Syncs GFN games to Steam
      Downloads cover art
      Cleanup tool
    How it works
      Reads GFN cache files
      Writes Steam shortcuts
      Reverse-engineered launch URLs
    Use cases
      Steam Deck cloud gaming
      Controller passthrough fix
      Filter games by store
    Setup
      Download and extract
      Run install script
      Close Steam and GFN
    Tech stack
      Pure Python 3
      No external dependencies
      KDE dialogs and terminal
    Audience
      Steam Deck owners
      GeForce NOW users
      Couch gamers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Show your GeForce NOW cloud games as normal Steam shortcuts on your Steam Deck.

VIBE 2

Pick and sync only games from specific stores like Epic, Ubisoft, or Xbox.

VIBE 3

Remove GeForce NOW shortcuts from Steam that you no longer want using the cleanup tool.

VIBE 4

Fix controller passthrough for specialized peripherals like flight sticks and yokes.

what's the stack?

Python 3KDE DialogsFlatpak

how it stacks up fr

supernebuleux/gfnow-sync1038lab/agnes-ai3eyedtiger/video2vrcemote
Stars444
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencegeneralvibe codervibe coder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

You must fully close both Steam and GeForce NOW before syncing, or Steam overwrites its shortcuts file and erases your changes.

No license information is provided in the explanation, so usage rights are unknown.

in plain english

GFN Sync is a tool that takes your GeForce NOW game library and adds those games directly into Steam on SteamOS, the operating system used on the Steam Deck. When you run it, your cloud games show up as shortcuts in your regular Steam library, grouped under a "GeForce NOW" category. Clicking one launches the game directly through NVIDIA's client without extra steps. The tool works by scanning cache files that the GeForce NOW app stores on your device. It reads the game data from those files, then writes shortcuts into Steam's configuration file so the games appear in your library. It also pulls cover art, logos, and hero images automatically from the local cache and from NVIDIA's servers, so no API keys or developer accounts are needed. Launching a game uses a reverse-engineered method that passes a direct URL route to the GeForce NOW Flatpak, skipping the normal browsing interface. A sync wizard guides you through the process. It detects which version of GeForce NOW you have installed, extracts your library, then lets you filter by store (Steam, Epic, Ubisoft, Xbox, and others) and pick individual games. It closes Steam for you, writes the shortcuts, downloads artwork, and restarts Steam. A separate cleanup tool removes shortcuts you no longer want. There is also a Steam Input fix for controller passthrough, which helps with specialized peripherals like flight sticks and yokes. Installation is designed for Steam Deck users. You download an archive, extract it, and run an install script by double-clicking. The app then appears in the KDE desktop menu. It requires Python 3, the GeForce NOW Flatpak, a signed-in GFN account, and a locally cached library. You must close both Steam and GeForce NOW before syncing, because Steam overwrites its shortcuts file when it closes and would erase your changes. The project is written in pure Python 3 with zero external dependencies. It supports both a graphical interface using KDE dialogs and a full terminal fallback. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
Help me install GFN Sync on my Steam Deck. I have GeForce NOW installed as a Flatpak and I want my cloud games to show up in Steam. Walk me through extracting the archive and running the install script.
prompt 2
I ran GFN Sync but my synced games disappeared from Steam after I restarted. What did I do wrong and how do I make sure Steam and GeForce NOW are closed before syncing?
prompt 3
I only want to sync my Epic and Xbox GeForce NOW games to Steam, not my whole library. How do I use the store filter in the sync wizard?
prompt 4
My flight stick is not working when I launch a GeForce NOW game through Steam. How do I apply the Steam Input controller passthrough fix from GFN Sync?
prompt 5
I want to remove some GeForce NOW shortcuts from Steam without deleting all of them. How do I use the GFN Sync cleanup tool?

Frequently asked questions

what is gfnow-sync fr?

Adds your GeForce NOW cloud games into Steam on Steam Deck by reading local GFN cache files and writing Steam shortcuts with cover art. No API keys needed.

What language is gfnow-sync written in?

Mainly Python. The stack also includes Python 3, KDE Dialogs, Flatpak.

What license does gfnow-sync use?

No license information is provided in the explanation, so usage rights are unknown.

How hard is gfnow-sync to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is gfnow-sync for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.