mirror of
https://github.com/Droid-Deck/DroidDeck.git
synced 2026-11-21 13:55:58 +00:00
* fix: carry the installed Steam build into imported games so Steam stops re-verifying them A second-library game downloaded by WinNative was registered with a bare manifest (no buildid or InstalledDepots), so Steam treated it as build 0 and verified all ~92 GB of Final Fantasy XV through proot. Reuse WinNative's .winnative-steam manifest, or a completed .DepotDownloader/depot.config, so Steam only fetches what changed since the recorded build. * fix: give queued Steam fresh installs of imported games the recorded build Steam rewrites a bare import manifest into a fresh install at build 0 before downloading anything. While nothing is downloaded or staged, the WinNative build is still safe to carry over, so Steam skips the full re-download (FF7 Remake was queued for 98 GB this way). * fix: mount the game storage at /mnt/droiddeck-sd The second library was bound at /mnt/bannerlator-sd, a name left from the Bannerlator port, which is what Steam shows in its paths and errors. Bind it at /mnt/droiddeck-sd, keep the old path as an alias for links and prefixes that still name it, move Steam's library entry in place, re-point import links, read ownership snapshots taken under the old path, and key added-game shortcut ids by the old path so their prefixes stay put. * fix: restart Steam once when owned added games are confirmed On a fresh install the importer runs before any ownership snapshot exists, so every added game became a non-Steam shortcut and stayed one until the client happened to restart. Once the watcher confirms owned titles that are not imported, it asks the session for one restart, while no game runs and no download is in progress, and the importer turns them into Steam entries.
68 lines
4.5 KiB
Markdown
68 lines
4.5 KiB
Markdown
# Steam game imports
|
|
|
|
Second Library still registers the selected Steam library. It now also scans Windows
|
|
executables in its immediate game subfolders and `steamapps/common`, using the same
|
|
importer as Added Games. Existing Steam manifests are preserved.
|
|
|
|
`bannerlator-steam-games watch` runs beside the client. It identifies a game by an
|
|
existing manifest's install directory, a `steam_appid.txt` beside the game or selected
|
|
executable, or a unique normalized title from Steam's store search with an explicit
|
|
country. Matching also accepts the terminal Windows Edition and INTERGRADE suffixes;
|
|
multiple matches still remain unresolved. Artwork's fuzzy matching is deliberately not
|
|
used for identity. Ambiguous or unresolved titles remain non-Steam games.
|
|
|
|
Ownership comes from the running native ARM64 client's `BIsSubscribedApp`, through
|
|
versioned SteamClient020 / SteamUser021 / STEAMAPPS_INTERFACE_VERSION008 interfaces. The
|
|
helper gets the account from that connection, not from a public profile. No API key,
|
|
password, profile visibility change, or CEF debugging port is needed. Each probe runs in
|
|
a bounded subprocess so library failures cannot crash the importer or client.
|
|
|
|
The resulting snapshot is stored under that account's `userdata/<id>/config` and
|
|
refreshed every 30 seconds while logged in. Title lookups retry every five minutes and
|
|
when the source changes, so an early network failure does not end the watcher. Changed
|
|
status and probe failures are written to the session log. Startup and post-exit import
|
|
use the last successful snapshot for the selected account. The client reads manifests
|
|
and shortcuts only at start, so when a snapshot confirms owned titles that are not yet
|
|
imported, the watcher restarts the client once (not while a game runs or a download is in
|
|
progress) and the importer runs between the exit and the next start. An unavailable client or offline first launch falls back to shortcuts; existing
|
|
snapshots remain usable offline. Steam still enforces the current license at launch.
|
|
|
|
For a confirmed game without a manifest, the importer links the source folder into the
|
|
internal Steam library and writes an installed manifest with `Universe=1` and
|
|
`StateFlags=4`. Steam ignores manifests without the universe field. A manifest without
|
|
installed depots makes Steam verify every file, so the importer carries the build another
|
|
client recorded: WinNative's `.winnative-steam/steamapps` manifest beside the game folder,
|
|
or a completed download's `.DepotDownloader/depot.config` depot manifest IDs. Steam then
|
|
only downloads what changed since that build. Bare manifests from earlier imports are
|
|
upgraded while Steam has not touched them. Without either record Steam still verifies.
|
|
WinNative's manifest also identifies the folder without a store lookup. Steam updates and uninstall
|
|
operate on the linked game files, so imported folders must be writable. Existing Steam
|
|
manifests and directories are preserved. Only the exact minimal manifests generated by
|
|
the earlier importer are migrated, with the matching source symlink still present. If
|
|
registration fails, the game remains a shortcut. Once Steam takes over an install,
|
|
manage it in Steam; forgetting an Added Games folder only removes its shortcuts.
|
|
|
|
The account's `.droiddeck-routes.json` maps shortcut IDs to real Steam app IDs so the
|
|
Android launcher uses the same title and Proton prefix as Steam. Other accounts do not
|
|
inherit those routes. Managed shortcuts are replaced; user-created shortcuts and
|
|
unreadable shortcut files are preserved. Both routes use the existing ARM64 Proton
|
|
registration.
|
|
|
|
## Validation
|
|
|
|
Run `python3 -m unittest discover -s tools/tests -p 'test_*.py'` and Android unit tests.
|
|
Tests cover identity and edition matching, network recovery, account isolation,
|
|
owned/unowned/unknown routing, legacy manifest migration, manifest preservation,
|
|
filesystem collisions, shortcut preservation, and the versioned IPC call/cleanup
|
|
contract. On 2026-09-28, the ARM64 Steam client (1790545198) confirmed ownership and
|
|
installed status through ISteamApps for Final Fantasy VII Rebirth (2909400), Final
|
|
Fantasy VII Remake Intergrade (1462040), and Final Fantasy XV (637650), with all three
|
|
install paths resolving to the original second-library folders. The old managed
|
|
shortcuts were removed. This verifies library registration, not complete game launches.
|
|
Unowned fallback and account isolation are covered by automated tests.
|
|
|
|
References: [Steam Apps
|
|
API](https://partner.steamgames.com/doc/api/ISteamApps#BIsSubscribedApp), [Valve's
|
|
versioned interfaces](https://github.com/ValveSoftware/Proton/tree/proton_11.0/lsteamcli
|
|
ent/steamworks_sdk_154).
|