mirror of
https://github.com/Droid-Deck/DroidDeck.git
synced 2026-11-21 22:05:59 +00:00
The compositor was built with its frame-generation leg stubbed out. Bannerlator's two engines and the DXBC translator they need now ride along, so extra frames are generated on gamescope's final output — any game, nothing changed in the runtime. Win-FG needs nothing; LSFG takes its shader chain from the user's own Lossless Scaling, which in this app is installed from the Steam client and read straight out of the runtime's library. One picker on the main screen: Off, or an engine at 2x/3x/4x, applied live on the next return to the session.
102 lines
5.2 KiB
Markdown
102 lines
5.2 KiB
Markdown
# SteamDeck
|
||
|
||
Valve's **native aarch64 Linux Steam client**, running on an Android phone or handheld: a glibc
|
||
rootfs under proot, gamescope as a Wayland client of an in-app Vulkan compositor, Xwayland and
|
||
Zink for the client's CEF, and the device's Turnip driver underneath. There is no Wine here, and
|
||
no x86 translation for the client itself — it is ARM code running as ARM code. Windows games it
|
||
launches go through Valve's own ARM64 Proton build, which is where FEX comes in.
|
||
|
||
One screen, one button: install the runtime, press Play, Big Picture comes up.
|
||
|
||
## How it fits together
|
||
|
||
```
|
||
Android app (this repo)
|
||
├── libbannerwayland.so Wayland compositor, presents into the activity's Surface (Vulkan/Turnip)
|
||
├── PulseAudio 13 + AAudio the guest's audio server, on a socket bound into the session
|
||
├── fake-evdev rings a physical pad, republished as /dev/input/eventN for the client
|
||
└── proot ── linuxfs (~790 MB, downloaded once)
|
||
├── gamescope ── Xwayland ── Zink
|
||
└── Steam (steamrtarm64, fetched from Valve on first run) ── Proton ARM64 ── FEX
|
||
```
|
||
|
||
The runtime image is the one published for Bannerlator (`linuxfs.json` in
|
||
`The412Banner/winlator-contents`); this app installs and updates it from that catalog. **No Valve
|
||
software is redistributed** — the client is fetched from Valve's own manifest on the device at
|
||
first use.
|
||
|
||
## Building
|
||
|
||
Nothing is built locally. Push, and the `Build APK` workflow produces `steamdeck-apk`, a
|
||
debug-signed arm64 apk. It cross-compiles the two glibc preloads the session needs
|
||
(`libfakeinput.so`, `libblsession.so`) from the sources in this repo before the app build, so
|
||
those can never drift from what ships.
|
||
|
||
## If Bannerlator is already installed
|
||
|
||
The runtime image is the same one Bannerlator installs, so on a device that already has it the
|
||
790 MB download can be skipped entirely — copy it across with root, once, before the first launch:
|
||
|
||
```sh
|
||
su -c 'cp -a /data/data/com.tencent.ig/files/linuxfs /data/data/com.steamdeck.launcher/files/ \
|
||
&& chown -R $(stat -c %u /data/data/com.steamdeck.launcher/files) \
|
||
/data/data/com.steamdeck.launcher/files/linuxfs \
|
||
&& chcon -R u:object_r:app_data_file:s0 /data/data/com.steamdeck.launcher/files/linuxfs'
|
||
```
|
||
|
||
The two runtimes are independent after that: each app has its own Steam install, its own login and
|
||
its own games.
|
||
|
||
## Controls
|
||
|
||
A physical controller is republished into the session as a synthetic Xbox 360 pad, which is the
|
||
identity SDL and Steam have a mapping for. With nothing attached, an on-screen pad appears —
|
||
d-pad, A/B/X/Y, shoulders, select/start and the Steam button — writing into the same rings, so the
|
||
client sees one pad either way. Connect a controller and the on-screen one disappears; unplug it
|
||
and it comes back. Anywhere the controls are not is a touchpad: touch moves the pointer and a tap
|
||
clicks, which is how the client's own on-screen keyboard is used to sign in.
|
||
|
||
## Frame generation
|
||
|
||
Extra frames are generated between the real ones on the way to the screen — inside the app's
|
||
compositor, on gamescope's final output — so it works for any game with nothing changed in the
|
||
runtime. **Win-FG** is built in. **LSFG** uses the shader chain from your own copy of Lossless
|
||
Scaling: install it from the Steam client in this app and the app reads its `Lossless.dll` from
|
||
the runtime's Steam library (parsed as data, never executed; nothing of it is redistributed).
|
||
Pick an engine and 2×/3×/4× on the main screen; it applies immediately, mid-game included.
|
||
|
||
## Background and foreground
|
||
|
||
A session belongs to a foreground service, not to the activity, so leaving Big Picture does not
|
||
end it: the process stays at perceptible priority, a partial wake lock keeps the CPU from dropping
|
||
the guest's threads, and a high-performance WiFi lock keeps a backgrounded download from being
|
||
throttled to nothing. Back puts the app away and leaves Steam running; the (silent) notification
|
||
brings it back. A session ends only when you say so — the notification's **Stop session** action —
|
||
or when the app is swiped out of recents.
|
||
|
||
## Device switches
|
||
|
||
Files in `/sdcard/Download`, for a device that cannot be reached with a debugger:
|
||
|
||
| File | Effect |
|
||
|---|---|
|
||
| `steamdeck-no-pad` | Turns the controller feature off entirely (a true baseline) |
|
||
| `steamdeck-pad-log` | Traces every interposer call into the session log |
|
||
| `steamdeck-driver` | `a7xx`, `a8xx` or `system` — overrides the Turnip build the compositor loads |
|
||
| `steamdeck-osc` | `always` or `never` — pins the on-screen controls instead of following what is attached |
|
||
|
||
Session logs land in `/sdcard/Download/SteamDeck/`.
|
||
|
||
## Authors
|
||
|
||
- **The412Banner** — the app, the Wayland compositor, the runtime plumbing and the Steam session.
|
||
- **maxjivi05 (Max)** — the gamescope runtime this is built on: the proot session, the session
|
||
shim, the fake-evdev interposer and the controller work, from WinNative.
|
||
|
||
## Lineage and licence
|
||
|
||
GPL-3.0. The gamescope runtime, the session shim and the fake-evdev interposer come from
|
||
maxjivi05's WinNative work and from Bannerlator, both GPL-3.0; the Wayland compositor and the
|
||
runtime plumbing are Bannerlator's. Valve, Steam and Proton are Valve Corporation's; this project
|
||
is not affiliated with Valve.
|