Repository navigation
xfsr-run 0.5.0
Changelog
All notable changes to xfsr / xfsr-run are documented here.
Format based on Keep a Changelog.
Versioning follows Semantic Versioning.
0.5.0 — 2026-10-25
Added
- One-way offload skips MangoHud and pins the xfsr overlay with FPS, CPU%, GPU%
and temperatures (sysfs). Native Vulkan may present on the iGPU; Zink stays on
round-trip (NVIDIA calls present with the app swapchain — opaque handles SIGSEGV) - Uniform render size:
window / scalefor Vulkan, DXVK, and Zink (windowed and
fullscreen). No special-case 1080p table that ignored smaller windows - Docs: 32-bit Proton titles (CoD4) need
PROTON_USE_WOW64=1so 64-bit DXVK loads
the layer; borderless + lower in-game res for D3D9 FSR
Fixed
- CoD4 / D3D9: do not return proxy images smaller than CreateSwapchain extent
(DEVICE_LOST after first present); identity + hint when the game ignores caps - Caps advertise
currentExtent=UINT_MAX+max=renderfor DXVK; Zink uses a
concretecurrentExtent=render(UINT_MAX made Mesa OOM / stay identity) - Hook
vkGetPhysicalDeviceSurfaceCapabilities2KHR(DXVK prefers this) - FSR proxy + caps shrink on integrated GPUs (
discrete=0, e.g. Vega) - Identity / exclusive-fullscreen F10 overlay (CoD4): adopt app device, preserve
PRESENT_SRCframe contents, reset overlay sync on DestroyDevice - Zink X11: publish
XFSR_GL_REMAPso the shim remaps viewports when EGL still
reports the window size (zoomed bottom-left crop) - Skip futile shrink-kick when D3D9 already ignored the caps clamp
Changed
--offloadwithout--no-one-wayprefers one-way and does not load MangoHudxfsr-run --one-way/ offload docs: round-trip is--no-one-way; Zink offload
is always round-trip on NVIDIA hybrids
0.4.0 — 2026-10-25
Added
- In-game controls (default on): F1 preset, F2 RCAS, F3 FSR,
F4 offload, F5 one-way, F10 pin overlay; toast on change.
Disable withXFSR_HUD=0/--no-controls - Hotkeys via X11 and/or evdev (
/dev/input);XFSR_HUD_MOD=1requires Shift - Control file
$XDG_RUNTIME_DIR/xfsr-control(orXFSR_CONTROL):preset,
rcas,fsr,offload,one-way,overlay,status - F4 live offload: same-GPU ↔ round-trip without restart (keeps dGPU WSI)
--overlay/XFSR_OVERLAY=1— pin status strip at launch (Proton often eats F10)
Fixed
- SIGSEGV on rapid swapchain recreate (glmark2 scenes / preset hotkey): drain present
fences before freeing proxy; keep status overlay on the device, not the swapchain - Clearer log when exclusive fullscreen locks size (
app == display) so FSR cannot
shrink — use borderless windowed - Live F4 offload: always inject host/dma-buf device extensions on discrete CreateDevice
so mid-run transfer init does not call null ICD entry points - Identity-path F10 overlay + fence hang; bench recreates on
OUT_OF_DATE(F1) - Ambient
XFSR_IGPU_PRESENT=forceno longer overridesXFSR_OFFLOAD=0 - F3 FSR-on after blit / live F4 with FSR off: always allocate FSR outputs so
fsr.recorddoes not SIGSEGV - Bench
--fullscreen/--windowedfor VK and GL loaders xfsr-run/xfsr-bench: prefer X11 for native Vulkan FSR whenDISPLAYis
set (WaylandUINT_MAXextent skipped shrink → flat FPS vs baseline)xfsr-bench: full matrix — X11+Wayland × windowed+fullscreen, all presets,
offload±RCAS, VK+GL (XFSR_BENCH_QUICK=1/XFSR_BENCH_X11_ONLY=1/
XFSR_BENCH_WAYLAND_ONLY=1to narrow)- Wayland Vulkan FSR: seed window size from the first swapchain (ICD
currentExtentisUINT_MAX), kick oneOUT_OF_DATE, clamp caps max to
render size so the recreate builds a real proxy (was identity @ full res) - Wayland Zink/GL FSR: shim shrinks
wl_egl_windowto render size (Zink
ignores Vulkan caps); layer treats matching create as hint-honored proxy - Offload+MangoHud SIGSEGV on Mesa one-way (opaque WSI): refuse one-way when
MangoHud is active; skip--offloadwhen the app is already on the iGPU
(--igpu/ Zink-on-Vega)
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.1...v0.5.0