Repository navigation
EdgeScale 0.8.3
Changelog
All notable changes to EdgeScale (edgerun / legacy xfsr-run) are documented here.
Format based on Keep a Changelog.
Versioning follows Semantic Versioning.
Unreleased
0.8.3 — 2026-11-02
Added
- Linux AppImage: portable
EdgeScale-*-x86_64.AppImagerelease artifact (scripts/package-appimage.sh); primary Linux install path (curl installer demoted). - Windows Setup.exe: Inno Setup installer/uninstaller (
packaging/windows/edgescale.iss) with Add/Remove Programs support; ZIP +.batscripts remain as fallback. - Nearest-neighbor upscaler (
--upscaler nearest):VK_FILTER_NEARESTblit for 2D pixel art; F3 cycle includesblit → nearest → nis → edge. - Manual resolutions:
--render WxHfor absolute internal size;--output WxHauto-detects the primary display when omitted (supports 4K). Profile keysoutput=/render=. Adaptive scale max raised to 4.0×.
Changed
- README refreshed for EdgeScale branding (
EDGESCALE_*env vars primary), current one-way/fused offload guidance, AppImage + Setup.exe install, nearest + 4K docs. - Install script rename:
scripts/install-edge-run.shreplacesinstall-xfsr-run.sh(install-edgerun.shremains a symlink). Docs and CMakeinstall-edge-runtarget updated; user-facing copy no longer leads with proprietary FSR branding. - Godot 3 GLES (BunnyForest): auto-enable Zink with caps-shrink so the overlay and live upscaler/preset changes work; GL shim remaps default-framebuffer viewports only (keeps design RTs intact) and does not X11 size-lie when the exe links
libX11(avoids maximize/fullscreen postage-stamps). - Godot 4 sowrap + Zink (MMX): live F1 preset recreate is blocked (toast: restart
edgerunwith--preset); upscaler hotkeys still apply live.
Fixed
- Zink image not filling the window:
- Avoid monitor-sized
DISPLAY_EXTENTunless--output/--render/ gamescope is set; CreateSwapchain ignores mismatched monitor seeds for windowed Zink. - GL shim proportionally remaps letterboxed viewports/scissors/blits (Godot keep-aspect), keeps SDL/GLFW window and drawable size queries in sync at render resolution, and preserves
GL_NEARESTon remapped blits when--upscaler nearest.
- Avoid monitor-sized
- BunnyForest maximize/fullscreen stamp: X11 size-lie desynced Godot from WSI after resize; lie auto-off for
libX11-linked titles; drawable-size queries stay real so stretch tracks the window.
0.8.2 — 2026-11-01
Added
- Windows Native Vulkan Support:
- Added native Windows x86_64 implicit Vulkan layer support (
VkLayer_XFSR.dll) exportingvkGetInstanceProcAddr,vkGetDeviceProcAddr, andvkNegotiateLoaderLayerInterfaceVersion. - In-game Win32 hotkey polling using
GetAsyncKeyState(F1preset,F2RCAS/edge-mode,F3upscaler cycle,F10pin). - Win32 memory alignment and platform abstractions (
_aligned_malloc,_putenv_s,%LOCALAPPDATA%\EdgeScaleshader resolution, and%TEMP%control files). - Windows batch build & installation scripts (
scripts/build-windows.bat,scripts/install-windows.bat, andscripts/uninstall-windows.bat). - Standalone Linux-to-Windows cross-compilation pipeline (
scripts/build-windows-cross.sh). - Automated Windows packaging and release artifact generation in GitHub Actions (
.github/workflows/release.yml).
- Added native Windows x86_64 implicit Vulkan layer support (
- Technical Documentation & Branding:
- Comprehensive architectural deep-dive and comparison with Lossless Scaling and Magpie (
docs/ARCHITECTURE_AND_COMPARISON.md). - Integrated official project logo into README and updated all project links to
https://github.com/jersobh/edge.
- Comprehensive architectural deep-dive and comparison with Lossless Scaling and Magpie (
0.8.1 — 2026-11-01
Changed
- Rebranded to EdgeScale (
edgerun):- The project is now EdgeScale, putting the custom Edge reconstruction engine and in-process scaling pipeline front and center.
- The primary CLI runner is now
edgerun(e.g.edgerun --preset performance %command%). - Full backward compatibility:
xfsr-runis maintained as a direct alias/symlink, and allXFSR_*environment variables and configs (~/.config/xfsr/profiles.conf) continue to work alongside newEDGESCALE_*/~/.config/edgescale/paths.
Fixed
- CS2 crash on startup with iGPU offload (NVIDIA Reflex): CS2 enables Reflex (
VK_NV_low_latency2) and passed the opaque one-way swapchain handle straight to the NVIDIA ICD (causing alibnvidia-glcoreSIGSEGV). The layer now interceptsvkSetLatencySleepModeNV,vkLatencySleepNV(signals the sleep timeline semaphore),vkSetLatencyMarkerNV,vkGetLatencyTimingsNV,vkGetRefreshCycleDurationGOOGLEandvkSetLocalDimmingAMD, stubbing them for proxy handles and forwarding real ones. --presetignored at startup: when caps-shrink is active, an engine's initial swapchain size (e.g. CoD4 starting windowed at 1280x720 on a 1080p display) no longer overwrites the chosen preset/scale back toquality. Ratio-derived scale is only used withXFSR_CAPS_SHRINK=0.
0.8.0 — 2026-10-31
Fixed
- Edge upscaler colors: edge output now matches FSR1 / NIS / blit.
- Direct-to-swapchain stores no longer double-swizzle BGRA swapchains (the storage view already uses the swapchain format), which swapped red and blue and gave a blue tint.
- The contrast S-curve and saturation boost ("beautify") is now opt-in with
XFSR_EDGE_BEAUTIFY=1, so by default edge leaves colors unchanged.
- Freeze on quality/scale change with edge:
FrameTransfer::resetPipelinewaits on its own slot fences (2 s timeout) instead ofvkDeviceWaitIdleon the app device.
0.7.0 — 2026-10-31
Added
- Always-On Dual-GPU iGPU Offload:
- Offload to iGPU enabled by default across all titles (
XFSR_OFFLOAD=1), routing rendering on discrete GPU (dGPU) and post-processing/upscaling/presentation on integrated GPU (iGPU). - One-way direct WSI presentation on iGPU supported under Mesa Zink (OpenGL) using monotonic opaque swapchain handles and triple-buffered WSI (
minImageCount >= 3) to eliminate acquire stalls. - Fused asynchronous round-trip offload pipeline (
OffloadRoundTrip::submit/submitBlit) across all spatial upscalers (EdgePass,FsrPass,NisPass, andBlit), replacing the synchronous multi-copy CPU blocking fallback. - Offload resilience: never falls back to single-GPU or disables offload when render and display extents match (1:1 stubborn titles) or when one-way WSI fails; seamlessly transitions to round-trip iGPU offload.
- Overlay PCIe optimization: overlay texture buffer upload is gated on text changes, eliminating redundant 460 KB host-to-device transfers every frame.
- Offload to iGPU enabled by default across all titles (
- Universal Vulkan and OpenGL Compatibility:
- Automatic OpenGL and Zink detection in
scripts/xfsr-runacross both Linux ELF binaries and Windows PE executables (opengl32.dll,glew32.dll, OpenGL entry points). - Seamless Proton / Wine WOW64 support: automatically exports
PROTON_USE_WOW64=1for 32-bit Windows games so the 64-bitlibVkLayer_XFSR.soVulkan layer attaches correctly. - Extended OpenGL interceptor (
gl/xfsr_gl_shim.c) withglBlitFramebuffer,SDL_GL_GetDrawableSize, andSDL_GetWindowSizeInPixelshooks so FBO-blitting engines and SDL games properly scale to the shrunk swapchain. - Surface capability shrinking fixes (
applyCapsShrink): dynamically queries live surface display extents, advertises scaled sizes incurrentExtentandmaxImageExtent, and keepsminImageExtentun-raised to preserve in-game low-resolution choices (e.g. Resident Evil Village).
- Automatic OpenGL and Zink detection in
- Beautifying High-Performance Edge Upscaler for Weaker Hardware:
- Re-engineered edge_pass.comp.glsl with zero shared memory (LDS) and zero barriers, achieving 100% GPU occupancy on weaker discrete cards (GTX 1650, Pascal/Turing), integrated APUs, and handhelds.
- Sub-Pixel Edge Tangent Reconstruction: Traces continuous edge normals and blends along edge tangents to eliminate jagged staircases on geometry silhouettes in low rendering resolutions.
- Diagonal-Adaptive Edge Reconstruction: Smooths 45° and 135° diagonal boundaries without blur or moiré artifacts.
- Anti-Ringing Catmull-Rom Texture Filter: Enforces strict local bounding-box clamps to eradicate dark and bright halos around text, UI elements, foliage, and specular highlights.
- Integrated Contrast-Adaptive Sharpening (CAS): Recovers crisp micro-detail in textures while suppressing noise on flat gradients.
- Clarity & Vibrancy Beautification: Applies subtle S-curve contrast and selective saturation recovery to lift muddy, washed-out low-resolution frames into vibrant, rich visuals.
- Fast Perf Mode (Edge-Lite): Ultra-low latency 5-tap diagonal reconstruction with under 0.15 ms execution time for maximum framerates.
- Defaulted EdgePass to the high-fidelity
qualitymode with default sharpness of0.60.
- In-Game Resolution Indicator:
- HUD and status outputs now label sub-1.35x non-standard aspect or internal resolutions as
in-game(e.g.in-game 1.11x) rather than misleadingly bucketing them into the 1.5xqualitypreset label.
- HUD and status outputs now label sub-1.35x non-standard aspect or internal resolutions as
- Native Game Profiles:
- Call of Duty 4 (
[app:7940], D3D9iw3mp.exe/iw3sp.exe): direct layer upscaling withgamescope=0,caps_shrink=1,upscaler=edge,overlay=1. - Street Fighter 30th Anniversary Collection (
[app:586200], OpenGL) & Mega Man Legacy Collection ([app:363440], 32-bit D3D11Proteus.exe):gamescope=1with native Wayland backend. - Resident Evil Village (
[app:1196590]):preset=quality,upscaler=edge,edge_mode=quality,edge_sharpness=0.65,rcas=0,offload=1,gamescope=0.
- Call of Duty 4 (
Fixed
- Adaptive Scaling Stutter Elimination:
- Disabled adaptive continuous scaling by default (
adaptive=0) in share/xfsr/profiles.example.conf. - Replaced fluctuating adaptive swapchain recreations with rock-solid fixed scaling presets (
quality,balanced,performance,ultra), eliminating presentation hitches and frame drops.
- Disabled adaptive continuous scaling by default (
- Live Upscaler Switching & On-Screen Feedback:
- Added lazy
DeviceContextinitialization for FSR1 (ps->fsr.init(c)) in layer/xfsr_layer.cpp during liveF3cycling, preventing live resize failures when switching from Edge to FSR1. - Enabled status overlay and toasts by default (
overlay=1) for Call of Duty 4 ([app:7940]) in share/xfsr/profiles.example.conf so preset/mode adjustments are clearly visible on-screen. - Restored
r_fullscreen "1"configuration for Call of Duty 4 to ensure the proxy layer engages full-display upscaling from low in-game resolutions.
- Added lazy
- Presentation Deadlock: Upgraded
g_queueSubmitMutostd::recursive_mutexin layer/xfsr_layer.cpp, eliminating a self-deadlock whenpd.QueueSubmitinvokesxfsr_QueueSubmitfrom the present thread. - In-Game Resolution Proxy Preservation: Guarded swapchain recreation on
F1preset changes withcapsShrinkEnabled(); titles using in-game resolution scaling (caps_shrink=0, e.g. Resident Evil Village) no longer get forced intoVK_ERROR_OUT_OF_DATE_KHR, preventing accidental fallback to identity passthrough mode. - Direct dGPU Dispatch: Bound
deviceGdpadirectly to the adopted dGPU context inensureDgpuAdoptedandxfsr_CreateSwapchainKHR, avoiding recursive layer interceptors and optimizingvkQueueSubmit2dispatch.
Changed
- Native layer upscaling for Resident Evil Village (
app:1196590): enabled direct Vulkan layer proxy withedgeupscaler,caps_shrink=0, and overlay support. Live switching between Edge, FSR1, NIS, and Blit now works seamlessly via hotkeys. - NVIDIA: do not auto-skip gamescope when
--any/--gamescope/ profile
gamescope=1is set (Village/CS2 need the nest; layer stays identity). Opt out
withXFSR_GAMESCOPE_FORCE=0. Village profile:gamescope=1+gamescope_fs=1- NIS filter
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.8.2...v0.8.3