[Vysp3r]

Category

• Feature
• Documentation

Overview

Offer TinkerGame for new installations while keeping existing SteamTinkerLaunch installations visible, updatable and removable under their original identities. Discover published TinkerGame releases automatically, including alphas, so new upstream releases do not require a ProtonPlus update.

• Stage and validate the runtime and Steam registration together, with ownership checks, process guards and rollback on failed replacement.
• Add explicit configuration copying from SteamTinkerLaunch. Preserve the original settings, refuse an existing destination, and leave game assignments and launch options unchanged.
• Support individual CLI install/update/removal and installed-tool listing, including offline TinkerGame removal.
• Show actionable installation errors, comma-separated missing dependencies and a failure toast.

Support is currently limited to native ProtonPlus with native Steam outside SteamOS. Flatpak, Snap and SteamOS targets are explicitly rejected. Upstream runtime layout changes may require a follow-up compatibility fix.

Issue Number

Closes #1308.

New Variables or Dependencies

No new build dependencies, environment variables or settings. TinkerGame installation checks for bash, git, pgrep, pidof, pkill, tar, unzip, wget, xdotool, xprop, xrandr, xwininfo, xxd, jq, steam, awk and YAD >= 7.2. YAD 15 is supported for TinkerGame; the legacy SteamTinkerLaunch policy is unchanged.

How to Test

Validation completed:

• meson compile -C build
• meson test -C build --print-errorlogs: all 6 groups passed, including 626 unit subtests.
• make translations
• git diff --check

Fixture coverage includes automatic release discovery and updates, lookup failure, installation/removal, legacy coexistence, repair, rollback, cancellation, ownership changes, process guards, migration and preservation of Steam launch options. Tests use temporary directories and injected backends; no real Steam installations were modified.

For manual acceptance, verify installation and failure presentation, discovery of a newer release, explicit settings migration, legacy coexistence and game launching on a supported native setup. Live GUI, packaging, Steam restart and game-launch behavior remain unverified.

Checklist

• My code follows the project's style guide.
• Automated tests pass; manual acceptance limitations are listed above.
• I have updated the documentation.
• I have updated the translations with make translations.
• I have checked for existing pull requests that cover these changes.