Skip to content

Releases

Lichii nx2 build 366 (7e2316d)

Choose a tag to compare

@github-actions github-actions released this 20 Nov 23:05
7e2316d

Changes since build 341

Built from nx2 at 7e2316d. It includes everything testers ran in all-in-one builds 11, 13 and 14, plus the fixes that landed after them.

Big points

  • A third GPU thread. Eligible Switch 2 Vulkan draws are now recorded on a third thread, ported from Fritchii (Frizti). It's always on (#2319). GPU submits are lighter (#2312), and the GPU threads sleep instead of spinning while they wait (#2237, #2247).
  • Switch 2 Editions run as Switch 2. Kirby and the Forgotten Land, Xenoblade Chronicles 2 / DE / X, Mario Wonder, Metroid Prime 4 and other Editions boot with their Switch 2 identity. Matching upgrade packs layer correctly over the game, and launches work from a .nup, a loose folder or a packed update (#2328, #2329, #2332, #2338, #2340). Bundled NUP updates show in Add-Ons (#2326). Xenoblade 2 gets its Switch 2 memory layout (#2327).
  • Switch 2 games in HOME without installing. Games in your game folders appear in the native HOME Menu, with your custom artwork, and boot in their own session (#2148). There's also a HOME Button hotkey, and native HOME keeps its own isolated system data (#2183–#2201).
  • Precompile All Shaders. Turn it on for a game in its right-click menu. It finds every shader in the game, including the compute shaders inside Kirby Air Riders' asset packs, and builds them up front using all CPU cores, with resume (#2331). There's also an opt-in to skip Switch 2 mesh draws whose shaders aren't built yet, so a scene doesn't wait on them (#2289).
  • What's new. After an update, Lichii shows what changed. You can open it any time from Help → What's new (#2334, #2342).

Ocarina of Time

  • FPS Unlock: Epona's fence jump animation is kept (#2314), cloth moves correctly below 60 fps (#2313), and the day/night clock and Deku Tree webs keep their fractional steps (#2317, #2318). Physics solver steps round up correctly (#2179), and FPS Unlock stays on the default vsync timer (#2136, #2137).
  • The game no longer freezes after closing the R1 menu (#2296).
  • An unpaced, unlocked game is held to 240 fps instead of running away (#2178).
  • Optional add-on: texture heap compaction interval, off by default (#2323).

Other games

  • Xenoblade Chronicles DE (Switch 2): clean title-screen and menu textures (#2305), no boot hang (#2304), and no crash when switching between docked and handheld, by tomvita (#2299).
  • Mario Kart World and Splatoon Raiders: native storage sizes are honoured (#2262).
  • The Duskbloods: FSR 3.1 with correct motion, and runs a frame ahead by default; IPv6 redirect fix, by wahhbuffet (#2186, #2187, #2288).
  • Yoshi and the Mysterious Book 2.0.0: optional full-resolution add-on with FXAA (#2242). Invalid texture-buffer views no longer crash (#2296).
  • Donkey Kong Bananza: Switch 2 native tiling in the software blitter, and 16-byte GOB swizzling (#1898).

Graphics and stability

  • Texture write-backs keep newer GPU data (#2133–#2135). Shader fixes (#2132, #2140, #2301). Faster NVIDIA compute routing (#2291).
  • Legacy AMD drivers compile with at most two pipeline workers (#2311). Linux FSR 4 works on RADV, by RomainROCH (#1540).
  • Low VRAM: fewer needless collections (#2167), texture allocation failures recover instead of crashing (#2290), and smaller GPU buffer blocks on 4–8 GB cards (#2316).
  • Vulkan borrows a cached sampler at the driver limit (#2236). Descriptor lookups stay in bounds (#2235). Buffer cache use-after-free fixed, by Dimitris Zervas (#2163).
  • No crash when detecting HDR monitors (#2176). Windows crash dumps carry more detail (#2177).

Online and controllers

  • Nextendo: BCAT background content delivery, and sign-in fixes (#2217).
  • Room proxy endpoints and ENet identity stay stable when rejoining rooms, by n0ctbyte (#2336).
  • Switch 2 Pro Controller: no gyro jump and a clean Bluetooth exit (#2138, #2139). A lone Joy-Con gets Single assignment (#2292).

Mac and ARM64

  • Opt-in Hypervisor execution on Apple Silicon (#2254). ARM64 builds default to Dynarmic (#2246), with opt-in native execution validated on Linux (#2249). macOS builds and signing fixed (#2263, #2309).

Everything else

  • Ryujinx save linking picks the right save and never loses one (#2245). Play times are no longer overwritten at exit (#1971). The config is saved safely (#1972).
  • Built-in frame generation is now called "Lichii Optical Flow" (#1633).
  • CoreTiming drops expired events (#2252). Shorter Windows memory unlocks (#2233). Refreshed Windows PGO profile, and MSVC 14.51 builds again (#1763).
  • 20+ community fixes from the PR sweep. Thanks to everyone who sent them, including danieljesus, Reiixan, GoatTech-42, RomainROCH, n0ctbyte, tomvita, wahhbuffet, Dimitris Zervas, and Frizti for the Fritchii work.

Automatic build of nx2 at 7e2316d.

Linux

Linux packages come as an AppImage and a tar.gz. Both are self-contained and need glibc 2.39 or newer (Ubuntu 24.04, Fedora 40, Debian 13, Arch). The tar.gz holds the same files unpacked, for systems without FUSE: extract it and run lichii/lichii.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz Make the AppImage executable (chmod +x) and run it
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run lichii.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 zip PGO zip Both built with clang-cl and ThinLTO; the PGO zip adds a profile trained on Ocarina of Time

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip macOS 15 or newer. Not notarized: right-click and choose Open the first time, or run xattr -dr com.apple.quarantine lichii.app. eden-cli is inside the app, in Contents/MacOS

The PGO builds are the same programs compiled with profile-guided optimization. Linux uses clang with Eglantine's profile; Windows uses clang-cl and ThinLTO with a profile trained in Lichii on Ocarina of Time, so other games gain less. Prefer them when your CPU supports it.

Lichii nx2 build 341 (9c9a1df)

Choose a tag to compare

@capy-ai capy-ai released this 17 Nov 21:41
9c9a1df

Changes since build 316

Built from the all-in-one test build 10 (test/all-in-one-10 at 9c9a1df), which testers and the maintainer ran before release: nx2 6b34d6e plus every fix that was waiting for testers. These fixes are landing in nx2 now.

Big points

  • Far fewer shader freezes, in every game. Async shaders are now on by default with a short 8 ms wait (Bounded); choices you set yourself are kept (#2105). Compute shaders that are still compiling no longer stall the game when the screen already has an earlier result (#2104). On NVIDIA, compute shaders compile much faster (#2103), and a shader the game is waiting on no longer queues behind other builds (#2098). The pipeline cache is written safely, and a cache the driver rejects starts fresh (#2100). The second launch of the same build is almost freeze-free.
  • Cyberpunk 2077: all 64 shaders that were rejected now translate (NVN2 root tables, surface atomics, TLD.B.LL/TXQ, USHF/REDUX/LDG) (#2089, #2090, #2093, #2094).
  • Ocarina of Time: text speed add-ons, 2x, 4x or instant (#1422); smoother unlocked frame rates on the host display (#2028); FSR keeps working in handheld with Max Resolution and dynamic resolution (#2039, #2072); fewer upload hitches on Windows (#2043).
  • Switch 2 Pro Controller support (#2046).

Graphics

  • Star Fox: the Venom mission floor is back (#2047).
  • Link's Awakening: no more fine dark stripes on round surfaces above 1x (#2057).
  • Donkey Kong Bananza: I2M uploads use Switch 2 native tiling (#2085).
  • Breath of the Wild: textures are written back to the right address space (#2063, #2062).
  • Fire Emblem / The Duskbloods: GPU-written overlapping textures are written back instead of dropped (#1501).
  • Mesh pipelines that fail no longer lend vertex inputs (#2022).
  • Switch Sports Resort: Power Cruising water no longer renders black (#2074).
  • Orbitals: a skipped compute shader now runs (#2083).
  • macOS: cheaper occlusion queries on Apple GPUs (#2044).

Performance

  • Fire Emblem: Fortune's Weave crowded battles run much faster (AMD tester: 24-35 fps to 30-50 fps) (#2037).
  • Compute read-backs reuse their staging memory (#2078).

Stability

  • Fixed a race that could crash Ocarina of Time when two threads touched the same new memory page (#2041).
  • Syncpoint notifications are re-armed, code-page invalidation and multi-range buffer retirement fixed (#2052, #2053, #2054).
  • Final Fantasy Resonance: fixed a rare crash in long video cutscenes (#2070).
  • Very large shader caches are read in pieces, fixing a crash on load (#2110).

Online (Nextendo)

  • Windows: sockets opened with the default protocol connect again (#2058).
  • Only IPv4 connections are redirected to the Gamesync server, so IPv6 no longer breaks (#2065).
  • Deleting a user profile also signs out its Nextendo account, and Lichii offers to clean up sign-ins left by build 316 (#2073).
  • Host redirect for local server testing: several hosts, local sign-in tokens on localhost only, optional user-supplied patches (#2086).

Files and tools

  • Solid NSZ games no longer read empty data after the disk fills up (#2031); scanning before keys are installed no longer floods the log (#2061); the DLC and update list refreshes after you change content (#2095).
  • Bug reports (Ctrl+F12) include compressed textures and every mip level (#2048). New diagnostics: RADV_DEBUG=hang reports (#2050), unmapped-read provenance (#2055), EDEN_NX2_FAULT_MAP=1 names what a GPU fault address belonged to (#2097), driver build times in the log (#2099).

Known issues

  • macOS: Ocarina of Time in handheld with Max Resolution and FSR can show a bright white or rainbow glare around lights.
  • Kirby Air Riders can lose the GPU device after a few minutes on some NVIDIA cards (also on 316). If it happens to you, play with EDEN_NX2_FAULT_MAP=1 and send the log.

Only download Lichii from this releases page. Report bugs with Help → Report a Bug (Ctrl+F12) and share the zip privately; it holds game data.

Linux

Linux packages come as an AppImage and a tar.gz. Both are self-contained and need glibc 2.39 or newer (Ubuntu 24.04, Fedora 40, Debian 13, Arch). The tar.gz holds the same files unpacked, for systems without FUSE: extract it and run lichii/lichii.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz Make the AppImage executable (chmod +x) and run it
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run lichii.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 zip PGO zip Both built with clang-cl and ThinLTO; the PGO zip adds a profile trained on Ocarina of Time

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip macOS 15 or newer. Not notarized: right-click and choose Open the first time, or run xattr -dr com.apple.quarantine lichii.app. eden-cli is inside the app, in Contents/MacOS

The PGO builds are the same programs compiled with profile-guided optimization. Linux uses clang with Eglantine's profile; Windows uses clang-cl and ThinLTO with a profile trained in Lichii on Ocarina of Time, so other games gain less. Prefer them when your CPU supports it.

Lichii nx2 build 316 (5a66c89)

Choose a tag to compare

@capy-ai capy-ai released this 16 Nov 22:25
5a66c89

Changes since build 228

Built from nx2 at 5a66c89, the release candidate testers have been running (run 316). Build 228 was be1f4d9. That's 141 merged changes, 60 of them from community contributors.

Big points

  • Nextendo online play (opt-in). Lichii can now play online through the Nextendo Network. It's off until you turn it on: Configure → Network → Play online through Nextendo Network, then sign in (#1979, #1358, #1984).
    • Friends list, friend requests and presence: see who is online and add friends (#1983, #2019).
    • Your Nextendo nickname and picture show as the current user (#1990).
    • One Nextendo account per user profile: each Lichii user profile signs in on its own. If you were already signed in, you may need to sign in once more (#2011).
    • Network fixes so games stay connected: Splatoon 3's network requests follow the connection (#1988). Socket options games use are handled, and stray UDP resets on Windows are ignored (#1982). SSL Peek returns the waiting bytes (#2016).
    • Mario Kart 8 Deluxe must be on version 4.0.1 to play online.
  • Online races no longer drop you when frame generation is on. With a frame pacing target and frame generation together, the game was held at 30-45 fps, and online races disconnected. Pacing targets now count game frames, not generated frames (#2021). Frame generation also never makes the game wait for a free present frame, so 2x on a 60 Hz or 90 Hz screen keeps the game at its own rate (#2023).
  • IPv6. Games can open IPv6 connections, look up IPv6 (AAAA) addresses and format IPv6 addresses. IPv4 behaves exactly as before (#2025).

Ocarina of Time

  • No sharpening shows normal contrast again (#1875, #1995).
  • FPS Unlock works together with code cheats, and warns when they overlap (#1981). Clothes and hair sway at real speed above 60 fps (#1793).
  • Castle Town at 1.5x or 2x no longer loses the GPU on AMD (#1890).
  • Fewer stalls when new mesh effects appear (#2012, #1853), and Intel compiles OoT's mesh shaders much faster (#1853).
  • The video finalize sent after the intro movie is handled (#1901), and more 1.0 output shaders are recognised (#1778, #1871).

Other games

  • Donkey Kong Bananza: the tutorial panel is no longer black or flashing, and videos no longer stall after looping. Ported from GabrielDieterly's #1562 (#2024). CPU inner invalidation stays on for DKB (#1889).
  • Fire Emblem: Fortune's Weave: the DLSS upscale is temporal by default, so the picture is steady instead of shaky (#2009). Its second captured prepass is accepted (#1752), and the network passes are skipped when they can't be shown (#1985).
  • Hyrule Warriors: Age of Imprisonment: boots every time, not only the first time after a reboot (#2005).
  • Kirby and the Forgotten Land, Switch 2 Edition: boots with Star-Crossed World (#1930).
  • Kirby Air Riders: the intro movie plays smoothly (#2010).
  • Mario Kart 8 Deluxe: the Sky-High Sundae sky has no pink triangles on AMD (#1915).
  • Final Fantasy Resonance and Deep Rock Galactic: Survivor: long sessions no longer run out of GPU address space. A tester ran DRG: Survivor for 3h40m clean, where 228 broke at about 74 minutes (#1911).
  • Switch 2 Editions: Switch 1 add-ons show in the game list (#2001) and register from NUP files (#1912).

Graphics, GPU drivers and memory

  • Integrated GPUs keep more textures resident, and the texture cache follows the lowest recent budget, not the last one read (#1991, #1860).
  • Intel on Windows saves the driver pipeline cache at the end of loading again (#1838).
  • AMD's proprietary RDNA2 driver uses the mesh compute fallback, with a Mesh Shaders setting (#1937).
  • MoltenVK's 16-sampler limit is lifted (#1862).
  • Running out of staging or buffer memory degrades or retries instead of crashing (#1870, #1963, #1931, #1997).
  • A lost Vulkan device closes Lichii cleanly with a clear log line (#1938).
  • Large ASTC arrays decode in batches on integrated GPUs (#1823).

Shader loading

  • Loading Shaders waits only for the last two sessions' pipelines and builds older ones in the background (#1803).

Crashes, files and stability

Audio, input and UI

  • Help → Check for Updates (#1910). The update check also works on non-Debian Linux (#1842, #1844).
  • SDL gyro survives a controller reconnect (#1805), and reversed stick axes on macOS are honoured (#1927).
  • Cancel in Configure reverts unapplied controller edits (#1904). Borderless fullscreen leaves the maximised state first (#1895).
  • The UI volume is no longer baked into the audio sink at boot (#1847).

Packaging

  • Linux packages no longer bundle the Vulkan loader, which fixes the start-up problems in build 228's known issues (#1854).

Known issues

  • Mario Tennis Fever: Adventure mode can freeze when leaving the academy (#2018). Please retest on this build.
  • Solid NSZ on a nearly full disk: if the disk fills while a solid NSZ is unpacking, reads can come back empty until space frees up (#2020). Keep some free space on the temp drive.
  • Mario Kart World online: waits on Nextendo's MKW servers.
  • Ocarina of Time on Linux RDNA1 with Mesa main (13-16 Nov): a Mesa regression hangs the GPU before "Press A". Update Mesa (#2026).
  • The first launch of a game after updating may rebuild some shaders.

If something is worse than in build 228, press Help → Report a Bug (Ctrl+F12) while it happens and send the zip privately. It holds game data, so never post it publicly.

Downloads

Automatic build of nx2 at 5a66c89 (release-binaries run 316).

Linux

Linux packages come as an AppImage and a tar.gz. Both are self-contained and need glibc 2.39 or newer (Ubuntu 24.04, Fedora 40, Debian 13, Arch). The tar.gz holds the same files unpacked, for systems without FUSE: extract it and run lichii/lichii.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz Make the AppImage executable (chmod +x) and run it
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run lichii.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 zip PGO zip Both built with clang-cl and ThinLTO; the PGO zip adds a profile trained on Ocarina of Time

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip macOS 15 or newer. Not notarized: right-click and choose Open the first time, or run xattr -dr com.apple.quarantine lichii.app. eden-cli is inside the app, in Contents/MacOS

The PGO builds are the same programs compiled with profile-guided optimization. Linux uses clang with Eglantine's profile; Windows uses clang-cl and ThinLTO with a profile trained in Lichii on Ocarina of Time, so other games gain less. Prefer them when your CPU supports it.

Lichii nx2 build 228 (be1f4d9)

Choose a tag to compare

@capy-ai capy-ai released this 15 Nov 11:32
be1f4d9

Changes since build 177

Built from nx2 9fbffe2 plus 11 pull requests that merged into nx2 after it (the test/all-in-one-3 branch at be1f4d9). Build 177 was 87d84d5. That's 152 merged changes, 69 of them from community contributors.

The first launch of each game after updating takes longer. A lot of shader code changed in this release, so caches are partly rebuilt once: the compute precache runs its pass once more (#1620), pipelines that an older cache saved with the wrong texture type are rebuilt (#1443), NVIDIA on Linux fills a new, larger driver cache folder (#1301), and the LSFG shader cache rebuilds (#1625). Later launches should be fast again. If a second launch of the same build still rebuilds most shaders, send the log from Help → Report a Bug (Ctrl+F12): we're looking into reports of this.

Big fixes

  • Ocarina of Time: the full-screen white flashing from build 177 is gone. Build 177's groundwork for higher frame rates in Mario Kart World let shaders read stale data with Skip CPU Inner Invalidation on, and the screen flashed white. Players traced it to that change on an RX 6900 XT, and it showed up on an RTX 3090 too. The change is reverted; it gained Mario Kart World only about 0.5-1.2 fps (#1651).
  • Ocarina of Time no longer freezes for good after an ocarina warp. Warping to a place you'd visited (Temple of Time, Desert Colossus) froze picture and sound within a minute or two, and a forced stop then showed error 2010-0212. A game thread, the GPU thread and its second half were waiting on each other's locks. GPU memory updates are now handed off after the locks are released. On the author's RX 7900 GRE (RADV) it froze almost every time before; afterwards, warp loops and a long session ran without one. From Nanoc6 (#1218).
  • Mario Kart World: steady resolution and a higher frame rate. The game sizes its dynamic resolution from GPU timestamps, and in the form Lichii reported them the GPU looked almost out of time, so the resolution flipped every few frames and render targets were rebuilt over and over. Mario Kart World gets real GPU ticks again; other games are unchanged. On Mario Bros. Circuit with an RDNA 2 GPU on RADV it went from 18.6 to 22.1 fps, and image creations dropped from about 40 to about 1.3 per frame. Ported from Rhys Denno's upstream Eglantine change (#1817).
  • Donkey Kong Bananza no longer crashes on AMD right after the golden-banana loading screen. The game's voxel-world pipeline uses a geometry shader feature AMD doesn't have, and Lichii's emulated version declared inputs it can't pass and more outputs than AMD's limit of 128. AMD's Windows driver doesn't report that; it kills the process, so the log just stopped. The emulated shader now passes only what the previous stage writes. On an RX 6700 XT the unpatched build crashed every time. From sopedound (#1110).
  • AMD on Linux: no more GPU hang on RDNA 3 and RDNA 4 with Mesa older than 26.2.5. A RADV bug kept stale state when binding a mesh shader that doesn't read its grid size, and none of Lichii's native mesh shaders read it, so the GPU hung a few seconds into Ocarina of Time's intro. On those drivers mesh shaders now read the grid size once, which avoids the bug, and native mesh shaders stay on. On an RX 9070 XT with RADV 26.2.4 it hung 2 out of 2 times before and not at all after. From Molier (#1203).
  • Ocarina of Time on RX 6000 cards (Linux): no more GPU crash on mesh draws. RDNA 2 cards on RADV lost the device with a GPU read fault at a fixed address, on several players' RX 6600, 6650 XT and 6950 XT machines, always on native mesh draws. RDNA 2 on RADV now uses the slower but safer compute fallback for mesh draws. The root cause isn't known yet; RDNA 3 and newer, AMD's Windows driver and other GPUs are unchanged (#1732). That fallback also draws grass and bush shadows again: it only drew triangles, so the point program that fills the foliage shadow map was dropped on every GPU that takes it. From nemiward (#863).
  • Ocarina of Time: a likely fix for the GPU hang on NVIDIA. Two compute shaders could hang NVIDIA GPUs a few minutes into play. The way they pick the buffer behind each memory access was the one unusual thing in them. First every branch was merged into a single return (#1681), which still hung after about 390 s on an RTX 5090; now, on NVIDIA's driver only, the shaders pick the buffer with one select instead of a branch per buffer. rtrevisanuto found and tested that approach: a 529 s run had no hang, with falling leaves and particles drawn right. It was tested on Linux, so players still need to confirm it on Windows (#1757).
  • Ocarina of Time on Intel Linux (Mesa): no more black screen after the intro movie. One compute shader never finished compiling, because each memory access checked all 32 buffers the shader binds and the compiler spilled without end. Each access now checks only the buffers its address can come from, and the shader builds in about 9 s. The reporter confirmed the compile hang is gone (#1807).
  • AMD on Windows: boots no longer rebuild thousands of pipelines. AMD's own driver cache doesn't keep the kind of pipelines Lichii builds, so every boot rebuilt about 5,800 of them at about 120 ms each. Lichii's own pipeline binary store now stays on for AMD's Windows driver: on an RX 6650 XT the time to the graphics device went from 867-876 s to 17-30 s from the second boot on. From Reiixan (#1406). Closing a game no longer trims that store hard enough to drop a third of a precache's pipelines: the boot after a precache went from about 14 minutes of rebuilding to a first frame in about 30 s. From Reiixan (#1407). And Loading Shaders now waits only for compute pipelines and the last two sessions' pipelines, and builds older ones in the background, so a returning player no longer waits for every pipeline of the last 16 sessions; "Build all cached shaders" still builds everything first (#1803).
  • Yoshi and the Mysterious Book: the book page no longer slows to 2 fps and crashes. On the Chapter 1 book page one GPU buffer kept swallowing its neighbours, grew past 3.5 GiB and was copied whole each time, until memory ran out. Large buffers that only share a page with a new one are no longer joined to it. On an RTX 5070 Ti the page went from 2-12 fps and 21 GB of memory to 57-61 fps at 6.6-7.8 GB. From JohnsGoated (#1534).
  • Donkey Kong Bananza: a likely fix for the random freeze. Presenting a frame could block while holding a lock the rest of the GPU syncing needed, and the picture stopped. Those actions now run with the lock released. It isn't confirmed in the game yet. Ported from MythosOfs's banachii fix, which adapts Andrew's Eglantine change (#1700).
  • Mario Kart World on Intel: no more GPU crash while loading on Linux. Two of the game's loading shaders run a barrier that part of the workgroup never reaches. NVIDIA lets that through, but on Intel's Linux driver the rest of the workgroup waited forever and the device was lost about 40 s into loading. Lichii now finds the barriers only part of the workgroup reaches and loosens only those, so the barriers the game's lighting needs stay (#1677). On Intel's Windows driver, barriers are now kept whenever the whole group takes the same path, a likely fix for the washed-out, overexposed picture there. Neither is tested on Intel hardware yet (#1742).
  • Ocarina of Time: no more green and red speckles on RTX 20 cards. With Ocarina of Time anti-aliasing set to Game, Turing GPUs (RTX 2060 to 2080 Ti) showed speckles because NVIDIA's compiler miscompiles the cooperative-matrix path on Turing, which NVIDIA has confirmed. Turing now runs those operations in shader emulation, which on an RTX 2070 removed the speckles at about the same fps. RTX 30, 40 and 50 keep the faster path. From Maximel3105's patch and A/B test, with pamontoya-coder's bisect (#1694).
  • Kirby Air Riders: no more GPU thread crash a few minutes in. Textures with no memory behind them get placeholder addresses past the end of device memory, and a memory hint read far out of bounds at those addresses. Such hints are now ignored. On a Steam Deck, the route that crashed about four minutes into the first lesson ran into a race for over twelve minutes. From cerroverb (#1568). A crash while translating one of its shaders is fixed too: an analysis walked deep loops recursively and ran out of stack. From kdegonia-star (#1616).
  • Closing a game during "Loading Shaders" no longer freezes Lichii. The close stopped the shader load, but the guest cores still started, and the services starting on them deadlocked with the services being shut down. That's fixed, along with what it left behind, so launching a game again in the same window boots normally. From PantACRO4life (#1417).

New features

  • Mario Kart World: 60 FPS mode at normal game speed. A new "Mario Kart World: 60 FPS mode" setting, off by default, runs races at 60 fps instead of only cutscenes, one 1/60 s step per frame, so the game never runs fast. "Drop to 30 FPS when slow", on by default with it, switches to the game's 30 fps mode at normal speed after three slow frames in a row and tries 60 again later, so a slower PC gets 30 fps instead of slow motion. On an RTX 4070 Laptop GPU, races ran at 96-100% of normal speed with the fallback on. It applies after restarting the game. From thatrandomalt (#1704).
  • Report a Bug. Help → Report a Bug, or Ctrl+F12 (rebindable), writes one zip under 19 MiB with your description, logs, system and GPU details, settings, mods, the last 10 s of frame times, a screenshot and the next frame with its shaders. User names are removed, but the zip holds the game's textures and shaders, so send it privately to the maintainers and never in a public channel (#1647).
  • Solid NSZ files play. Their sections are unpacked through a small temporary file, and a failure is logged with the file's name. Ported from n0ctbyte (#1734). Idle solid NSZ fi...
Read more

Lichii nx2 build 177 (87d84d5)

Choose a tag to compare

@github-actions github-actions released this 13 Nov 14:31
87d84d5

Changes since build 160

Built from nx2 87d84d5. Build 160 was 2eb5f08. That's 86 merged changes.

The yuzu name is gone. The build system, source folders, Qt frontend, translations, emulator libraries and docs now say Lichii instead of the name inherited from yuzu. Your settings, saves and shader caches are kept: config keys, data folders and cache formats don't change, and the few on-disk names that still carry the old name (the shader cache's file magic, the save-size file inside saves, the import path for yuzu data) stay as they are. The program files are still called lichii, eden-cli and eden-room. On macOS the app's bundle id changed, so macOS asks for camera and input permission again (#1541, #1550, #1551, #1552, #1553, #1544, #1582).

Big fixes

  • Ocarina of Time: the far forest no longer floats, and Hyrule Field's frame rate is back. In test builds after build 160, the far pine forest in Hyrule Field and in Kakariko at night was drawn unculled and partly above the ridge, and a spot that ran at 40 fps dropped to 27 fps (RTX 3080). An upstream change that came in with the Eglantine sync (#1462) generated the shader helpers for these foliage programs in a form NVIDIA's compiler mishandles. They're generated the previous way again, which also gives up the cold-compile time upstream saved on them (#1539).
  • Orbitals no longer freezes after the Unreal logo. It froze at 0 fps on every Lichii build so far, because vi2 command 53, which Unreal uses to see which frames were shown, had no handler. This covers Orbitals and the Global Friends Pass. Ported from ghzeni's #742 (#1590).
  • Booting a second game without restarting Lichii no longer crashes. A GPU channel still waiting on a semaphore when a game stopped left a stale entry behind, and the next game's GPU thread read the stopped game's freed memory. It was seen when booting Donkey Kong Bananza after stopping Ocarina of Time (#1592).
  • Stopping a game no longer ends in a "Userspace PANIC". Guest threads kept running while services stopped replying, so about half of all stopped Ocarina of Time sessions logged a panic (2010-0212) that looked like a crash. Guest threads are now suspended before the system powers off (#1450).
  • Ocarina of Time: the dark grid over water is gone. Boxy dark squares followed Link over water whenever a light such as Navi, an enemy or a rupee was near. Shadow maps from the game's light table are now bound through descriptor arrays. Testers on an RX 7800 XT, RTX 4090 and RTX 5080 confirmed it. Port of jpkto's #354, with his commits kept (#1485).
  • Ocarina of Time: a likely fix for the GPU hang after long play. 38 OoT sessions from 28 players ended in a device loss after long play, on AMD, RADV and NVIDIA. A native task shader could launch a leftover, huge number of mesh workgroups; it now sets that count to zero first. Ported from SethRamey's upstream fix. It can't be confirmed yet: the hang shows up about 0.05 to 0.2 times per hour of play (#1492).
  • Mario Kart World: the hang while loading is fixed. Two GPU threads and a guest core deadlocked. The GPU threads no longer wait on kernel locks for sparse memory: a background thread prepares memory ahead of time, and writes are kept until it's ready. The memory reserve follows godpow's upstream design (#1413).
  • Yoshi and the Mysterious Book (demo): no more memory runaway. The demo remaps the same memory every frame, each remap got a new device address, and one buffer kept growing until the process ran out of memory. Freed device ranges of the same size are now reused. In a 150 s run the buffer cache peaked at 308 MiB instead of 2,025 MiB, and the process at 4.7 GB instead of 14.7 GB (#1528). A follow-up gives the kept ranges back when device space runs out, so allocations of other sizes don't fail (#1532).
  • Games no longer vanish from the list when keys are missing. Switch 1 NSP, NSZ, XCI and XCZ files that can't be decrypted are listed with "Decryption keys missing" and a tooltip that says how to install keys. Keys that your key file can produce (master keys, key area keys and titlekeks for newer generations) are now derived, ported from MeownsterHunter's Eden PR 4607 (#1503). A missing key now gives an error that names the key and tells you to install keys, instead of "bad header, please redump" (#1457).
  • Switch 1 games packed as .nx run as Switch 1 again. Every .nx archive was treated as a Switch 2 title, so a Switch 1 game in one got the Switch 2 memory layout and a guest clock 1.63x too fast (#1456).

New features

  • NVIDIA DLSS Frame Generation for Ocarina of Time. It's a new Frame generation type and includes Multi Frame Generation: up to 2x on RTX 40 and up to 4x on RTX 50. It needs "Use NVIDIA DLSS" on, and the NVIDIA DLSS panel downloads NVIDIA's Streamline files; nothing of NVIDIA's ships with Lichii. Other games and GPUs fall back to FSR3 frame generation, and the log says why. Windows only, and not yet tested on RTX 40 or RTX 50 hardware. Built on Dankann's #1348 (based on Frizti's Fritchii#38), with Multi Frame Generation from Revens2's #1291 (#1508).
  • DualSense HD haptics over USB. A wired DualSense plays Switch HD rumble on its voice coils, with each side on its own coil, instead of plain rumble. Turn it on under Controls → Vibration → "Enable DualSense HD Haptics"; it's on by default on Windows. Bluetooth still uses normal rumble. Not tested on hardware yet. Ported from pentalex's Eglantine-Community #624, whose synthesis is adapted from Three-Dola's RenHDrum (#1497).
  • Better rumble on two-motor controllers. On one controller, left and right rumble no longer overwrite each other: each motor plays the stronger side. A new "Frequency-aware rumble" option (off by default) sends each band to the motor that matches its frequency, so a low thud lands on the heavy motor (#1499).

Performance

  • Guest reads skip the GPU cache locks on pages nothing on the GPU touched. In Mario Kart World on Mario Circuit this went from 30.1 to 33.5 fps, with p50 frame time down from 32.7 to 29.4 ms. Read half of Stephen Jayakar's fast path, compared against Frizti's version (#1479).
  • Faster x86-64 guest code. The JIT now uses host call and return, live host flags, address folding and a separate region for cold code. Mario Kart World went from 32.0 to 34.2 fps, and the guest threads spend about a quarter less time on a core. Ocarina of Time in Hyrule Field at night ran at 32.6/32.8 fps against 31.3/32.1, measured with two other candidates on. ARM and Paranoid CPU accuracy keep their old code generation. From Julius Bairaktaris's #831, with Stephen Jayakar's back-edge halt checks from #717 (#1531).
  • Faster JIT compiles. The register allocator tracks its slots in bitmasks instead of scanning all 102 after every instruction. The generated code is identical. liomaroliveira measured 27.9% less JIT compile time in Ocarina of Time and the title-logo frame spike dropping from 60-67 ms to 49-50 ms. Ported from liomaroliveira's fork (#1517).
  • Guest cores wait for work in hardware instead of spinning. In Mario Kart World the old yield loop took 20% of the guest cores' CPU time, about 0.8 of a host core. Idle cores now wait with MONITORX/MWAITX on AMD or UMONITOR/UMWAIT on Intel, for a time that adapts per core (#1373).
  • The GPU thread is woken instead of polling suspended channels. Polling cost about 10 ms of GPU-thread CPU per frame in Mario Kart World. The frame rate doesn't change, but together with #1373 Lichii uses about 0.43 of a CPU core less. The idea comes from Serki's Eglantine-mkw60 and upstream (#1376).
  • Cheaper constant buffer writes. Constant buffer data cost Mario Kart World about 6 ms of the GPU back thread per frame. Each bind is translated once, writes are merged into one invalidation, and small uniform buffers are kept across draws until something writes them (#1441).
  • Data the GPU's engines write keeps its pages tracked, which saves two page-protection changes per page on every write cycle. From lucastaonline's #1161 (#1436).
  • Ocarina of Time water work from #1161. lucastaonline's Kokiri water work is ported in parts, each with his commits kept and without its test switches:
    • Cheaper query cache lookups, frees and locks (#1515).
    • Cheaper reports and fences on the GPU back thread (#1516).
    • Guest writes change page protection after the buffer cache lock is released, so the GPU back thread no longer waits for it. A hazard in the original that could lose an invalidation after a remap is fixed (#1518).
    • Fast draws for pipelines with computed texture handles, word-exact handle checks, and vertex formats as draw parameters with dynamic vertex input (#1519).
    • Command list copies come from a pool, and re-copies at resumes move off the GPU thread. He measured 62.4 to 63.8 fps at the OoT water. A race in the original when the copy queue was full is fixed (#1520).
    • Fast draws copy only the parts of the draw state in use, and kept uniform buffers end at every write and submit they used to miss (#1521).
  • Uploaded guest memory is pushed out of RAM only when RAM is short. Lichii used to drop it from memory every 600 frames and then fault it back in. In Mario Kart World the 1% low went from 15.1/14.3 to 17.1/16.6 fps. It uses more RAM while there's plenty: 6.8-7.0 GB resident instead of 4.9-5.0 GB. Ported from Julius Bairaktaris's change in ThatGuyMcd/Lichii-TGM, based on Frizti's Fritchii idea (#1581).
  • The Windows zero-page pass reads less and runs less often. It stops at the first non-zero line of a page, waits out bulk mapping, and backs off to 5 minutes when it frees little. A pass in Ocarina of Time went from 1,405 ms to about 1,080 ms, and Mario Kart World's 1% low went from 15.1/14.3 to 16.7/17.0 fps. Ported from Frizti (#1580).

Mario Kart World

  • Races went from about 30 to about 38 fps on Mario Circuit across this release, on the owne...
Read more

Lichii nx2 build 160 (2eb5f08)

Choose a tag to compare

@github-actions github-actions released this 11 Nov 22:06
2eb5f08

Changes since build 150

Built from nx2 2eb5f08. Build 150 was 17baed7. That's 30 merged changes.

New look. Lichii now opens in the new Lichii Dark theme, and a short What's new window explains what moved. You can reopen it from Help → What's New, and the old themes are still in the settings.

Big fixes

  • Yoshi and the Mysterious Book: the 3D world renders. Three shader forms the game uses were rejected, which left the world black. Built on ggonzalospineli-ops' #1189 and FrsrG's #1284, with ALD/OUT from MythosOfs (#1363).
  • The Duskbloods network test: boots to its menus. It no longer aborts on memory, and its shader forms are supported. By cerroverb (#552, #851). It still stops at its online checks. It also always uses reactive flushing, gets the DLSS replacement (#828, #637), and has a 3D colour-target clear fix (#638).
  • Ocarina of Time: the guard house freeze is fixed by a built-in Texture Pool x2 patch (#1313).
  • Mario Kart World: characters and karts are lit correctly. Read-only compute bindings are sized from their size word (#1333).
  • No more crash when antivirus deletes nxformat.dll. nxformat 1.0.3 is now built into Lichii. Converting an XCI to NX also keeps its update partition. By fab918 (#1232).

New features

  • New UI: Lichii Dark. It has icons throughout. Settings dialogs now fit the screen at any scale, and every tab scrolls. A per-game setting you changed gets a pink outline and a reset button. The game list shows folder game counts, full title IDs and favourite stars. Grid and carousel get their own 160 px cover size (#1365, #1371).
  • Native HDR output with HDR10/scRGB passthrough and an Off/Auto/On setting (#1326).
  • LAN play for local-wireless games: Configure → Network → LAN play, off by default (#1359).
  • Frame stats overlay redesign. A big fps number, CPU and GPU %, and a 5-second frame-time graph. It's still movable (#1345).
  • Mario Kart World dynamic FPS skips the game's own second-vblank wait (#1332).

Performance

  • Shader stutter cut down a lot. Pipelines are kept up to a RAM limit instead of 9,000 frames, and an evicted pipeline is rebuilt from its kept SPIR-V instead of being translated again. Revisiting an area went from 360–770 ms hitches to about 55–75 ms. There's also an option to build all cached shaders at boot (#1334, #1337).
  • Less shader compilation work (#1320).
  • CPU: plain loads for LDAR/LDAPR/LDAXR and no barrier for DMB LD/ST on x86, each processor's exclusive reservation on its own cache line, and no empty submits in FlushCommands (#1327, #1331, #1329, a port of Fritchii EXP61). The GPU front/back cache lines are split too (#1332).
  • 3D state registers are written in one call (#1095).

Crash and stability fixes

  • AMD: device memory overallocation is allowed (#1335).
  • Textures over the texel limit that fit in 1 GiB now get backed, which fixes Metroid Prime 4 NS2 Edition (#1325).
  • Looping timers measure their lateness from the end of a pause (#852).
  • The previous log is no longer lost when log rotation fails (#889).
  • Pokémon Pokopia: the furniture-guide shader clamp is folded correctly, ported from Eglantine #781 (#1347).
  • Fixes for the built-in profiler (#1349) and quieter network logs (#1384).

Downloads

Automatic build of nx2 at 2eb5f08.

Linux

Linux packages come as an AppImage and a tar.gz. Both are self-contained and need glibc 2.39 or newer (Ubuntu 24.04, Fedora 40, Debian 13, Arch). The tar.gz holds the same files unpacked, for systems without FUSE: extract it and run lichii/lichii.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz Make the AppImage executable (chmod +x) and run it
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run lichii.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 zip PGO zip Both built with clang-cl and ThinLTO; the PGO zip adds a profile trained on Ocarina of Time

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip macOS 15 or newer. Not notarized: right-click and choose Open the first time, or run xattr -dr com.apple.quarantine lichii.app. eden-cli is inside the app, in Contents/MacOS

The PGO builds are the same programs compiled with profile-guided optimization. Linux uses clang with Eglantine's profile; Windows uses clang-cl and ThinLTO with a profile trained in Lichii on Ocarina of Time, so other games gain less. Prefer them when your CPU supports it.

Lichii nx2 build 150 (17baed7)

Choose a tag to compare

@github-actions github-actions released this 10 Nov 21:39
17baed7

New here or getting bad performance? Stop the game, then use Help → Apply Recommended Settings... to apply the recommended settings in one click. Help → Restore My Previous Settings undoes it.

Automatic build of nx2 at 17baed7.

What changed since build 130

Build 150 was built from nx2 17baed7. Build 130 was 3dae119. That's 51 merged changes.

Big fixes

  • Ocarina of Time: white wash / blown-out lighting fixed. Destroyed GPU memory kept its old backing, so reused memory showed stale pages. Diagnosis and fix by 99ivs, with a safety refresh by PantACRO4life (#1236).
  • Mario Kart World: dark characters and karts fixed. Compute shaders reading lighting data were cut off at 8 MiB and now see the whole buffer (#1231).
  • Ocarina of Time: out-of-memory crash on Windows. The texture cache now stays within Windows' memory commit limit (#1210).
  • Ocarina of Time: ocarina crackle fixed (ADPCM sign) (#1196).
  • Ocarina of Time: dark fairy fountain and Water Temple walls. These are dumps with damaged texture members. Lichii now serves a stand-in instead of black (#1197).

New features

  • NVIDIA DLSS 4.5 settings. Pick the model preset (E/F/J/K/L/M or NVIDIA default; M is the default) and the quality (Automatic, Native DLAA, Quality, Balanced, Performance, Ultra Performance). The status bar shows DLSS <mode> <preset> while DLSS is active. Native DLAA path ported from myshadowww's #840 (#1249).
  • DLSS stays on when NVIDIA warns about the VRAM budget, instead of switching itself off. By Christopher Peters (#941).
  • Ocarina of Time: AMD FSR 3.1 and FSR 4 in place of the game's anti-aliasing network. FSR 4 uses AMD's official runtime, downloaded on request. Includes camera jitter and LOD bias (#1060, #1061, #1062).
  • Lichii now has its own data folder (%APPDATA%\lichii, ~/.local/share/lichii), with a safe import from Eden. Copy keeps your old data, and an interrupted import can be retried (#1253, a port of gabriel-accetta's #1148).
  • Generated-frame FPS is shown next to the FPS when frame generation is on. By Zarigis (#796).
  • No more recommended-settings pop-up on game boot, so frontends launch cleanly. You can still apply the recommended settings from the Help menu (#1264, #1200).
  • UI translations ship in releases, the status bar is translated, and zh_CN and es were updated. By janvitos, cirnoice9 and DevMikeRoger (#819, #826, #827, #893).

Performance

  • Fewer GPU commands per frame: dispatch barriers recorded with their dispatch, and in-order uploads batched. By jpkto (#1245, #1246).
  • Faster texture swizzling on the CPU. By Marc Stampfli (#784).
  • Skips texture uploads that a layer copy overwrites anyway (#1079).

Crash and stability fixes

  • Right-click in the game list no longer crashes on paths with non-ANSI characters (#1258).
  • No crash when a buffer allocation goes over the memory budget. By Marin Salinas (#959).
  • Changing settings while a game loads no longer freezes the UI. By Jay (#1168).
  • Shutdown no longer hangs on threads waiting for the GPU. By jpkto (#1058).
  • Lichii starts even when Windows blocks nxformat.dll, and nxformat is updated to 1.0.1 (#1127, #1078 by Bruno).
  • The kernel shuts down cleanly when a file has no loader. By Eduardo Gomes (#972).
  • Fixes a stale storage pointer when an evicted pipeline is rebuilt (#1143), and a GPU unmap on service command 102 (#1199).
  • A clearer error when a pipeline fails because Windows ran out of commit memory. By janvitos (#807).

Games and content

  • DLC packaged inside a NUP is now found (#1257).
  • The Duskbloods: colour grading fixed (3D texture slice copies). By cerroverb (#853).
  • Audio no longer drops out on PipeWire and Steam Deck. By cerroverb (#850).
  • IPSwitch patches: \e is read as ESC. By Amix (#1108).

Platforms and packaging

  • macOS: the app launches again on macOS 15.0–15.3 (#1254). macOS builds compile again (#1212, plus a fix in #1249).
  • Linux: the tar.gz is now self-contained, built from the AppImage's AppDir. It needs glibc 2.39, the same as the AppImage (#1255).
  • The updater retries a download up to three times (#1101).
  • Build fixes for MSVC, GCC 16 and -Werror (#1154, #1128, #1126, #1045).

Diagnostics and docs

  • DLSS presets E/F accepted by the EDEN_NX2_DLSS_PRESET env variable, and DLSS memory logged (#1098). Removed dead service stubs (#1252). Added tests (#1100).
  • Docs: Linux Bluetooth HFP note, a Visual Studio 2022 Qt link note, CPMUtil link, and new program ids (#946, #835, #795, #1260).

Thanks to everyone who contributed fixes in this build.

Downloads

Linux

Linux packages come as an AppImage and a tar.gz. Both are self-contained and need glibc 2.39 or newer (Ubuntu 24.04, Fedora 40, Debian 13, Arch). The tar.gz holds the same files unpacked, for systems without FUSE: extract it and run lichii/lichii.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz Make the AppImage executable (chmod +x) and run it
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run lichii.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 zip PGO zip Both built with clang-cl and ThinLTO; the PGO zip adds a profile trained on Ocarina of Time

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip macOS 15 or newer. Not notarized: right-click and choose Open the first time, or run xattr -dr com.apple.quarantine lichii.app. eden-cli is inside the app, in Contents/MacOS

The PGO builds are the same programs compiled with profile-guided optimization. Linux uses clang with Eglantine's profile; Windows uses clang-cl and ThinLTO with a profile trained in Lichii on Ocarina of Time, so other games gain less. Prefer them when your CPU supports it.

Lichii nx2 build 130 (3dae119)

Choose a tag to compare

@github-actions github-actions released this 09 Nov 17:55
3dae119

⚠️ Delete your old pipeline cache before playing

This build uses a new shader cache (v2). To avoid stutter or problems from leftover caches of older builds, delete each game's old pipeline cache once:

  1. In Lichii, right-click the game in your game list.
  2. Choose Remove → Remove All Pipeline Caches and confirm.
  3. Repeat for each game you play.

Or delete the folder by hand (close Lichii first):

  • Windows: %APPDATA%\eden\cache\shader\. If you use a portable install, it's user\cache\shader\ next to lichii.exe.
  • Linux: ~/.cache/eden/shader/. If you use a portable install, it's user/cache/shader/ next to the AppImage.

Each game has its own folder, named after its program id (for example 0400486024DEC000 for Ocarina of Time). Delete the folders of the games you play, or the whole shader folder.

The first launch after this builds shaders again, so expect some stutter at first. It goes away as the new cache fills, and it stays filled on later launches.


What's new since build 125

Performance

  • ✅ Ocarina of Time faster: async read-back stops the GPU thread waiting on the GPU, about +17% (28 → 33 fps at Kokiri) (#1028)
  • ✅ Ocarina of Time faster again: memory-reading macros run on the back thread, so the front thread's wait is gone, about +8% more (#1056, port of jpkto's #805)
  • ✅ Donkey Kong Bananza faster: cheaper semaphore waits and descriptor reuse, +9% (14.7 → 16.1 fps at the Ingot Isle gate) (#949)
  • ✅ Bananza waits less: the restored semaphore mirror gives +0.4 fps and much shorter GPU waits (#979, #1014)
  • ✅ Frees a full CPU core: the HostTiming thread now sleeps instead of spinning, with no fps or audio change (#1016)

Stutter and shaders

  • ✅ New shader cache (v2): far fewer shaders built mid-game on relaunch (MKW 48 → 2 builds, hit rate 35% → 97%). Your old cache converts automatically in under half a second (#1036)

Memory

  • ✅ About 6 GB less RAM on Windows: all-zero memory pages are released. At Kokiri, OoT dropped from 13.4 to 7.2 GB with almost no pagefile writes (#961, built on Ghostwolf13's #431)

New features

  • ✅ .nx game support: load .nx archives, and convert NSP/XCI/NUP games with their updates and DLC to .nx (#923, fab918's #866)

Stability and fixes

  • Malformed PFS0, RomFS, NCA and XCI files no longer crash Lichii (#947, port of failaip12's Eglantine #462)
  • Fixed a use-after-free in the memory translation cache (#984)
  • Fixed a page-table overflow (#957)
  • Fixed texture-cache threshold log spam (#951)

For developers (off unless enabled)

  • The stutter trace with per-frame causes and long-frame detail, the shader cache bench, a memory trace and extra GPU profiling (#975, #1039, #951, #965)

Other

  • The README now warns that Lichii has no official website, only the game compatibility site (#1074)

Coming next (not in this build)

FSR 3.1 and FSR 4 for Ocarina of Time (AMD FSR 4 through AMD's official download, opt-in), a fix for Mario Kart World's texture-upload hitches, and the Bananza multi-core rebuild.


Automatic build of nx2 at 3dae119.

Linux

Linux packages come as an AppImage (self-contained, needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch) and a tar.gz (uses your system libraries, so Qt 6 and the usual libraries must be installed).

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz Make the AppImage executable (chmod +x) and run it
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run lichii.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 zip PGO zip Both built with clang-cl and ThinLTO; the PGO zip adds a profile trained on Ocarina of Time

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip macOS 15 or newer. Not notarized: right-click and choose Open the first time, or run xattr -dr com.apple.quarantine lichii.app. eden-cli is inside the app, in Contents/MacOS

The PGO builds are the same programs compiled with profile-guided optimization. Linux uses clang with Eglantine's profile; Windows uses clang-cl and ThinLTO with a profile trained in Lichii on Ocarina of Time, so other games gain less. Prefer them when your CPU supports it.

Lichii nx2 build 125 (cbb512e)

Choose a tag to compare

@github-actions github-actions released this 09 Nov 00:09
cbb512e

Big update since build 117: 68 changes, including shader precaching before a game starts, a faster Donkey Kong Bananza, Mario Kart World fixes and many Ocarina of Time fixes.

Recommended download: the PGO build.

What's changed

Performance

  • Donkey Kong Bananza runs faster. The split GPU back thread does less work per draw (#858, #921); 11.7 → 14.8 fps at the PR's test spot.
  • Shaders are precached before the game starts, so fewer hitches the first time you see an effect (#781, #812), and precaching uses less memory (#878).
  • Pipeline caches survive updates. A new cache version starts from the newest compatible cache instead of from scratch (#591), and only damaged, stale or duplicate records are dropped (#815).
  • Faster NUP loading. NUP files are only decompressed as far as the game reads (#885).
  • Cheaper ASTC texture uploads, from SmileyTatsu's fork (#296), and fewer redundant texture uploads (#817).
  • GPU threads are pinned to their own cores (#769), except on hybrid CPUs with few performance cores, where Windows schedules them (#698).
  • Graphics cards with lots of VRAM keep more textures before collecting (#268), and the GPU thread wastes less time polling and waiting (#621, #752).

Mario Kart World

  • The 30 fps lock and low-detail models are fixed when GPU Clocks is set to Boost or Overclock (#664).
  • Karts stay on the water and waves are back (#690).

Ocarina of Time

  • FPS Unlock is built in, and there's a new Switch 2 frame rate limit slider (#655).
  • Fixed a crash in the texture cache (#910).
  • Fixed the water flicker (#778, imported from Frizti's Fritchii v4), the red line in the tomb (#820) and missing geometry after a deferred clear (#699).
  • Fixed cutscene movies (#721, fixes #676).
  • OoT on GPUs without mesh shaders (such as the GTX 10 series) now builds its cached task and mesh pipelines at boot (#841, #642).

Other games

  • Mario Tennis Fever: Switch 2 controller button icons and face-button glyphs draw correctly (#691, #821).
  • Nintendo Switch 2 Welcome Tour: fixed decoder video frames (#689).
  • Switch 2 titles: new textures no longer start from stale memory (#818).
  • Movies: video stays in sync with audio (#659, #809), and AV1 video uses libdav1d explicitly (#879, #912).

AMD

  • Imported the easy AMD fixes from the CheezerWheezer fork (#679), and cooperative matrix shapes are only queried on supported cards (#614).

Stability and everything else

  • When the microphone can't open or start, games now get silence instead of a failed capture (#881).
  • Windows keeps fastmem by retrying its memory allocation instead of falling back (#645), and the long-path manifest is fixed (#576).
  • Motion controls work with fast sensors and recover when a sensor stops reporting (#712).
  • The English title is shown for NUP games (#738).
  • Many GPU correctness fixes: fences and queries (#687, #337, #718), cache invalidation (#700, #611, #816), shaders (#610, #902), macros (#688), textures (#575, #880) and command processing (#609, #488, #264).
  • Service stubs and fixes: vi2/nifm (#727), audio (#600), BCAT (#561) and mod folders (#686).
  • Build fixes, including macOS (#932).

Full list: build-117...build-125.


Automatic build of nx2 at cbb512e.

Linux

Linux packages come as an AppImage (self-contained, needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch) and a tar.gz (uses your system libraries, so Qt 6 and the usual libraries must be installed).

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz Make the AppImage executable (chmod +x) and run it
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run lichii.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 zip PGO zip Both built with clang-cl and ThinLTO; the PGO zip adds a profile trained on Ocarina of Time

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip macOS 15 or newer. Not notarized: right-click and choose Open the first time, or run xattr -dr com.apple.quarantine lichii.app. eden-cli is inside the app, in Contents/MacOS

The PGO builds are the same programs compiled with profile-guided optimization. Linux uses clang with Eglantine's profile; Windows uses clang-cl and ThinLTO with a profile trained in Lichii on Ocarina of Time, so other games gain less. Prefer them when your CPU supports it.

Lichii nx2 build 117 (89440b2)

Choose a tag to compare

@github-actions github-actions released this 07 Nov 22:39
89440b2

AMD regression fix. Build 116 crashed on AMD Radeon RX 6000 cards and older while Ocarina of Time built its shaders after boot. This build fixes that. Everything else is the same as build 116: see the build 116 release notes for the full changelog.

Recommended download: the PGO build.

What's changed

  • Fixed the AMD crash from build 116 (#657). On the Windows driver, RX 6000 (RDNA2), RX 5000 (RDNA1), Vega and Polaris cards crashed in amdvlk64.dll during the Ocarina of Time shader build. The driver reports matrix-core support on these cards even though they have none, so the faster matrix path from #583 now only runs on RDNA3 and newer. RX 7000/9000 and NVIDIA are unchanged. Thanks to nlz242 for bisecting it and testing the fix on an RX 6800 XT.

Common issues

  • White streaks or trails at night in Ocarina of Time (Navi, fireflies, smoke): turn off Emulation → Configure → Graphics → Use NVIDIA DLSS in place of a game's DLSS. This comes from DLSS, and a fix is being tested.

Known issues

  • Splatoon Raiders: characters look too dark, there is a green tint and FPS is lower than in earlier builds. This is being investigated.

Automatic build of nx2 at 89440b2.

Linux

Linux packages come as an AppImage (self-contained, needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch) and a tar.gz (uses your system libraries, so Qt 6 and the usual libraries must be installed).

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz Make the AppImage executable (chmod +x) and run it
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run lichii.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 zip PGO zip Both built with clang-cl and ThinLTO; the PGO zip adds a profile trained on Ocarina of Time

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip macOS 15 or newer. Not notarized: right-click and choose Open the first time, or run xattr -dr com.apple.quarantine lichii.app. eden-cli is inside the app, in Contents/MacOS

The PGO builds are the same programs compiled with profile-guided optimization. Linux uses clang with Eglantine's profile; Windows uses clang-cl and ThinLTO with a profile trained in Lichii on Ocarina of Time, so other games gain less. Prefer them when your CPU supports it.