Repository navigation
xfsr-run 0.6.0
Changelog
All notable changes to xfsr / xfsr-run are documented here.
Format based on Keep a Changelog.
Versioning follows Semantic Versioning.
[Unreleased]
0.6.0 — 2026-10-26
Added
- Sampler mip LOD bias:
vkCreateSamplerinjects scale-aware negativemipLodBias
(-log2(scale)by default) so low internal res still samples sharp mips.
XFSR_LOD_BIAS=auto|off|<float>,XFSR_LOD_BIAS_OFFSET,--lod-bias,
--lod-bias-offset. Skips compare/shadow and single-mip samplers - EdgePass Di Zenzo: RGB structure tensor (per-channel Sobel outer products) with
3×3 box-smoothed shared tile, ETF anisotropy-weighted along-edge mix, fused
single-pass CAS (quality + perf paths) xfsr-run --any/--universal— gamescope nest that forces the game window to
the preset render size (upscales titles that keep the Vulkan layer on identity).
NVIDIA hybrids auto-use--backend sdlinstead of disabling the nest--gamescope-backend/XFSR_GAMESCOPE_BACKEND; profiles for CS2 / CoD4 / Village
defaultgamescope=1- Gamescope nest:
ENABLE_GAMESCOPE_WSI=1on AMD/Deck (XWayland bypass). On
NVIDIA default WSI off (Valve#1182 black/white screen; DXVK uses nested
X11/xcb instead). Override withXFSR_GAMESCOPE_WSI=0|1. Never set
PROTON_ENABLE_WAYLANDon NVIDIA; Wayland nest viaXFSR_GAMESCOPE_WAYLAND=1 - Nest HUD: do not enable
--mangoappon NVIDIA (EGL/GLFW crash-loop); opt-in
viaXFSR_GAMESCOPE_MANGOAPP=1 - Nest present on Plasma Wayland: SDL host with
SDL_VIDEODRIVER=x11(real
KWin Xwayland window).xfsr-gamescope-focussets ChimeraOS-style
GAMESCOPECTRL_BASELAYER_*so the nest composites the game (desktop Steam
leavesFOCUSED_APP_GFXempty → black).-eonly with
XFSR_GAMESCOPE_STEAM=1. No default-f - EdgePass quality pack: shared-mem source tile, edge-stopping cubic, anti-ring,
post-scale CAS, linear/sRGB, scale-aware sharpen;XFSR_EDGE_MODE=perf/--edge-mode perflite path; liveedge_sharp/--edge-sharpness; F2 toggles edge quality↔perf
when onedge; STORAGE→swapchain direct on non-NVIDIA present (hybrid iGPU) - EdgePass v2: padded display-space CAS (no 16×16 tile seams), luma-only cubic +
chroma bilinear, Sobel/structure-tensor along-edge mix, linear anti-ring xfsr_load_vk/xfsr_load_gldefault to run until Ctrl+C / Esc (keep--secondsfor benches)
Fixed
--gamescope-fs/ profilegamescope_fs=1/XFSR_GAMESCOPE_FS=1— gamescope
host fullscreen (-f) while the game stays at nest-w/-h(CoD4 windowed fix)- Gamescope nest floor 640×480 (CoD4 / D3D9 reject ultra 768×432)
- NVIDIA nest: skip gamescope by default (host stays black); use layer instead;
XFSR_GAMESCOPE_FORCE=1to allow nest anyway - Proxy acquire: finite
appImgFencewait + re-signal on timeout (Village froze
afterfirst present okon UINT64_MAX). Village profile: blit + caps-shrink --gamescope: no xfsr overlay (layer off) — MangoHud on the game; Zink without
xfsr shim; match load-app window to nest size; drop nested--debug-hud/
--force-windows-fullscreen(caused blink/swapchain thrash); warn that
--hybrid/--offloadare ignored- Docs: prefer
xfsr-run --anyfor titles that stay identity; NVIDIA nest uses
SDL backend instead of disabling gamescope
0.5.0 — 2026-10-25
Added
--gamescope/ profilegamescope=1— nest at preset render size, upscale with
gamescope-F(from--upscaleror--gamescope-filter). Unblocks CS2/Source 2
where the Vulkan layer stays identity. Layer off unlessXFSR_GAMESCOPE_LAYER=1--upscaler edge/EdgePass— heavier edge-aware spatial upscaler (F3: fsr1→blit→nis→edge)--hybrid/XFSR_HYBRID=1— dGPU low-res → iGPUedge+ one-way present (no
full-res back-haul). Statusmode=hybrid-edge. If one-way WSI fails, same-GPU
edgefallback (refuses silent round-trip). Skips MangoHud; pins xfsr overlay- ROADMAP.md — adaptive FSR, temporal/NIS, profiles, dma-buf, auto-tune
- Per-game profiles:
~/.config/xfsr/profiles.conf(from
share/xfsr/profiles.example.conf); match Steam AppID / exe / substring;
--no-profile,--caps-shrink/--no-caps-shrink scripts/xfsr-auto-tune— short preset×RCAS matrix onxfsr_load_vk; prints a
profile section;--applywrites~/.config/xfsr/profiles.conf; scores
avg+p1_fps(1% lows) and frame-time stdev- Adaptive FSR:
--adaptive/XFSR_ADAPTIVE=1+--target-fps— continuous float
scale (not only the preset ladder) with pixel hysteresis before recreate
(control:adaptive,target_fps,scale) --upscaler fsr1|blit|nis/XFSR_UPSCALER— NIS-style edge-directional spatial
upscaler (NisPass)xfsr-run --check— shortxfsr_load_vksmoke; reads
$XDG_RUNTIME_DIR/xfsr-status(mode=proxy|proxy-nis|proxy-edge|hybrid-edge|identity)- Overlay pins by default when MangoHud is not requested
- Bench lines include
p1_fps=andft_stdev_ms= - 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
- Zink on NVIDIA+AMD hybrids: put NVIDIA first in
VK_DRIVER_FILES(keep Mesa
Gallium/Zink — do not set__GLX_VENDOR_LIBRARY_NAME=nvidia, which bypassed
Zink and killed the overlay); inject--ozone-platform=x11for Chrome when
Wayland is cleared; warn on browser + Wayland - NIS + live F4 offload: do not record iGPU
NisPassinto the dGPU present
command buffer (SIGSEGV); use a blocking transfer→NIS→transfer round-trip - 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
- Docs / profiles: hybrid max-FPS path is same-GPU + blit/nis + ultra/adaptive
(not--offload); FSR2/3/4 called out as out of layer scope (Proton FSR4 is
AMD-only). Steam / example launch lines andprofiles.example.confdefaults
follow that guidance --fsr 0/--blitstarts with scale + linear blit (FSR1 pass off);--native
is passthrough (old--fsr 0behavior)--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.5.0...v0.6.0