ProtonUp Qt

ProtonUp-Qt

ProtonUp-Qt, created by DavidoTek, is a graphical tool for managing Steam compatibility tools including TinkerGame. It allows you to easily install, update and uninstall TinkerGame on the Linux desktop and on Steam Deck. It does not install TinkerGame system-wide, so there is no need for any root access.

Please report any issues you experience with TinkerGame installed via ProtonUp-Qt to either the TinkerGame issue or the ProtonUp-Qt issue, whichever you feel is the most relevant place to post your issue.

Features

ProtonUp-Qt does a lot of the heavy-lifting for you when installing TinkerGame, giving you almost all of the features you would get by installing TinkerGame from a package manager. Below is an overview of the key installation points.

• Install TinkerGame from stable or from Git.
• Easy updating on desktop by simply downloading the new release - no need to uninstall the old version, it is replaced automatically.
• Automatically adds TinkerGame to your shell path so you can run TinkerGame commands right away.
  • Currently supported shells are Bash, Zsh (including OhMyZsh), Ksh and Fish.
• Automatically sets TinkerGame as a compatibility tool in Steam, just remember to restart Steam for this change to take effect!
• The appropriate translation will be selected based on your system locale if a translation in your language is available for TinkerGame, if not it will fall back to English.
• Clean uninstall of TinkerGame, removing it from your system entirely including from shell path, with an option to keep your TinkerGame configuration folder.
  • You might want to keep your config folder if you have mods installed!

There shouldn't be any real limitations of installing via ProtonUp-Qt.

Installation

On SteamOS, ProtonUp-Qt will not check for missing dependencies as these are managed for you, so the check is not applicable.

Outside of SteamOS, ProtonUp-Qt should tell you if you are missing any of TinkerGame's hard dependencies.

See the ProtonUp-Qt section of the Installation wiki for further installation details, but once you have the relevant hard dependencies it is as straightforward as installing TinkerGame like any other compatibility tool. To install a Git release of TinkerGame, make sure "Advanced Mode" is enabled in the About menu of ProtonUp-Qt.

Version Management

You can only install one version of TinkerGame at any given time. This is true with and without ProtonUp-Qt (unless you set up a more complex manual installation yourself!), so to switch versions, simply press the "Add version" button in ProtonUp-Qt and install a new version of TinkerGame. The old version will be automatically overwritten without compromising your configuration folder.

You are still free to uninstall TinkerGame, and you will be asked when you uninstall whether or not you wish to remove your configuration folder as well, as there are cases when you may wish to keep it (for example, migrating configuration files to another device or preserving mods).

Launch Option (Native Games)

It is possible, and in fact very easy, to use TinkerGame as a launch option when installed via ProtonUp-Qt. As TinkerGame is always installed to the same path on Linux desktop and Steam Deck, regardless of platform, you only have to add $HOME/tg/prefix/tinkergame %command% to your launch option, and you can use TinkerGame with your native Linux games.

Due to a limitation in Steam, it is not possible to simply pass tinkergame %command% to native games when installed via ProtonUp-Qt. This is because Steam does not see user-added variables in the path. This can be worked around by launching Steam from the command line, but this is not ideal and it is probably easier to just add the line above.