Steam Deck Web App Generator
ADD NON-STEAM GAME

How to add a non-Steam game on Steam Deck

A non-Steam game is any program you add to your Steam library yourself instead of buying it on Steam. Once added, it sits under the Non-Steam tab in Game Mode and launches like any other game. It can be a game, an app, a browser or a script.

Valve's steps

From Valve's Steam Deck Desktop FAQ:

  1. From the STEAM menu, select Power, then Switch to Desktop.
  2. Install the app you want, for example from the Discover Software Center.
  3. Open the Steam client and click Add a Game in the lower left corner, then Add a Non-Steam Game.
  4. Find the application in the list and add it.
  5. Select Return to Gaming Mode. The app shows up in your library under the Non-Steam tab.

Add a website as a non-Steam game

A website is not an installed app, so it does not appear in that list. The generator gets around this by writing a small launcher script that opens the site in Chrome, then adding the script to Steam with steamos-add-to-steam. You run one file in Desktop Mode and the shortcut is in your library when you go back to Game Mode.

  1. In Game Mode, press the STEAM button, open Power and choose Switch to Desktop.
  2. Install Google Chrome from the Discover Software Center if you don't have it yet. The generated script starts the Chrome flatpak (com.google.Chrome), which is the version Discover installs.
  3. Open the generator in a browser on the Deck. Enter https://example.com as the Site URL and ExampleSite as the App Name. Leave Use ~/Documents as default folder switched on.
  4. Press Generate script, then Download .sh. The file is saved as examplesite.sh.
  5. Open Konsole in the folder you downloaded it to and run:
    chmod +x examplesite.sh
    ./examplesite.sh
    The script writes a small launcher, ~/Documents/ExampleSite.sh, makes it executable and hands it to steamos-add-to-steam, which adds it to your Steam library as a non-Steam game.
  6. Double-click Return to Gaming Mode on the desktop. The shortcut is in your Library under Non-Steam, listed as ExampleSite.sh. You can rename it in the shortcut's Properties.
  7. Launch it. Chrome opens https://example.com full screen in kiosk mode, with no tabs, address bar or scrollbars. To close it, press STEAM and choose Exit Game.

Before you run it

  • The App Name becomes the launcher's file name, so spaces and apostrophes are fine but a slash is not.
  • Leave ~/Documents/ExampleSite.sh where it is. The Steam shortcut points at that file.
  • The launcher uses your normal Chrome profile, so a site you sign in to in Chrome on the desktop is still signed in when you open the shortcut in Game Mode. Inside Game Mode, STEAM + X brings up the on-screen keyboard.
  • The script does not set a controller layout. Pick one in the shortcut's controller settings. Microsoft's and NVIDIA's own Steam Deck guides both use the Gamepad with Mouse Trackpad template for their browser and app shortcuts, which gives you a pointer on the trackpad.

If the shortcut does not appear

You can add the launcher by hand with Valve's steps above. In the Add a Non-Steam Game window, use Browse to pick ~/Documents/ExampleSite.sh (or whatever you called it) and add it.