Repository navigation
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.