chore: simplify UI copy and repo text

This commit is contained in:
xXJsonDeruloXx committed 2026-09-23 08:22:11 -04:00
1 parent a1e204c117
commit 02c159c5fd
96 files changed
+703 -1435

No files matched your search

+17 -17
View File
@@ -1,4 +1,4 @@
# Lineage audit — what in this repo is Winlator's, and what it would take to leave the lineage
# Lineage audit - what in this repo is Winlator's, and what it would take to leave the lineage
Audited 2026-09-23 against Winlator upstream (brunodev85's commits in the Bannerlator history) with
a text-similarity measure, not by trusting the comments. Everything below is verifiable with
@@ -22,7 +22,7 @@ the forks. Measured against Bruno's originals:
- DirectAudio, both the Wine driver and the relay (Bannerlator);
- Win-FG (Bannerlator, FSR3-derived) and LSFG Native (WinNative's port of lsfg-vk);
- the gamescope runtime, the session shim and the fake-evdev layer (WinNative); the proot launch
here measures 1.5 % against Winlator's launcher — proot is the shared idea, none of the code is;
here measures 1.5 % against Winlator's launcher - proot is the shared idea, none of the code is;
- the file manager, the front end, the settings, the session service (Bannerlator / this app).
## 1. App code that is measurably Winlator's
@@ -36,7 +36,7 @@ the forks. Measured against Bruno's originals:
| `core/ProcessHelper.java` | `core/ProcessHelper.java` | 21 % | 116 | spawn a process, drain its output |
Five files, 228 lines, none above 55 %. Everything else with a Winlator name on it measures under
12 % against Bruno's text — i.e. the file name and a few field names survived, the code did not:
12 % against Bruno's text - i.e. the file name and a few field names survived, the code did not:
| File | Compared with | Shared text |
|---|---|---|
@@ -51,48 +51,48 @@ Five files, 228 lines, none above 55 %. Everything else with a Winlator name on
## 2. Things named after Winlator that are not Winlator's code
- **`app/src/main/cpp/winlator/`** — the directory name only. Inside: `lsfg/` (WinNative's port of
- **`app/src/main/cpp/winlator/`** - the directory name only. Inside: `lsfg/` (WinNative's port of
lsfg-vk, credited to Eden / PancakeTAS), `winfg/` (Bannerlator's Win-FG, FSR3-derived, with its own
LICENSE and FidelityFX notice), `VulkanRendererContext.h` (a Vulkan dispatch table struct from
Bannerlator's renderer, first written by yaywoohoo in June 2026). Referenced by 6 lines in
`cpp/CMakeLists.txt` and 8 in `waylandcomp/CMakeLists.txt`, plus 9 comment lines in the compositor.
- **`scanout/ScanoutContext.h`** — Bannerlator's (The412Banner, June 2026). Log tag `Winlator_Scanout`.
- **`scanout/ScanoutContext.h`** - Bannerlator's (The412Banner, June 2026). Log tag `Winlator_Scanout`.
- **`VulkanRendererContext.h`** log tags `Winlator_Renderer`, `Winlator_Scanout`.
- **`fakeinput_steam.cpp`** — Max's, from WinNative. Connects to an abstract socket named
- **`fakeinput_steam.cpp`** - Max's, from WinNative. Connects to an abstract socket named
`winlator_vibration` for rumble. **Nothing in this app serves that socket** (the server was
Winlator's WinHandler); the connect fails silently and rumble is dead code here.
- **`winlator-contents`** — the name of the public catalog repo, in two URLs (`linuxfs.json`,
- **`winlator-contents`** - the name of the public catalog repo, in two URLs (`linuxfs.json`,
`desktop.json`) and the README. A repo name, not code.
- **File manager comments** mention a `/storage/emulated/0/Winlator/…` path as an example.
- **`WAYLAND_RUNTIME.md`, `HDR_RECON.md`** — design notes carried from Bannerlator that describe
- **`WAYLAND_RUNTIME.md`, `HDR_RECON.md`** - design notes carried from Bannerlator that describe
Bannerlator's X11 renderer (`libwinlator.so`), which this app does not have.
## 3. Credits and prose
- `README.md` — "Lineage and licence" paragraph and the credits list name Winlator.
- `ui/MainScreen.kt` — the credits dialog text (the rest of that file is dead code).
- `docs/releases/0.1.0.md` … `0.1.5.md` — a Winlator credit line each (published release notes;
- `README.md` - "Lineage and licence" paragraph and the credits list name Winlator.
- `ui/MainScreen.kt` - the credits dialog text (the rest of that file is dead code).
- `docs/releases/0.1.0.md` … `0.1.5.md` - a Winlator credit line each (published release notes;
history, leave as is).
- `PROGRESS_LOG.md` — five mentions, all of the `winlator-contents` repo.
- `PROGRESS_LOG.md` - five mentions, all of the `winlator-contents` repo.
## 4. What it would take
**To stop using Winlator code at all** — rewrite the five files in §1 (228 lines, an afternoon):
**To stop using Winlator code at all** - rewrite the five files in §1 (228 lines, an afternoon):
a callback interface, a start/stop base class, a pad state holder, an env list, a process spawner.
None of them does anything Winlator-specific; they are the shapes any such app has. Then the one
real piece: a **new AAudio sink module** for PulseAudio in place of the forked one — a few hundred
real piece: a **new AAudio sink module** for PulseAudio in place of the forked one - a few hundred
lines of C against the PulseAudio 13 module API (a sink that pulls from PA's render loop into an
AAudio stream, with the adaptive buffer logic Bannerlator added kept), rebuilt into the audio
bundle by the existing build-pulseaudio workflow. A day or two, and the part most worth testing.
**To stop being named after it** — rename `cpp/winlator/` (to `framegen/`), fix the two CMake
**To stop being named after it** - rename `cpp/winlator/` (to `framegen/`), fix the two CMake
files, the log tags, the abstract-socket name (and remove the dead rumble client while at it), and
the comments; drop the Bannerlator design notes that describe the X11 path this app never had.
**To take it out of the credits** — the README paragraph, the credits dialog, and the credit line
**To take it out of the credits** - the README paragraph, the credits dialog, and the credit line
in future release notes. Past notes stay as published.
**What does not change** — the licence. Everything here is GPL-3.0 and stays so: the runtime and the
**What does not change** - the licence. Everything here is GPL-3.0 and stays so: the runtime and the
fake-evdev layer are Max's (WinNative, GPL-3.0), the compositor, frame generation, file manager
and the session are Bannerlator's (GPL-3.0), lsfg-vk and FidelityFX carry their own notices. Leaving
Winlator's lineage does not leave the GPL, and does not touch the runtime image, which is shared
+42 -42
View File
@@ -1,6 +1,6 @@
# SteamDeck 0.1
**Valve's native ARM64 Linux Steam client, on an Android phone or handheld — and now a Linux
**Valve's native ARM64 Linux Steam client, on an Android phone or handheld - and now a Linux
desktop beside it.** No Wine, and no x86 translation for the client itself: it is ARM code running
as ARM code, under gamescope, presenting through an in-app Vulkan compositor onto your screen.
Windows games it launches go through Valve's own ARM64 Proton, which is where FEX comes in.
@@ -8,7 +8,7 @@ Windows games it launches go through Valve's own ARM64 Proton, which is where FE
This is the first release. One screen, one button: install the runtime, press **Play**, Big
Picture comes up.
> ⚠️ **Early software.** The Steam client and the desktop have both been run end to end on real
> **Early software.** The Steam client and the desktop have both been run end to end on real
> hardware, but this is version 0.1 and a great deal of it has been exercised on one or two
> devices only. Where something has not been tested, this page says so rather than implying it
> works.
@@ -17,16 +17,16 @@ Picture comes up.
# What it does
## 🎮 The Steam client, natively
## The Steam client, natively
Sign in, browse your library, install and play. The client is fetched from Valve's own manifest on
the device at first use — **no Valve software is redistributed here**. Windows games run through
the device at first use - **no Valve software is redistributed here**. Windows games run through
the ARM64 Proton build Valve ships, downloaded by Steam itself.
✅ **Proven on device:** sign-in, Proton ARM64 fetched automatically, a game installed from the
store and launched — *FlatOut* rendering at 144 Hz.
**Proven on device:** sign-in, Proton ARM64 fetched automatically, a game installed from the
store and launched - *FlatOut* rendering at 144 Hz.
## 🖥️ A Linux desktop
## A Linux desktop
A second thing the app can start: **LXQt on labwc**, in the same session and the same compositor,
with Xwayland for X11 programs. Everything on it is downloaded on request from a catalog hosted
@@ -36,56 +36,56 @@ beside the runtime, so the app stays small.
|---|---|
| **Desktop** (406 MB) | labwc, LXQt panel, file manager, terminal, text and image viewers, Firefox, mpv |
| **Emulators** (694 MB) | PPSSPP and RetroArch with 28 cores, plus ScummVM, DOSBox, Mednafen, Snes9x |
| **RPCS3 · DuckStation · melonDS** | PS3, PS1, DS — the projects' own ARM64 builds |
| **PCSX2 · Dolphin · Cemu** | PS2, GameCube/Wii, Wii U — **no ARM64 Linux build exists upstream for any of these three**, so they are compiled from source against the same glibc the runtime uses |
| **RPCS3 · DuckStation · melonDS** | PS3, PS1, DS - the projects' own ARM64 builds |
| **PCSX2 · Dolphin · Cemu** | PS2, GameCube/Wii, Wii U - **no ARM64 Linux build exists upstream for any of these three**, so they are compiled from source against the same glibc the runtime uses |
Between them: PS1, PS2, PS3, PSP, GameCube, Wii, Wii U, N64, SNES, NES, Game Boy/Color/Advance,
DS, Genesis, Dreamcast, Saturn, PC Engine, arcade and DOS.
✅ **Proven on device:** the desktop starts, panel and wallpaper and file manager all come up, at
**Proven on device:** the desktop starts, panel and wallpaper and file manager all come up, at
the panel's native resolution, and Firefox browses the live internet at 93 fps.
⚠️ **Not yet run on device:** the emulators themselves. They build, publish and install; none has
**Not yet run on device:** the emulators themselves. They build, publish and install; none has
been launched with a game yet.
## 🎞️ Frame generation
## Frame generation
Extra frames generated between the real ones **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.
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` out of 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.
screen - it applies immediately, mid-game included.
✅ **Proven on device:** LSFG 2× generating in *FlatOut* — 30 → 61, 60 → 118 and 61 → 123 fps
**Proven on device:** LSFG 2× generating in *FlatOut* - 30 → 61, 60 → 118 and 61 → 123 fps
observed, with the on-screen readout showing `base → generated`.
## 🎛️ Controls, pointer and keyboard
## Controls, pointer and keyboard
A physical controller is republished into the session as a synthetic **Xbox 360 pad** — the
A physical controller is republished into the session as a synthetic **Xbox 360 pad** - the
identity SDL and Steam have a mapping for. With nothing attached an **on-screen pad** appears and
writes 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 returns.
The app draws the pointer. On the desktop, touch is a **touchpad**: 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-then-drag drags. In Steam, touch is **direct** — the
tap) right-clicks, two fingers scroll, hold-then-drag drags. In Steam, touch is **direct** - the
pointer jumps under your finger. A USB or Bluetooth mouse works as itself.
**Keyboard** in the drawer puts the soft keyboard over the session, turned into the key presses
that would have typed it — Shift included, so capitals and the symbol row arrive as themselves.
that would have typed it - Shift included, so capitals and the symbol row arrive as themselves.
⚠️ **Not yet tested on device:** the soft keyboard.
**Not yet tested on device:** the soft keyboard.
## 🌐 Networking
## Networking
The session uses the phone's network directly — proot creates no network namespace, so **IPv4 and
IPv6 both pass straight through** — and the app writes the runtime's `/etc/resolv.conf` from the
The session uses the phone's network directly - proot creates no network namespace, so **IPv4 and
IPv6 both pass straight through** - and the app writes the runtime's `/etc/resolv.conf` from the
active network's own DNS servers every time the link changes.
✅ **Proven on device:** name resolution and an HTTPS fetch over both IPv4 and IPv6 from inside
**Proven on device:** name resolution and an HTTPS fetch over both IPv4 and IPv6 from inside
the session, and Firefox loading live pages.
## 🔌 Starting Steam offline
## Starting Steam offline
**Start offline** on the main screen brings the client up without signing in to Valve. Installed
games launch; Proton and the frame generation are local anyway. It lives on the main screen and
@@ -93,19 +93,19 @@ not in the drawer for a reason: the client reads the keys that control this *onc
starts, so changing it mid-session would do nothing until the next launch. Without an earlier
successful sign-in the button says so and stays disabled.
⚠️ **Not yet tested on device.** Games with always-online DRM will not start offline, and nothing
**Not yet tested on device.** Games with always-online DRM will not start offline, and nothing
can be installed or updated while offline.
## 🧰 Compatibility tools
## Compatibility tools
**Compatibility tools** installs **GE-Proton** or **proton-cachyos** — native ARM64 builds —
**Compatibility tools** installs **GE-Proton** or **proton-cachyos** - native ARM64 builds -
beside the ARM64 Proton Valve ships. The runtime's registrar fetches a requested build at the next
session start, patches it past pressure-vessel, and it appears in Steam under Properties →
Compatibility for any game.
⚠️ **Not yet tested in this app.**
**Not yet tested in this app.**
## 📱 Background, foreground and the drawer
## Background, foreground and the drawer
A session belongs to a **foreground service**, not to the activity, so leaving Big Picture does
not end it: perceptible priority, a partial wake lock so the guest's threads keep running, and a
@@ -116,13 +116,13 @@ notification is silent and brings the session back.
(auto/always/never), touch mode, display shape, *Send to background* and *Stop session*. A session
ends only when you say so.
## 📐 Foldables and odd panels
## Foldables and odd panels
The main screen scales to whatever panel and density it is given. In a session the display shape
is either the panel's own or a fixed **16:9** — the default on a foldable, so opening or closing
is either the panel's own or a fixed **16:9** - the default on a foldable, so opening or closing
the device mid-session changes only the bars, never the picture.
✅ **Proven on device:** unfolding and folding a Fold mid-session.
**Proven on device:** unfolding and folding a Fold mid-session.
---
@@ -131,7 +131,7 @@ the device mid-session changes only the bars, never the picture.
Download the APK below and install it. On first launch it downloads the Linux runtime (~790 MB,
once). Then press **Play**.
**If Bannerlator is already installed**, the runtime image is the same one — the README shows how
**If Bannerlator is already installed**, the runtime image is the same one - the README shows how
to copy it across with root and skip the download entirely. The two apps stay independent after
that: separate Steam installs, separate logins, separate games.
@@ -144,11 +144,11 @@ driver), and roughly 3 GB free for the runtime before any games.
- **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. Programs still reach the GPU
themselves through Vulkan and Turnip — it is the desktop's own compositing that is on the CPU.
themselves through Vulkan and Turnip - it is the desktop's own compositing that is on the CPU.
- **Firefox's child-process sandboxes are turned off**, because seccomp and namespace sandboxes
cannot be set up under proot and its tabs crash otherwise. This is a real reduction in
isolation: treat browsing here as less protected than on a normal desktop.
- **Changing the display shape takes effect at the next session**, not immediately — gamescope
- **Changing the display shape takes effect at the next session**, not immediately - gamescope
fixes its display size when it starts.
- **No Switch emulator.** Eden's repository was taken down in February and there is nothing to
mirror or build from.
@@ -157,18 +157,18 @@ driver), and roughly 3 GB free for the runtime before any games.
---
<details>
<summary><b>🙏 Credits</b> (tap to expand)</summary>
<summary><b> Credits</b> (tap to expand)</summary>
- **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
- **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.
- **Winlator (brunodev85)** — the PulseAudio-on-AAudio audio stack, the gamepad state model and
- **Winlator (brunodev85)** - the PulseAudio-on-AAudio audio stack, the gamepad state model and
the shape of a session's host-side components. WinNative and Bannerlator are both Winlator
lineage.
GPL-3.0. gamescope, Mesa, Turnip, Xwayland, labwc, LXQt, PulseAudio, proot and Arch Linux ARM are
their own authors'. Valve, Steam, Steam Deck and Proton are trademarks of Valve Corporation; this
project is not affiliated with Valve, and no Valve software is redistributed — the client is
project is not affiliated with Valve, and no Valve software is redistributed - the client is
fetched from Valve's own manifest on your device.
</details>
@@ -177,6 +177,6 @@ fetched from Valve's own manifest on your device.
---
**APK** `SteamDeck-0.1.apk` — 15832230 bytes
**APK** `SteamDeck-0.1.apk` - 15832230 bytes
`sha256 e181dfcc20957c3f824799ed3ef5ec73ddbf9957b7dbb2224c08b7e34ef8db11`
Built from `05fc566` by [run 35503326574](https://github.com/The412Banner/SteamDeck/actions/runs/35503326574). Signed with the AOSP test key (v1 + v2 + v3), so it installs over earlier test builds in place.
+35 -35
View File
@@ -1,93 +1,93 @@
# SteamDeck 0.1.1
**A patch release, and mostly about the two things 0.1 could not do: change a driver, and tell you
what went wrong.** Install it over 0.1 — same key, same runtime, nothing to re-download.
what went wrong.** Install it over 0.1 - same key, same runtime, nothing to re-download.
Everything here came out of one day of reports from three devices, which is why so much of it is
about being able to *see* a fault rather than a new feature.
---
## 🧩 Graphics drivers — a new button on the main screen
## Graphics drivers - a new button on the main screen
Two lists, because a zip for one cannot serve the other:
- **Linux runtime driver** — the glibc Turnip everything *inside* the runtime renders on: the Steam
- **Linux runtime driver** - the glibc Turnip everything *inside* the runtime renders on: the Steam
client's interface, every game it launches, and in desktop mode every program on the desktop.
Import a `-Linux` Turnip zip; an Android or `-Wayland` zip is refused with the reason rather than
becoming a black screen. The choice is **per mode**, so Steam and the desktop can run different
builds. Nothing inside the runtime is modified — the session is pointed at the imported driver
builds. Nothing inside the runtime is modified - the session is pointed at the imported driver
and the runtime's own Turnip is what a removed or unreadable import falls back to.
- **Display driver (Android)** — the bionic Turnip the app's compositor puts the frame on the panel
- **Display driver (Android)** - the bionic Turnip the app's compositor puts the frame on the panel
with. *Auto* keeps the GPU pick between the two bundled builds; an imported AdrenoTools zip can
be chosen instead. It applies after the app is fully closed and reopened, because the compositor
loads its driver once per process.
This is how a driver fix now reaches an installed runtime without a ~790 MB re-download.
✅ **Proven on device:** an imported Mesa 26.3.0 (Vulkan 1.4.363) glibc Turnip drawing a whole Steam
session — gamescope, the client, its UI helpers and Xwayland all on it — with an imported Android
**Proven on device:** an imported Mesa 26.3.0 (Vulkan 1.4.363) glibc Turnip drawing a whole Steam
session - gamescope, the client, its UI helpers and Xwayland all on it - with an imported Android
Turnip in the compositor in place of the bundled build.
### 📱 Adreno 710 / 720 / 722
### Adreno 710 / 720 / 722
0.1 cannot start on these at all: Mesa has no entry for them and the session dies at
`device (chip_id = 7010000, gpu_id = 710) is unsupported`. There is now a path — import
`device (chip_id = 7010000, gpu_id = 710) is unsupported`. There is now a path - import
`Turnip-…-710-720-Test.zip` as the **Display driver** and `…-710-720-Test-Linux.zip` as the **Linux
runtime driver**, from Banners-Turnip's `v26.3.0-20260921-r3` or newer. Those GPUs also want
sysmem rendering, which the app sets on its own when it sees that driver chosen.
⚠️ **Unverified on real hardware.** Nobody has run this runtime on a 710 yet. If you have one,
**Unverified on real hardware.** Nobody has run this runtime on a 710 yet. If you have one,
the session folder is the thing to send.
---
## 🔊 Sound, and the microphone
## Sound, and the microphone
**DirectAudio for games** replaces Wine's audio driver *inside the games the client launches* with
one that talks straight to Android over a socket — no PulseAudio in between, and no resampling.
one that talks straight to Android over a socket - no PulseAudio in between, and no resampling.
The client itself keeps PulseAudio either way; it is a native Linux program with no other way to
make a sound. It pairs only with a Wine 11 Proton (Valve's ARM64 builds, GE-Proton, proton-cachyos)
and stays off on anything else rather than play silence, saying so in the log.
**Microphone** is its own switch: the relay helper opens Android's input stream under the app's own
uid — which is what the recording permission is checked against — and PulseAudio exposes it to the
uid - which is what the recording permission is checked against - and PulseAudio exposes it to the
client as **DirectAudioMic**, for voice chat. With it off, nothing in the session can record and
Android's indicator stays off.
Both are under **Audio** on the main screen, both off by default, both applying at the next session
start. A game's first launch after enabling DirectAudio still uses Proton's own audio — the driver
is named in that game's prefix, which does not exist until then — and the second uses DirectAudio.
start. A game's first launch after enabling DirectAudio still uses Proton's own audio - the driver
is named in that game's prefix, which does not exist until then - and the second uses DirectAudio.
⚠️ Built and wired; the microphone reached `DirectAudioMic` only after a fix to the bundled
Built and wired; the microphone reached `DirectAudioMic` only after a fix to the bundled
PulseAudio (0.1 shipped a 17.0 build of the module beside a 13.0 daemon, so it could never load).
Treat voice as ready to test rather than proven.
---
## 🎮 Steam's overlay, and the app that takes your login
## Steam's overlay, and the app that takes your login
Two deviations from a normal Steam launch, both removed rather than worked around.
The overlay used to be stripped from every game, because it sat in front of the controller reader.
That was an ordering problem — the interposer now goes first and the overlay loads as Valve intends.
That was an ordering problem - the interposer now goes first and the overlay loads as Valve intends.
Every difference between the launch Valve ships and what runs here is a difference this runtime
would otherwise have to account for.
And another Steam client on the same phone signs this one out seconds after every login. The app
now asks Android to stop it when a session starts and says so. ⚠️ Where that app restarts itself
through boot receivers, a background stop is a race it can win — if the client keeps signing out,
now asks Android to stop it when a session starts and says so. Where that app restarts itself
through boot receivers, a background stop is a race it can win - if the client keeps signing out,
uninstall the other one.
---
## 🧮 Performance and session fixes
## Performance and session fixes
**Performance** on the main screen, all off by default, all applying at the next session start:
| | |
|---|---|
| **Steam client cores** | Steam pins its own interface to a subset of cores it chooses — on one device five of eight, leaving out the fastest — which suits a running game and makes the menus sluggish when the client is all there is. Overriding it pins the client, its UI helper and gamescope to the cores you tick, re-applied every few seconds because the UI keeps spawning helpers that inherit Steam's choice |
| **Steam client cores** | Steam pins its own interface to a subset of cores it chooses - on one device five of eight, leaving out the fastest - which suits a running game and makes the menus sluggish when the client is all there is. Overriding it pins the client, its UI helper and gamescope to the cores you tick, re-applied every few seconds because the UI keeps spawning helpers that inherit Steam's choice |
| **Game cores** | the cores a game may run on, applied by exec'ing it through `taskset` so every thread inherits the mask from its first instruction |
| **Skip Steam's xalia helper** | `xalia` is an x86 Windows program Proton starts for gamepad navigation. On some devices its system calls are refused in a way it cannot cope with and the session dies seconds after Big Picture appears. Turn this on if a session will not stay up |
| **Run proot without seccomp** | proot normally lets most system calls run untraced, which is most of its speed. Some kernels handle that badly and refuse calls that plainly exist. This traces everything instead: slower, but correct |
@@ -99,7 +99,7 @@ an experiment that would otherwise need a build per attempt.
---
## 🗂️ Logs worth sending
## Logs worth sending
This is the change that will save the most time. Each session now gets **its own folder**:
@@ -111,7 +111,7 @@ Download/SteamDeck/session-20260921-161256/
crash.log Android's crash buffer, as it stood when the session ended
audio.log the PulseAudio daemon and the DirectAudio relay helper
session.log the guest session: proot, gamescope, the client's own output
wayland.log the compositor — what it presented, and how fast
wayland.log the compositor - what it presented, and how fast
steam.log + steam/ the client's own logs (Steam mode)
desktop.log labwc, the panel and the programs on it (desktop mode)
```
@@ -122,7 +122,7 @@ names it, the panel, **which driver each half of the session chose**, and every
`crash.log` is where a session the *system* killed leaves its only trace.
**Credentials are scrubbed and nothing identifying is collected.** Steam's logs are filtered line by
line on the way in — session tokens, machine-auth GUIDs, WebAPI keys, Guard codes and e-mail
line on the way in - session tokens, machine-auth GUIDs, WebAPI keys, Guard codes and e-mail
addresses are replaced, and a SteamID is masked to its last four digits so lines still correlate.
`loginusers.vdf`, `config.vdf` and the `ssfn` files are never copied. No serial number, no device or
advertising id, no account name, no network name. **A session folder is meant to be attached to a
@@ -130,14 +130,14 @@ report exactly as it is.**
---
## ⚠️ If Steam dies with nothing in the log
## If Steam dies with nothing in the log
That is usually not Steam. **Android 12 and later kill the extra processes an app starts for
itself** once there are more than a few, and a session is made of dozens — proot, gamescope,
itself** once there are more than a few, and a session is made of dozens - proot, gamescope,
Xwayland, the client and its helpers, Wine, FEX. Where that is left on, the OS ends the session and
no log of ours says why, because nothing in the session did it.
Some phones expose it in Developer options as a **"restrict child processes"** switch — turn it off.
Some phones expose it in Developer options as a **"restrict child processes"** switch - turn it off.
Otherwise, once per device:
```sh
@@ -151,7 +151,7 @@ disabled.
## Still true from 0.1
VAC-protected games report insecure. Games that ship only a Linux build will not start — install
VAC-protected games report insecure. Games that ship only a Linux build will not start - install
the Windows version instead. The desktop composites in software, and Firefox's child-process
sandboxes are off there. No Switch emulator. The emulator packages install but none has been run
with a game.
@@ -164,24 +164,24 @@ so plainly when it has not.
## Credits
- **maxjivi05 (Max)** — the gamescope runtime this is built on: the proot session, the session shim,
- **maxjivi05 (Max)** - the gamescope runtime this is built on: the proot session, the session shim,
the input interposer and the controller work, from WinNative. The `PROOT_NO_SECCOMP` fallback and
the phantom-process finding above are his too.
- **The412Banner** — the app, the Wayland compositor, the runtime plumbing and the Steam session.
- **Winlator (brunodev85)** — the PulseAudio-on-AAudio audio stack, the gamepad state model and the
- **The412Banner** - the app, the Wayland compositor, the runtime plumbing and the Steam session.
- **Winlator (brunodev85)** - the PulseAudio-on-AAudio audio stack, the gamepad state model and the
shape of a session's host-side components.
- **Vauzi (Vauzi-17/710)** — the Adreno 710/720/722 device entries the experimental driver carries.
- **Vauzi (Vauzi-17/710)** - the Adreno 710/720/722 device entries the experimental driver carries.
Frame generation: **Win-FG** is built in; **LSFG** uses the shader chain from *your own copy* of
Lossless Scaling, read on device and never redistributed, on groundwork from **lsfg-vk (PancakeTAS)**.
GPL-3.0. gamescope, Mesa, Turnip, Xwayland, labwc, LXQt, PulseAudio, proot and Arch Linux ARM are
their own authors'. **Not affiliated with Valve** — Steam, Proton and Steam Deck are Valve's, and no
their own authors'. **Not affiliated with Valve** - Steam, Proton and Steam Deck are Valve's, and no
Valve software is redistributed here: the client is fetched from Valve's own manifest on your device.
---
**APK** `SteamDeck-0.1.1.apk` — 15927028 bytes
**APK** `SteamDeck-0.1.1.apk` - 15927028 bytes
`sha256 db4b0604ca53c4441bb66d0764ca7ff98b2a9f7bdfc48e3d52c6024b3a4bf78c`
versionCode 2, built from `2570562` by [run 35634795441](https://github.com/The412Banner/SteamDeck/actions/runs/35634795441).
Signed with the AOSP test key (v1 + v2 + v3), so it installs over 0.1 and the r24–r34 test builds in place.
+17 -17
View File
@@ -1,14 +1,14 @@
# SteamDeck 0.1.2
**A fix release. 0.1.1 could hang the app when you left a session — that is fixed, and the two log
**A fix release. 0.1.1 could hang the app when you left a session - that is fixed, and the two log
lines that would have explained it in the first place are in.** Install it over 0.1.1; same key,
same runtime, nothing to re-download.
---
## 🩹 Leaving a session could hang the app
## Leaving a session could hang the app
0.1.1 collected a session's logs on the main thread as the session stopped — copying the
0.1.1 collected a session's logs on the main thread as the session stopped - copying the
compositor's log, scrubbing every one of the client's logs line by line, then waiting on Android's
crash buffer. On a desktop session that was around four and a half seconds of frozen app, and
Android ended it as not responding. The collecting now happens on its own thread.
@@ -17,26 +17,26 @@ This was introduced by 0.1.1's own logging, and it is the whole reason for this
`crash.log` was wrong twice over in 0.1.1 as well: it waited for output that arrives on another
thread, so it declared the buffer empty every time, and it printed a process id where an exit
status belonged. It now waits for the dump to finish and says which of three things happened —
status belonged. It now waits for the dump to finish and says which of three things happened -
could not start, did not finish, or genuinely nothing has crashed.
## 🔍 Two log lines that were missing
## Two log lines that were missing
Both came out of chasing a real report: a game that came back from the Steam menu as a small box in
the corner of the screen.
- **`changed its frame size: 1920x1080 -> …`** — a window that commits frames at a new size has
- **`changed its frame size: 1920x1080 -> …`** - a window that commits frames at a new size has
rebuilt its swapchain, and that is exactly what a game shrinking looks like from the compositor's
side. The size was previously nowhere in the logs and had to be guessed from a screenshot.
- **`renamed "Steam Big Picture Mode" -> "Flat-Out"`** — gamescope keeps one window and renames it
- **`renamed "Steam Big Picture Mode" -> "Flat-Out"`** - gamescope keeps one window and renames it
as the game takes the screen. That was silent, so the log showed a window *closed* under a name it
had never been logged as opening, which looked like a missing event and was really a rename.
## 📖 A README that matches the app
## A README that matches the app
The README had grown a section per feature in the order they were written, and the parts describing
the whole had fallen behind. The feature ledger now covers the drivers, audio, cores, session fixes
and logs, with an honest state against each — including, in plain words, the several that set what
and logs, with an honest state against each - including, in plain words, the several that set what
they claim but have never been measured on hardware. The architecture diagram shows the audio relay
and both Turnip slots. The session-log folder has a section of its own. And **Installing** now
mentions the one Android setting that decides whether a session stays up at all.
@@ -54,11 +54,11 @@ identifying collected · a path for Adreno 710 / 720 / 722 through imported driv
See the [0.1.1 notes](https://github.com/The412Banner/SteamDeck/releases/tag/0.1.1) for what each
of those does, and the README's ledger for what is proven versus merely wired.
## ⚠️ If the client dies with nothing in its log
## If the client dies with nothing in its log
That is usually not the client. **Android 12 and later kill the extra processes an app starts for
itself**, and a session is made of dozens. Some phones have a **"restrict child processes"** switch
in Developer options — turn it off. Otherwise, once per device:
in Developer options - turn it off. Otherwise, once per device:
```sh
adb shell settings put global settings_enable_monitor_phantom_procs false
@@ -69,21 +69,21 @@ says so when it is not disabled.
## Credits
- **maxjivi05 (Max)** — the gamescope runtime this is built on, from WinNative.
- **The412Banner** — the app, the Wayland compositor, the runtime plumbing and the Steam session.
- **Winlator (brunodev85)** — the audio stack, the gamepad model and the shape of a session.
- **Vauzi (Vauzi-17/710)** — the Adreno 710/720/722 device entries the experimental driver carries.
- **maxjivi05 (Max)** - the gamescope runtime this is built on, from WinNative.
- **The412Banner** - the app, the Wayland compositor, the runtime plumbing and the Steam session.
- **Winlator (brunodev85)** - the audio stack, the gamepad model and the shape of a session.
- **Vauzi (Vauzi-17/710)** - the Adreno 710/720/722 device entries the experimental driver carries.
Frame generation: **Win-FG** is built in; **LSFG** uses the shader chain from *your own copy* of
Lossless Scaling, read on device and never redistributed, on groundwork from **lsfg-vk (PancakeTAS)**.
GPL-3.0. gamescope, Mesa, Turnip, Xwayland, labwc, LXQt, PulseAudio, proot and Arch Linux ARM are
their own authors'. **Not affiliated with Valve** — Steam, Proton and Steam Deck are Valve's, and no
their own authors'. **Not affiliated with Valve** - Steam, Proton and Steam Deck are Valve's, and no
Valve software is redistributed here: the client is fetched from Valve's own manifest on your device.
---
**APK** `SteamDeck-0.1.2.apk` — 15927028 bytes
**APK** `SteamDeck-0.1.2.apk` - 15927028 bytes
`sha256 a761ba112fe97f4631d598f2a5d0b1898f9b81f4575771ded39c17b743f80825`
versionCode 3, built from `1f0292c` by [run 35674235857](https://github.com/The412Banner/SteamDeck/actions/runs/35674235857).
Signed with the AOSP test key (v1 + v2 + v3), so it installs over 0.1.1 in place.
+12 -12
View File
@@ -5,7 +5,7 @@ the truth.** Install it over 0.1.2; same key, same runtime, nothing to re-downlo
---
## 🌐 Settings → Internet works, and the header shows a connection
## Settings → Internet works, and the header shows a connection
The Steam client builds its network page and its connection indicator on NetworkManager, and looks
for one on the system bus as it starts. This runtime had neither, so the page stopped with
@@ -13,7 +13,7 @@ for one on the system bus as it starts. This runtime had neither, so the page st
downloads ran. A user on an Odin 2 reported exactly that in the first day.
The session now starts a small system bus and a **stand-in that answers for NetworkManager**. It
reports what is true and nothing more — one connection that is up while Android has a route out —
reports what is true and nothing more - one connection that is up while Android has a route out -
and refuses what it cannot do, since nothing in this runtime can scan for or join a network. The
session log says `network: system bus up, NetworkManager stand-in running` when it is working.
@@ -24,10 +24,10 @@ runtime gets this without a re-download; `dbus-daemon` and `python-gi` were alre
the only one of the three without it. Credit where it is due, and an apology to the Odin 2 reporter,
who was told it was cosmetic and unfixed when it had been fixed upstream for days.
## 🔍 Where the runtime stands against its sources
## Where the runtime stands against its sources
With this release the standalone's runtime scripts are level with Bannerlator's, and its sandbox
shims are byte-for-byte the same behaviour as Max's current branch — checked file by file today;
shims are byte-for-byte the same behaviour as Max's current branch - checked file by file today;
every difference is a deliberate rename or an attribution header. What remains on his side and not
here is a feature, not a fix: launching Epic games from the native client.
@@ -42,31 +42,31 @@ session fixes · `Download/steamdeck-env` · a folder of logs per session with c
a path for Adreno 710 / 720 / 722 · a README with an honest ledger of what is proven and what is
merely wired.
## ⚠️ If the client dies with nothing in its log
## If the client dies with nothing in its log
Android 12 and later kill the extra processes an app starts for itself, and a session is made of
dozens. Some phones have a **"restrict child processes"** switch in Developer options — turn it off.
dozens. Some phones have a **"restrict child processes"** switch in Developer options - turn it off.
Otherwise, once per device: `adb shell settings put global settings_enable_monitor_phantom_procs
false`. `device.txt` in every session folder records what your phone reports.
## Credits
- **maxjivi05 (Max)** — the gamescope runtime this is built on, the sandbox shims, and the
- **maxjivi05 (Max)** - the gamescope runtime this is built on, the sandbox shims, and the
NetworkManager stand-in in this release, from WinNative.
- **The412Banner** — the app, the Wayland compositor, the runtime plumbing and the Steam session.
- **Winlator (brunodev85)** — the audio stack, the gamepad model and the shape of a session.
- **Vauzi (Vauzi-17/710)** — the Adreno 710/720/722 device entries the experimental driver carries.
- **The412Banner** - the app, the Wayland compositor, the runtime plumbing and the Steam session.
- **Winlator (brunodev85)** - the audio stack, the gamepad model and the shape of a session.
- **Vauzi (Vauzi-17/710)** - the Adreno 710/720/722 device entries the experimental driver carries.
Frame generation: **Win-FG** is built in; **LSFG** uses the shader chain from *your own copy* of
Lossless Scaling, read on device and never redistributed, on groundwork from **lsfg-vk (PancakeTAS)**.
GPL-3.0. gamescope, Mesa, Turnip, Xwayland, labwc, LXQt, PulseAudio, proot and Arch Linux ARM are
their own authors'. **Not affiliated with Valve** — Steam, Proton and Steam Deck are Valve's, and no
their own authors'. **Not affiliated with Valve** - Steam, Proton and Steam Deck are Valve's, and no
Valve software is redistributed here: the client is fetched from Valve's own manifest on your device.
---
**APK** `SteamDeck-0.1.3.apk` — 15931221 bytes
**APK** `SteamDeck-0.1.3.apk` - 15931221 bytes
`sha256 3f85118755234c5d8b1fb59640f817485d8360db7c63c142072c6b1025606542`
versionCode 4, built from `3aa0162` by [run 35676349317](https://github.com/The412Banner/SteamDeck/actions/runs/35676349317).
Signed with the AOSP test key (v1 + v2 + v3), so it installs over 0.1.2 in place.
+19 -19
View File
@@ -6,19 +6,19 @@ re-download.
---
## 🗂️ The desktop can see your files — and a ROMs folder
## The desktop can see your files - and a ROMs folder
A file dialog inside the desktop (RPCS3's "Select Game Folder", say) showed only the runtime's own
tree. The phone's storage *was* mounted the whole time, at `/storage/emulated/0`; the dialogs
just could not show it — they list "Computer" from the mount table, where a proot bind never
just could not show it - they list "Computer" from the mount table, where a proot bind never
appears, and open in the home folder, where nothing pointed at the phone.
The home folder now carries two entries every session: **`Storage`**, all of internal storage, and
**`ROMs`**, the folder chosen with the new **ROMs folder** tile — anywhere on the device, an SD
**`ROMs`**, the folder chosen with the new **ROMs folder** tile - anywhere on the device, an SD
card included (it is a bind, not a link). Point an emulator at `/root/ROMs` once. Both are the
live folders: a save written next to a ROM lands on the phone.
## 📁 Files — Bannerlator's File Manager, whole
## Files - Bannerlator's File Manager, whole
The **Files** tile is Bannerlator's File Manager carried over as it is: grid and list, sort,
search, multi-select, copy / cut / paste with conflict handling and a cancellable progress bar,
@@ -28,9 +28,9 @@ the ROMs folder and imports a driver, in place of Android's document picker. Lef
they have no meaning without a Wine container: run, add to shortcuts, the C: / Z: drives and the
archive unpacker.
## ⚙️ A cog beside Play and beside Desktop
## A cog beside Play and beside Desktop
Everything that only matters for one mode moved behind that mode's cog — a settings window with
Everything that only matters for one mode moved behind that mode's cog - a settings window with
a rail of sections: **Display** (resolution up to 1080p by default, 900p, 720p or the panel's own;
the shape), **HDR**, the **runtime driver** for that mode, the **display driver**, **touch**, and
for Steam the on-screen controls and audio, for the desktop its renderer. The Graphics drivers and
@@ -42,12 +42,12 @@ Performance · ROMs folder · Files · Session logs.
HDR10. On, the compositor offers `wp_color_manager_v1` with BT.2020 + PQ and 10-bit buffers,
gamescope starts with `--hdr-enabled` and games get `DXVK_HDR=1`. The compositor decides this once,
when it starts, so like the display driver it applies after the app is fully closed and opened
again. ⚠️ Wired end to end; not yet seen on a device from this app.
again. Wired end to end; not yet seen on a device from this app.
## 🩹 Logs that survive a crash, and a session that always starts
## Logs that survive a crash, and a session that always starts
A session's folder used to be finished only at a clean stop; an app crash or an Android kill left
it half-written — a user saw the toast name a log that was not there. The folder is now finished
it half-written - a user saw the toast name a log that was not there. The folder is now finished
three ways: the ordinary stop; the app's own crash handler, which writes `crash-app.txt` and
finishes the folder before the process dies; and a sweep at the next app start for any folder
without its `.complete` marker (a native crash, a kill), which gets `ended-without-teardown.txt`
@@ -58,9 +58,9 @@ The same user had to force-stop the app before every launch or nothing started:
proot, gamescope and Steam outlive it, holding the rootfs, the GPU and Steam's lock. Every session
start now kills whatever of ours is still running from before, and `app.log` lists it.
## 🎮 Steam menu from the drawer
## Steam menu from the drawer
The in-session drawer has **Steam menu ◉** in Steam mode — the Guide button, for a device whose
The in-session drawer has **Steam menu ◉** in Steam mode - the Guide button, for a device whose
own home button belongs to Android and a pad the client hides the on-screen controls for. (There is
no Quick Access chord on a non-Deck controller that I could confirm, so none is offered.)
@@ -73,32 +73,32 @@ restored and a competing client asked to stop · DirectAudio and the microphone
core masks · four session fixes · a folder of logs per session with credentials scrubbed · a path
for Adreno 710 / 720 / 722.
## ⚠️ If the client dies with nothing in its log
## If the client dies with nothing in its log
Android 12 and later kill the extra processes an app starts for itself, and a session is made of
dozens. Some phones have a **"restrict child processes"** switch in Developer options — turn it off.
dozens. Some phones have a **"restrict child processes"** switch in Developer options - turn it off.
Otherwise, once per device: `adb shell settings put global settings_enable_monitor_phantom_procs
false`. `device.txt` in every session folder records what your phone reports.
## Credits
- **maxjivi05 (Max)** — the gamescope runtime this is built on, the sandbox shims, the controller
- **maxjivi05 (Max)** - the gamescope runtime this is built on, the sandbox shims, the controller
work and the NetworkManager stand-in, from WinNative.
- **The412Banner** — the app, the Wayland compositor, the runtime plumbing, the Steam session and
- **The412Banner** - the app, the Wayland compositor, the runtime plumbing, the Steam session and
the File Manager (from Bannerlator).
- **Winlator (brunodev85)** — the audio stack, the gamepad model and the shape of a session.
- **Vauzi (Vauzi-17/710)** — the Adreno 710/720/722 device entries the experimental driver carries.
- **Winlator (brunodev85)** - the audio stack, the gamepad model and the shape of a session.
- **Vauzi (Vauzi-17/710)** - the Adreno 710/720/722 device entries the experimental driver carries.
Frame generation: **Win-FG** is built in; **LSFG** uses the shader chain from *your own copy* of
Lossless Scaling, read on device and never redistributed, on groundwork from **lsfg-vk (PancakeTAS)**.
GPL-3.0. gamescope, Mesa, Turnip, Xwayland, labwc, LXQt, PulseAudio, proot and Arch Linux ARM are
their own authors'. **Not affiliated with Valve** — Steam, Proton and Steam Deck are Valve's, and no
their own authors'. **Not affiliated with Valve** - Steam, Proton and Steam Deck are Valve's, and no
Valve software is redistributed here: the client is fetched from Valve's own manifest on your device.
---
**APK** `SteamDeck-0.1.4.apk` — 20957823 bytes
**APK** `SteamDeck-0.1.4.apk` - 20957823 bytes
`sha256 4b53ce6a937f2b51a5b9d2639ea32b816993e4f7b2dc33dd0f3198b81f21e9d2`
versionCode 5, built from `8e58e8e` by [run 35682844106](https://github.com/The412Banner/SteamDeck/actions/runs/35682844106).
Signed with the AOSP test key (v1 + v2 + v3), so it installs over 0.1.3 in place.
+28 -28
View File
@@ -6,10 +6,10 @@ hands.** Install it over 0.1.4; same key, same runtime, nothing to re-download.
---
## 🧭 The front end
## The front end
The main screen is a rail and a pane. The rail lists what can be launched — **Steam** and its
installed games, **Desktop** and its emulators and *their* games — and **Setup** under them, every
The main screen is a rail and a pane. The rail lists what can be launched - **Steam** and its
installed games, **Desktop** and its emulators and *their* games - and **Setup** under them, every
category folded when the app opens so the rail is three headers and their counts. The pane shows
the chosen thing with its launch button, its art, and a shelf of the rest. A session left in the
background is the first thing on the rail, with a pulse, and tapping it goes back in.
@@ -18,16 +18,16 @@ It moves: the selection is one pill that glides between rows, lists unfold with
staggering in, a page change cascades the new page in row by row over a blurred wash of its own
art, tiles lift and shine under the pad, the launch button sweeps a sheen and squashes on press,
and the session rises over the front end and sinks back. Every duration follows the system's
animator scale, so "no animations" in developer options snaps all of it. ✅ Seen on a Pocket FIT
animator scale, so "no animations" in developer options snaps all of it. Seen on a Pocket FIT
and a Fold.
**Emulators launch from the rail, under gamescope, with their games.** The ROMs folder is scanned
per system (one level of subfolders, PS3 game folders, RPCS3's own installed games by their
PARAM.SFO with their icons), and each game launches straight in. ✅ God of War II HD booted in RPCS3
from the rail, ~40 fps on the FIT — the first emulator game from the app. The desktop's own Steam
launchers hand a game to the app's Steam session (⚠️ the hand-off itself is not yet proven).
PARAM.SFO with their icons), and each game launches straight in. God of War II HD booted in RPCS3
from the rail, ~40 fps on the FIT - the first emulator game from the app. The desktop's own Steam
launchers hand a game to the app's Steam session ( the hand-off itself is not yet proven).
## 🎛️ Settings without a pop-up
## Settings without a pop-up
The cog's window and the Performance dialog are pages in the pane: one row per setting, its value
in a chip, and a small faded menu that opens right under the chip. One menu at a time; the page
@@ -39,17 +39,17 @@ The **session drawer** is the same rows and menus, sliding in from the right: No
generation, touch, the virtual pad, keyboard, the client's menu) and Next session (display shape,
FEX preset, compatibility tools), with Send to background and Stop at the end.
## 🎨 The icon, and themes in its colours
## The icon, and themes in its colours
A new launcher icon (Kurt's), and the same mark in the rail and on the loading screen. Three
themes under Setup › Theme, in the icon's black, white and blue: **Paper on black** (the default —
themes under Setup › Theme, in the icon's black, white and blue: **Paper on black** (the default -
white is the primary, the blue is the small signal for rules, rings and dots), **Icon blue**, and
**Electric navy**. A change applies at once.
## ⚡ Run as a game, and the client's frames back
## Run as a game, and the client's frames back
- The app is declared a **game** to Android, with a game-mode config that welcomes Performance
mode and refuses the OS-side frame-rate cap and resolution downscaling — the interventions that
mode and refuses the OS-side frame-rate cap and resolution downscaling - the interventions that
make a regular flagship's Big Picture crawl while a gaming phone's does not. The session window
asks for **sustained performance mode**, the panel's **fastest display mode** at its size, tells
GameManager it is in gameplay, and opens an **ADPF hint session** over the compositor thread fed
@@ -58,7 +58,7 @@ white is the primary, the blue is the small signal for rules, rings and dots), *
the app can read `/proc/bus/pci`, then dies on the devices file inside it, which Android denies;
Chromium loads libpci in its GPU process, so after a few tries CEF drew the whole interface on
the CPU. An empty file bound over that path at session start answers the scan truthfully.
(WinNative, maxjivi05: 44 → 85 fps in the Big Picture library on a OnePlus 15.) ✅ Big Picture at
(WinNative, maxjivi05: 44 → 85 fps in the Big Picture library on a OnePlus 15.) Big Picture at
117–118 fps on both panels of a 120 Hz Fold, Adreno 830.
- **Client interface** switches on the Performance page: threaded GL, lazy descriptors and no GL
error checks, all on by default; **Steam Deck mode** (`-steamdeck -steamos3`) off by default,
@@ -70,20 +70,20 @@ white is the primary, the blue is the small signal for rules, rings and dots), *
- The guest gets the device's **time zone** (the client's clock and logs were UTC).
- A device without an Adreno GPU is told **before** the runtime download that a session would be
sound over a black screen.
- The app's own libraries are **16 KB-aligned** (Android 15 devices). ⚠️ Six prebuilt PulseAudio
- The app's own libraries are **16 KB-aligned** (Android 15 devices). Six prebuilt PulseAudio
libraries are still 4 KB-only and need a rebuild.
## 🕹️ On-screen controls: sticks, and the bars
## On-screen controls: sticks, and the bars
A **left and a right stick** beside the d-pad, a base and a knob that follows the finger, writing
the pad's thumb axes the way a physical stick does. The controls **take the bars** beside or under
the picture when the panel letterboxes it — a Fold's side bars, a square panel's bottom band —
and only overlay the picture when there are none wide enough. ⚠️ Not yet tried in a game.
the picture when the panel letterboxes it - a Fold's side bars, a square panel's bottom band -
and only overlay the picture when there are none wide enough. Not yet tried in a game.
## 🤝 From Kurt (xXJSONDeruloXx)
## From Kurt (xXJSONDeruloXx)
- The **hardware Back button** reaches the app and opens the drawer instead of going into Steam
as Select. ✅ Verified on an AYN Thor.
as Select. Verified on an AYN Thor.
- The **launcher icon**.
- **Local build and deploy helpers**: a Docker build for the preload libraries, a local release
build with signing, an ADB install helper.
@@ -92,7 +92,7 @@ Every pull request against main now builds by itself and gets one comment kept c
or the conflicting hunks, and a failed build's compiler errors. The README lists the contributors
and a ledger of their pull requests that a workflow keeps.
## 🔧 Smaller
## Smaller
The file manager and the picker stay in landscape · a session's log folder goes with it when it
ends and the next session gets its own · a replaced session's exit no longer ends the one that
@@ -101,32 +101,32 @@ files are ignored.
---
## ⚠️ Carried over — still open
## Carried over - still open
The desktop → Steam hand-off and the sticks are untested on a device. A stick click is not yet
offered. VAC-protected games report insecure. Games that ship only a Linux build won't start.
## Credits
- **maxjivi05 (Max)** — the gamescope runtime this is built on, the sandbox shims, the controller
- **maxjivi05 (Max)** - the gamescope runtime this is built on, the sandbox shims, the controller
work, the NetworkManager stand-in and the libpci fix, from WinNative.
- **Kurt Himebauch (xXJSONDeruloXx)** — the launcher icon, the hardware Back fix, the local build
- **Kurt Himebauch (xXJSONDeruloXx)** - the launcher icon, the hardware Back fix, the local build
helpers.
- **The412Banner** — the app, the Wayland compositor, the runtime plumbing, the Steam session, the
- **The412Banner** - the app, the Wayland compositor, the runtime plumbing, the Steam session, the
front end and the File Manager (from Bannerlator).
- **Winlator (brunodev85)** — the audio stack, the gamepad model and the shape of a session.
- **Vauzi (Vauzi-17/710)** — the Adreno 710/720/722 device entries the experimental driver carries.
- **Winlator (brunodev85)** - the audio stack, the gamepad model and the shape of a session.
- **Vauzi (Vauzi-17/710)** - the Adreno 710/720/722 device entries the experimental driver carries.
Frame generation: **Win-FG** is built in; **LSFG** uses the shader chain from *your own copy* of
Lossless Scaling, read on device and never redistributed, on groundwork from **lsfg-vk (PancakeTAS)**.
GPL-3.0. gamescope, Mesa, Turnip, Xwayland, labwc, LXQt, PulseAudio, proot and Arch Linux ARM are
their own authors'. **Not affiliated with Valve** — Steam, Proton and Steam Deck are Valve's, and no
their own authors'. **Not affiliated with Valve** - Steam, Proton and Steam Deck are Valve's, and no
Valve software is redistributed here: the client is fetched from Valve's own manifest on your device.
---
**APK** `SteamDeck-0.1.5.apk` — 21093959 bytes
**APK** `SteamDeck-0.1.5.apk` - 21093959 bytes
`sha256 85b4295431ddea6f35025959864f3fbb47ad238693e146405ac0fe6ae87504f1`
versionCode 6, built from `d2f4a84` by [run 35813465422](https://github.com/The412Banner/SteamDeck/actions/runs/35813465422).
Signed with the AOSP test key (v1 + v2 + v3), so it installs over 0.1.4 in place.