# Gamescope compatibility build provenance

This directory is the canonical source record for the patched Gamescope helper
shipped by the launcher. The executable remains in the Python package because
runtime lookup and installed paths are compatibility interfaces.

## Artifact

| Property | Recorded value |
| --- | --- |
| Source package | Ubuntu `gamescope 3.16.20+ds-1` |
| Build environment | `ubuntu:26.04` container |
| Target | Ubuntu 26.04, amd64, Linux x86-64 baseline |
| Packaged source | `src/ptlinux/native/gamescope-3.16.20-ubuntu26.04-amd64` |
| Installed path | `ptlinux/native/gamescope-3.16.20-ubuntu26.04-amd64` |
| ELF build ID | `165d21610879119d75ab8e4c3d7389d8f0743926` |
| SHA-256 | `3fc81536c22dcce2c593c11507a612c13221f5b2ce2e5326f7c63706ca965639` |

`source.sha256` records the exact Ubuntu source archives. Obtain both archives
without renaming them and place them in
`.artifacts/native/gamescope/sources/`:

- `gamescope_3.16.20+ds.orig.tar.xz`
- `gamescope_3.16.20+ds-1.debian.tar.xz`

The patches are applied in this order:

1. `gamescope-wayland-letterbox-backing.patch`
2. `gamescope-wayland-libdecor-input-scope.patch`
3. `gamescope-lazy-output-images.patch`
4. `gamescope-wayland-live-resize.patch`
5. `gamescope-keep-nested-windows-visible.patch`

## Build

Run the recipe from any directory:

```text
./native/gamescope/build.sh
```

Pass a different source-archive directory as the first argument and an output
directory as the second argument when needed. Set `CONTAINER_ENGINE` to select
Docker or Podman explicitly. The recipe builds with `dpkg-buildpackage` in an
Ubuntu 26.04 amd64 container, writes below `.artifacts/` by default, and checks
the result against `binary.sha256`. It refuses to write over the shipped helper.
The container downloads build dependencies, so the Ubuntu 26.04 package
repositories used at build time remain part of the build environment.

The files named `gamescope-compat.README`, `gamescope-compat.copyright`, and the
five patches continue to be staged at their historical flat installed paths.
The full Debian copyright record is retained in
`gamescope-compat.copyright`.