mirror of
https://github.com/Droid-Deck/DroidDeck.git
synced 2026-11-20 05:16:01 +00:00
chore: simplify UI copy and repo text
This commit is contained in:
1 parent
a1e204c117
commit
02c159c5fd
96 files changed
+703
-1435
No files matched your search
+17
-17
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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.
|
||||
Reference in new issue
Block a user