Go, Go, Godot!
  • 0

Launching Godot Games on Steam Deck from the command line via Remote Shell

August 2, 2022

For some reason, my Godot game would no longer launch on the Steam Deck. I could hear it running as if it were running in the background, but the screen kept showing the Steam Deck’s UI.

Since it’s all Linux I figured it should be possible to just drop to the command line and launch a game from there. Linux typically uses the DISPLAY environment variable to tell the application where its output should be shown. And it turns out, it worked exactly as expected.

In the Steam Devkit Management Tool, there’s a Remote Shell button.

Once the shell is launched, I was curious about the OS:

Last login: Sun Jul 31 13:40:30 2022 from 10.10.1.10
(deck@steamdeck ~)$ uname -a
Linux steamdeck 5.13.0-valve15-1-neptune-02197-gf6ec7ad3762a #1 SMP PREEMPT Thu, 26 May 2022 19:57:25 +0000 x86_64 GNU/Linux

The location where Steam keeps its games is somewhat hidden:

(deck@steamdeck ~)$ ls /home/deck/.local/share/Steam/steamapps/common/
 Age2HD                   RiME
'BattleBlock Theater'     RimWorld
 Carrion                  rocketleague
 Control                 'Sea of Thieves'
'Deep Rock Galactic'     "Sid Meier's Civilization V"
'Disco Elysium'          'Skyrim Special Edition'
"Don't Starve Together"  'Stardew Valley'
'Elite Dangerous'        'Steam Controller Configs'
'Fable Anniversary'       Steam.dll
 Factorio                 SteamLinuxRuntime
'Fury Unleashed'          SteamLinuxRuntime_soldier
'Neon Abyss'             'Steamworks Shared'
 Outward                  StickFightTheGame
'Proton 7.0'             'Super Meat Boy'
'Proton - Experimental'   Terraria
 RBS                      Valheim
'Red Dead Redemption 2'

But a devkit game won’t be found there. It’s in the “devkit-game” directory instead:

(deck@steamdeck ~)$ ls ./devkit-game/
arpg            arpg_game            arpg_game-settings.json  devkit-steam
arpg-argv.json  arpg_game-argv.json  arpg-settings.json

To run a game, go to the devkit directory where your game is and run it from the command line:

(deck@steamdeck ~)$ ./devkit-game/arpg/arpg.x86_64
Godot Engine v4.0.alpha12.official.2c11e6d9e - https://godotengine.org
ERROR: X11 Display is not available
   at: DisplayServerX11 (platform/linuxbsd/display_server_x11.cpp:4612)

(zenity:29986): Gtk-WARNING **: 10:56:25.372: cannot open display:
ERROR: Unable to create DisplayServer, all display drivers failed.
   at: setup2 (main/main.cpp:1715)
ERROR: BUG: Unreferenced static string to 0: interface_added
   at: unref (core/string/string_name.cpp:131)

In Linux, output goes to the device specified via the DISPLAY env var. When connecting to the Steam Deck via shell, that is missing, hence the error.

Let’s run it again, with the DISPLAY environment variable set to the first device:

(deck@steamdeck arpg)$ DISPLAY=:0.0 ./arpg.x86_64
Godot Engine v4.0.alpha12.official.2c11e6d9e - https://godotengine.org
Vulkan API 1.2.203 - Using Vulkan Device #0: AMD - AMD RADV VANGOGH

And it’s running. Launching games via the command line works well, and this may be great for debugging slightly more complex issues during launch, especially when attaching a debugger, or even when passing arguments to trigger specific scenarios on an actual device.

We can take this up to another level. How about sharing your PC’s mouse and keyboard with the Steam Deck? Let’s go.

developer experiencegodotSteam Deck
Posted in Godot, Steam.
Share
PreviousShare your Computer’s Mouse and Keyboard with your Steam Deck
NextGodot Engine on the Steam Deck – Developing games on the go?

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

Related Posts

  • February 5, 2024

    Inventory System v1.4 available

    A smaller update. The inventory components now have custom icons to make it easier to tell them apart. This release also includes additional bug fixes:

  • December 22, 2022

    A GDScript refactoring exercise

    Arguably, more fun than writing code is removing code. I was assembling a split-screen multiplayer UI. The goal behavior is to show/hide the appropriate displays for the players, depending on how many players there are. Initially, the code to update the UI was very simple, because I started with two players. In that case, you …

  • September 25, 2023

    Generating documentation for GDScript

    Any sufficiently large code base needs documentation. Documentation tends to come in all sorts of shapes and sizes. Among them are high-level architecture and design docs, class and method interface documentation, and inline comments to explain optimized or complex algorithms so the reader doesn’t have to parse the logic in their head (often, this is …

  • February 16, 2024

    Inventory System v1.8.1 available

    A quick update to yesterday’s release with a few fixes:

    © 2026 GoGoGodot.io. All rights reserved.