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

  • Strings
    December 17, 2022

    When not all strings are Strings. Detect bugs in your GDscript more easily with static typing

    One of the benefits of working with Godot Engine is that GDScript allows one to operate high level. GDScript is dynamically typed, so not even variable types have to be specified, but I would strongly recommend using static typing wherever possible. It can help with performance but primarily adds clarity when trying to follow the …

  • Valve Software
    July 17, 2021

    Valve announces the Steam Deck

    Just recently Valve announced the Steam Deck, a hand-held gaming device with the capability to play your entire Steam game library. This is huge. In the news, I largely see comparisons being drawn with the Nintendo Switch. Nintendo recently announced the Switch OLED, with a somewhat lukewarm reception. If Valve gets this right, this goes …

  • Godot Game Engine Logo
    March 1, 2023

    Godot Engine 4.0 released!

    Godot Engine 4.0 has been released per official announcement. With version 4.0, Godot has gone through “3+ years of breaking and rebuilding from the ground up, a complete core overhaul and a full engine rewrite, through 17 alphas, 17 betas and 6 release candidates“. The announcement post is credited to “2000+ Godot contributors.” It’s a …

  • February 9, 2024

    Inventory System v1.5 available

    The latest version of the inventory system is available and includes refinements for the interaction demo and the main tour. New features: We’ve also got a handful of bug fixes:

    © 2025 GoGoGodot.io. All rights reserved.