mirror of
https://github.com/Droid-Deck/DroidDeck.git
synced 2026-11-21 13:55:58 +00:00
175 lines
10 KiB
Markdown
175 lines
10 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.
|
||
|
||
## Desktop
|
||
|
||
Besides the Steam client the app can start a **desktop**: LXQt on labwc, in the same session and
|
||
the same compositor, with Xwayland for the X11 programs. It is a second choice on the main
|
||
screen, not a replacement — the Steam button still hands the session to gamescope.
|
||
|
||
What it is made of is downloaded on request from a catalog hosted beside the runtime, so the app
|
||
stays small and nothing ships that a given device will not use:
|
||
|
||
| Package | What it brings |
|
||
|---|---|
|
||
| **Desktop** (406 MB) | labwc, LXQt's panel, file manager, terminal, text and image viewers, Firefox, mpv |
|
||
| **Emulators** (694 MB) | PPSSPP and RetroArch with 28 cores — PS1, PS2, N64, SNES, NES, Game Boy, GBA, DS, Genesis, Dreamcast, Saturn, PC Engine, arcade — plus ScummVM, DOSBox, Mednafen, Snes9x |
|
||
| **RPCS3 · DuckStation · melonDS** | PS3, PS1 and DS, mirrored from the projects' own ARM64 builds |
|
||
| **PCSX2 · Dolphin · Cemu** | PS2, GameCube/Wii and Wii U. No ARM64 Linux build exists upstream for any of the three, so they are compiled from source against the same glibc the runtime uses |
|
||
|
||
The desktop composites in software: wlroots allocates through gbm on a real DRM render node, and
|
||
the Adreno stand-in is not one, so labwc runs on pixman. The programs on it still reach the GPU
|
||
themselves through Vulkan and Turnip — it is the desktop's own compositing that is on the CPU.
|
||
`Download/steamdeck-wlr-renderer` (`pixman`, `gles2` or `vulkan`) overrides the choice.
|
||
|
||
Programs whose child processes sandbox themselves with seccomp and namespaces cannot set those up
|
||
under proot; Firefox's are turned off in the session's environment, without which its tabs crash.
|
||
|
||
## Pointer
|
||
|
||
The app draws the arrow. On the desktop, touch is a **touchpad** (Bannerlator's desktop-container
|
||
feel): drag anywhere and the pointer moves from where it is; tap to click; a second finger tapping
|
||
while one holds, or a two-finger tap, right-clicks; two fingers scroll; hold still then drag, or
|
||
double-tap-and-hold, drags. In Steam, touch is **direct**: the pointer jumps under the finger. The
|
||
drawer's *Touch* switch pins either. A USB or Bluetooth mouse works as itself.
|
||
|
||
## Networking
|
||
|
||
The desktop's programs use the phone's network directly — proot makes no network namespace, so
|
||
IPv4 and IPv6 both pass through — and the app writes the runtime's `/etc/resolv.conf` from the
|
||
active network's own DNS servers whenever the link changes (IPv4 first, never a link-local IPv6 one,
|
||
public servers as fallback), which is what Firefox and everything else in the desktop resolve with.
|
||
|
||
## Keyboard
|
||
|
||
**Keyboard** in the drawer opens the soft keyboard over the session. Steam's UI and the games
|
||
under it are X11 clients of gamescope and know nothing of Wayland text input, so what the
|
||
keyboard produces is turned into the key presses that would have typed it — Shift included, so
|
||
capitals and the symbol row (`@`, `!`, `_` …) arrive as themselves — and fed to the compositor as
|
||
key events. A hardware keyboard works as it is.
|
||
|
||
## Starting Steam offline
|
||
|
||
The client runs without a connection — installed games launch, Proton and the frame generation
|
||
are local — provided it has credentials from a sign-in that succeeded earlier. **Start offline**
|
||
on the main screen is where that is decided, and not in the drawer, because the client reads the
|
||
two keys that control it once, while it starts: changed during a session it would write the file
|
||
and change nothing until the next launch. Without an earlier sign-in the button says so and does
|
||
nothing. The client rewrites those keys when it exits, so the app writes them again at every
|
||
session start. Games with always-online DRM will not start offline, and nothing can be installed
|
||
or updated.
|
||
|
||
## Compatibility tools
|
||
|
||
**Compatibility tools** (main screen and drawer) installs GE-Proton or proton-cachyos — native
|
||
ARM64 builds — beside the ARM64 Proton Valve ships. The runtime's own registrar downloads and
|
||
installs a requested build when the next session starts (several hundred MB), patches it past
|
||
pressure-vessel like Valve's, and it then appears in Steam under Properties → Compatibility for
|
||
any game. The dialog queues or cancels a request and removes an installed build.
|
||
|
||
## 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 opens the drawer**: the performance HUD switch, frame generation, on-screen controls
|
||
(auto / always / never), the display shape (the panel's own, or a fixed 16:9 — the default on a
|
||
foldable, so opening or closing it mid-session only changes the bars, never the picture; takes
|
||
effect on the next session), *Send to background* and *Stop session*. Backgrounded, Steam keeps
|
||
running and the (silent) notification brings it back. A session ends only when you say so — the
|
||
drawer or the notification's **Stop session** — 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-no-hud` | Hides the top-right performance line (fps, and `base → generated` while frame generation runs) |
|
||
| `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, the frame
|
||
generation engines and the runtime plumbing are Bannerlator's. Underneath all of it is Winlator
|
||
(brunodev85, GPL-3.0): the PulseAudio-on-AAudio audio stack, the gamepad state model and the shape
|
||
of a session's host-side components are his, and WinNative and Bannerlator are both Winlator
|
||
lineage. Valve, Steam and Proton are Valve Corporation's; this project
|
||
is not affiliated with Valve.
|