-
Notifications
You must be signed in to change notification settings - Fork 72
Custom Command
(in Game Menu and Game Config)
Launch custom programs before, after or instead of the game itself. You can run Windows or Linux executables (including AppImages and scripts), even when running as a Compatibility Tool you can still launch native Linux executables which can allow you to use native game launchers for games on Steam that might only have a Windows build.
When enabled you can start custom programs easily with the following per-game config options:
-
USECUSTOMCMD
: set to 1 to start the custom commandCUSTOMCMD
-
CUSTOMCMD
: start this custom command -
CUSTOMCMD_ARGS
: startCUSTOMCMD
command with those args -
ONLY_CUSTOMCMD
: set to 1 to only startCUSTOMCMD
and not the game command itself -
FORK_CUSTOMCMD
: set to 1 to fork the customCUSTOMCMD
into the background and continue with starting%command%
. You can optionally configure how long SteamTinkerLaunch should wait (in seconds) until it starts the main game process, after launching the custom program with theWAITFORCUSTOMCMD
optio (Sequence is Custom Command -> Optional Wait Time -> Game Start). This allows you to start a custom command and then have STL wait a certain length of time before it starts the game, in case there are cases where the custom command needs to be started first.-
NOTE: It has been reported several times that this no longer works on SteamOS. Configuring the
WAITFORCUSTOMCMD
may help in some cases, but this is inconsistent. This feature continues to work fine on the Linux Desktop as of 12/01/2024.
-
NOTE: It has been reported several times that this no longer works on SteamOS. Configuring the
-
EXTPROGS_CUSTOMCMD
: Use tools like GameScope, MangoHud, GameMode, etc with the custom command. This is useful if you are using the custom command option to launch a game combined with "Only custom command", such as using an alternative game launcher, and you want configuration options like MangoHud to apply to that process. -
CUSTOMCMDFORCEWIN
: set to 1 to force the program to run with Wine/Proton and ignore SteamTinkerLaunch's platform detectionINJECT_CUSTOMCMD
overrides bothONLY_CUSTOMCMD
andFORK_CUSTOMCMD
. -
INJECT_CUSTOMCMD
: set to 1 start the customCUSTOMCMD
after the game exe has started (optionally starting anotherINJECTWAIT
seconds)-
NOTE: It has been reported several times that this no longer works on SteamOS. Configuring the
INJECTWAIT
may help in some cases, but this is inconsistent. This feature continues to work fine on the Linux Desktop as of 12/01/2024. - For injecting dlls into a game exe the IGCSInjector function can be used instead of
INJECT_CUSTOMCMD
-
NOTE: It has been reported several times that this no longer works on SteamOS. Configuring the
If only USECUSTOMCMD
is enabled, but CUSTOMCMD
is empty, a requester will open where a executable file can be selected. The selected file will then be automatically written into the Game Config.
If string CUSTOMCMD
can't be found as file in either PATH
, in game dir or as absolute filepath the requester will open as well
Note: See also the One Time Run option for quickly starting a custom executable inside the games Wineprefix once, or Custom User Start/Stop scripts to start custom scripts when game starts/ends.
Although SteamTinkerLaunch lets you execute custom commands it does not guarantee compatibility. It simply launches the selected executable instead of the one Steam would normally use, and does not do any extra configuration to guarantee it will run correctly. If any manual configuration is needed to get a game to work outside of SteamTinkerLaunch, it will also be needed to ensure the program works with SteamTinkerLaunch.
And of course, if your program does not work with Linux normally, it will more than likely not work with SteamTinkerLaunch as well. Please do not open issues asking for support with third-party programs unless they only do not work when launched from SteamTinkerLaunch - That is, they work outside of SteamTinkerLaunch with the same Wine/Proton version, the same tweaks if necessary, and the same Wineprefix.
Quick Links
- Changelog
- Installation
- Usage
- Main Menu
- Global Menu
- Tray Icon
- Modding
- Platform-Specific Documentation
- Tweaks
- Utilities
- Advanced