# GameLink Windows receiver

This is the Windows x64 companion for the Android GameLink sender. It listens on TCP port `51337`, decodes the sender's H.264 stream with Windows Media Foundation, plays 48 kHz stereo PCM game audio through the selected Windows output device, and displays one OBS-capturable window.

## Run on Windows

1. Download the x64 release folder and run `GameLinkReceiver.exe`.
2. When Windows Firewall asks, allow it on the private network used by the phone/USB adapter.
3. Connect Android by a data cable and enable USB debugging. The receiver sets
   up the USB route automatically when Android Platform Tools are installed.
   It displays a clear status message if the phone needs USB-debug authorization
   or Platform Tools are missing.

4. In the Android app, leave the receiver as `127.0.0.1:51337`, unlock access, and start sharing.
5. In OBS, add **Window Capture** and select **GameLink Capture**. Add **Application Audio Capture** and choose GameLink Capture if you also want the Android game audio in OBS.

Use **Alt+Space** in the receiver window to open Privacy Policy, Terms of Use,
Support, Third-Party Notices, or About without adding controls over the capture.

## Direct-download safety

The current Windows ZIP is an unsigned direct download while Microsoft Store
packaging and trusted code signing are deferred. Windows may show a SmartScreen
warning for a new download. Download only from the official GameLink website;
do not bypass a warning for a file received from any other source. Before
publishing a new ZIP, follow the shared [`RELEASE_CHECKLIST.md`](../RELEASE_CHECKLIST.md).

The receiver uses Windows 10/11 components already present on the PC: Media Foundation's H.264 decoder and XAudio2. No iOS or macOS code is changed.

Android Platform Tools is Google software with its own license. Do not bundle
it into GameLink without a licensing review; direct users to the official
Platform Tools download when the receiver reports that it is missing.

## Build from source

Install Visual Studio 2022 with the **Desktop development with C++** workload and CMake support. Then run:

```powershell
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
cmake --build build --config Release
```

The executable is produced at `build\Release\GameLinkReceiver.exe`.
