Repository navigation
xfsr-run 0.3.1
Changelog
All notable changes to xfsr / xfsr-run are documented here.
Format based on Keep a Changelog.
Versioning follows Semantic Versioning.
0.3.1 — 2026-10-24
Fixed
glmark2-waylandpostage-stamp: don’t caps-shrink fromDISPLAY_EXTENTalone;
skip GL viewport remap when the EGL drawable is still window-sized (Wayland Zink
identity path). X11glmark2keeps FSR via caps-shrink.
0.3.0 — 2026-10-24
Fixed
- Zink/glmark2 windowed zoom-crop: GL shim remaps with window/scale, not the
1080pXFSR_RENDER_*hint (800×600 was forced to 1280×720 / 768×432 → bottom-left
blow-up).glfwGetFramebufferSizeuses the same rule.
0.2.4 — 2026-10-24
Added
xfsr-run --one-way/--no-one-way(setsXFSR_IGPU_PRESENT;--one-wayimplies
--offload)
Fixed
- NVIDIA
--one-way: opaque WSI SIGSEGV on swapchain recreate / MangoHud — ignore
one-way on NVIDIA unlessXFSR_IGPU_PRESENT=force glmark2-wayland: keepWAYLAND_DISPLAYfor*-waylandbinaries (was cleared for
Zink and failed canvas init)- Zink windowed postage-stamp: don’t treat
DISPLAY_EXTENThint as the real window;
only caps-honor when app extent matches expected render size; tighten GL shim remap;
caps-shrink for Zink on iGPU too
Changed
- Document offload knobs (
XFSR_IGPU_PRESENT,XFSR_DMABUF) in README
0.2.3 — 2026-10-24
Added
- Offload present policy: try one-way iGPU present on Mesa dGPUs; auto-fallback
to round-trip (dGPU WSI) on create/present failure;XFSR_IGPU_PRESENT=0|1 FrameTransferbackends: dma-buf → shared-host → memcpy (pipelined for
dma-buf/host);XFSR_DMABUF=0|1override. NVIDIA↔Mesa skips dma-buf by default
(probes OK then DEVICE_LOSTs on RADV)
Fixed
- Native Vulkan
DEVICE_LOSTafter first present: caps-shrink so apps honor render
extent (unsafe force-scale alone created FB > image); disable FSR direct-to-WSI
STORAGE path on NVIDIA - Zink+
--offloadSIGSEGV with MangoHud: serialize proxy present vs swapchain
recreate (g_proxyLife) before tearing downFrameTransfer - GL postage-stamp / missing HUD under Zink+FSR: remap viewports to render size;
use Vulkan MangoHud (GL HUD was painted on a surface XFSR never samples) xfsr-bench.sh: MangoHud on all cases; force--zinkfor GL; build with
XFSR_BUILD_BENCH=ON- Bench
xfsr_load_vkY-flip vs OpenGL (Vulkan NDC)
Changed
- Caps-shrink enabled for native Vulkan by default (
XFSR_CAPS_SHRINK=0for Source2) - NVIDIA hybrids:
--offloaddefaults to round-trip (one-way opt-in via
XFSR_IGPU_PRESENT=1)
0.2.0 — 2026-10-24
Added
- OpenGL via Zink FSR (same-GPU and
--offload) withlibxfsr_gl_shim.so --preset ultra(2.5× / 768×432 @ 1080p) for weak GPUs- Async Zink
--offloadround-trip (transferPipelineboth ways)
Fixed
- GL viewport corner crop: export shim symbols, wrap
glX/egl/glfwGetProcAddress, interposedlsym(glmark2) - Zink + NVIDIA
--offloadSIGSEGV (keep dGPU WSI; FSR on iGPU via host round-trip) - CI release: use Ubuntu 24.04 so
glslcis available - Steam Vulkan/Proton titles (CS2, DXVK): Zink no longer on by default (was clearing
WAYLAND_DISPLAYand forcingGALLIUM_DRIVER=zink) - CS2 stuck on logo: stop caps-shrinking native Vulkan (recreate storm); skip
QueueWaitIdleon swapchain destroy; don’t inherit ambientXFSR_OUTPUT_*
Changed
- Gate
[xfsr] presented N framesonXFSR_VERBOSE - Layer prefers
XFSR_SCALEfromxfsr-runwhen set xfsr-run:--zinkis opt-in; Vulkan/Proton use the layer with no Zink env
0.1.0 — 2026-10-24
Added
- Project renamed to xfsr (layer
VK_LAYER_XFSR, envXFSR_*; legacyCROSSVULKAN_*still accepted) xfsr-runVulkan layer installer and Steam-friendly launcher- Same-GPU FSR1 upscale (default) and optional
--offloaddual-GPU present - Presets: quality / balanced / performance
--no-rcas(EASU-only) for higher FPS- Wayland display-extent hint (
--output/XFSR_DISPLAY_EXTENT) xfsr-bench.sh/xfsr_load_vk/xfsr_load_gluncapped load tools- One-line install script and GitHub Actions release packages
Fixed
- Postage-stamp on Wayland from invented
app × scaledisplay sizes - Dual-GPU
SURFACE_LOST/ earlyOUT_OF_DATE(opaque app handle + iGPU-only window WSI) - Caps-shrink vs Zink EGL drawable mismatch
Full Changelog: v0.3.0...v0.3.1