You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit b0b9c5d
Browse filesBrowse the repository at this point in the historyBrowse files
**From source:**[download the source ZIP](https://github.com/ztwzeroo/DLSS5-FrameGen/archive/refs/heads/main.zip), extract it, and open PowerShell in the extracted folder. Then run:
@@ -137,11 +137,11 @@ Use `py -m dlss_combo --help` or `py -m dlss_combo install --help` for the full
137
137
138
138
## Linux / Steam Proton
139
139
140
-
Windows games running through Proton are still Windows processes, so the frame-generation layer is expected to apply the same way — **not yet verified end-to-end by this project on Linux**. Grab `dlss-combo-<version>-linux-x64.zip`, then point the CLI at the folder containing the game's **rendering EXE**. The reliable way to find it is Steam → *Manage* → **Browse local files** (for Proton installs that lands you inside the prefix's `drive_c`; don't assume a fixed prefix layout — always locate the actual EXE folder):
140
+
Windows games running through Proton are still Windows processes, so the frame-generation layer is expected to apply the same way — **not yet verified end-to-end by this project on Linux**. Grab `dlss-combo-<version>-linux-x64.zip`, then point the CLI at the folder containing the game's **rendering EXE**. The reliable way to find it is Steam → *Manage* → **Browse local files** (Proton installs often live under the prefix's `drive_c`, but the layout is not guaranteed — the Browse-local-files location is the reliable reference):
> These options are community convention (the route [DLSS Unlocked](https://github.com/ShyVortex/DLSS-Unlocked) documents), **not verified with this toolkit** — check your Proton version's behavior against [Valve's config notes](https://github.com/ValveSoftware/Proton#runtime-config-options) before relying on them. Substitute the actual proxy name (`winmm`/`dbghelp`/…) if it is not `version.dll`.
155
155
156
156
- The image layer (DLSS5-Swapper) is a Windows GUI app; running it via Wine is upstream-experimental — on Linux, validate the frame-generation layer first.
157
-
-**Linux binaries**: built on Ubuntu 22.04; the whole-binary GLIBC symbol floor is measured per build (current: 2.14, in each zip's `build-info.txt`). Other distros are unverified — glibc >= 2.17 (manylinux2014-era) is the conservative recommendation, or run from source.
157
+
-**Linux binaries require glibc >= 2.35** — the real floor is measured per build by extracting the embedded ELF libraries from the PyInstaller archive (an outer-file string scan under-reports it; the current build's floor is in each zip's `build-info.txt`). Other distros are unverified; to target older systems, run from source.
Copy file name to clipboardExpand all lines: docs/STATUS.md
+7-3Lines changed: 7 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,17 +4,21 @@
4
4
5
5
**This is an experimental source preview, not a stable installer.** It is intended for contributors and experienced modders working on disposable directories or independently backed-up game copies.
6
6
7
-
This page describes the tree after the 2026-09-20 review fixes landed (see [the review](2026-09-20-project-review.md) and [repro script](2026-09-20-repro.py); all nine reproduced behaviors now assert fixed). In-game behavior remains unverified.
7
+
This page describes the tree after the 2026-09-20 review fixes landed (see [the review](reviews/2026-09-20-project-review.md) and [repro script](reviews/2026-09-20-repro.py), plus the [v0.1.1 independent review](reviews/2026-09-20-v0.1.1-independent-review.md) and its [repro](reviews/2026-09-20-v0.1.1-independent-repro.py) — all seventeen reproduced behaviors now assert fixed). In-game behavior remains unverified.
8
8
9
9
## Evidence so far
10
10
11
-
-107 offline Python tests pass; CI runs them on Windows/Linux/macOS on every push.
11
+
-122 offline Python tests pass; CI runs them on Windows/Linux/macOS on every push.
12
12
- A Python wheel builds, and an isolated CLI version check succeeds.
13
13
- The nine reproduced problem behaviors from the 2026-09-20 review are fixed and covered by regression tests; the repro script reports all nine as fixed.
14
14
- No Windows/NVIDIA game session, image-quality comparison, latency test or FPS benchmark has been validated by this project.
15
15
16
16
Upstream support claims and configuration limits are not a substitute for testing the combined setup. A `4x` or `6x` setting is a frame-generation ceiling, not a measured performance improvement.
17
17
18
+
## Fixed in v0.1.2 (independent v0.1.1 review, R1–R7)
19
+
20
+
First-install rollback now restores the user's original INI at every failure point (DLL/manifest/backup write); uninstall never overwrites any existing file or symlink when saving a restore copy (exclusive `O_CREAT|O_EXCL` with numbered fallbacks); temp files are random and exclusively created, and only paths registered by the current operation are cleaned; a missing or corrupted pre-existing backup aborts uninstall before any deletion; doctor treats the newest log as the diagnostic scope and labels older route events as historical; interrupted kit refreshes stage and switch atomically, leaving the previous kit usable. Evidence: `tests/test_review4.py` and the flipped independent repro script (all eight scenarios fixed). The glibc floor is now measured from the CArchive-extracted embedded ELF libraries (see the release workflow).
21
+
18
22
## Known issues
19
23
20
24
### File deletion and ownership — FIXED 2026-09-20
@@ -55,6 +59,6 @@ The project targets Windows 10/11 x64, RTX 20/30, and D3D12 games with native DL
55
59
56
60
Prioritize bounded filesystem operations, ownership checks, original-file restoration, strict checksums, and failure recovery. Regression tests should assert that unrelated files remain byte-for-byte unchanged.
57
61
58
-
The [detailed audit (Chinese)](reviews/2026-09-20-project-review.md) includes file locations, reproduction results and acceptance criteria. The [reproduction script](reviews/2026-09-20-repro.py) uses temporary files and does not launch real binaries. **Its successful completion means the known bugs are reproducible, not that the tool is safe.**
62
+
The [detailed audit (Chinese)](reviews/2026-09-20-project-review.md) includes file locations, reproduction results and acceptance criteria. The [reproduction script](reviews/2026-09-20-repro.py) uses temporary files and does not launch real binaries. **Since v0.1.2 both scripts assert the FIXED behavior: successful completion means the reproduced defects no longer trigger — a specific regression guard, not proof that all file-safety concerns are resolved.**
59
63
60
64
For real game reports, use the [game-test form](https://github.com/ztwzeroo/DLSS5-FrameGen/issues/new?template=game-test.yml). Include unsuccessful attempts and clearly label what you did and did not measure.
0 commit comments