Repository navigation
Changes since build 366
Built from nx2 at 00f580a94b3e368b1502727e98cdd6ad80b000cf.
Game fixes
- Fix the build 366 boot regression in Pokémon Pokopia 2.0.1 when the NUP stores the executable only in the update. #2362
- Fix the Windows file-lock error that aborts Ori and the Will of the Wisps when it replaces a Spirit Trial ghost. Adapted from xbzk's Eden patch. #2420
- Fix horizontal black bands on Final Fantasy Resonance battle sprites on GPUs without native 24-bit depth support, including AMD. #2421
- Stop some Ocarina of Time walls and floors from sampling the wrong textures while preserving Switch Sports Resort scenery. Ported from kraibse. #2384
- Fix an Ocarina of Time hang caused by interleaved GPU commands. Ported from kraibse. #2415
- Restore missing gloom on terrain and scenery in Hyrule Warriors: Age of Imprisonment. Ported from Rhys Denno (@rdenno). #2416
- Add a built-in 60 FPS patch for a compatible build of Super Mario Bros. Wonder – Nintendo Switch 2 Edition. Ported from Orchid. #2411
Mods and desktop
- Browse, install, update and remove supported mods in the new desktop Mod Store under Tools or a game's Add-Ons tab. #2405
- Add GitHub patch and cheat listings to the Mod Store and verify supported downloads before installing them. #2432
- Expand Simplified Chinese translations across settings, menus, What's New and other dialogs. Thanks to haidanQAQ. #1770
- Archive build 366 in What's New and show the new highlights after updating. #2434
Graphics and performance
- Turn off build 366's extra GPU render thread by default to avoid the performance regression some players reported. #2350
- Add a redesigned per-game Render thread (experimental) option under Graphics → Advanced. Based on Fritchii and off by default. #2425
- Process large ASTC texture arrays in batches on all GPUs during recompression to avoid spilling into system RAM, as seen in Ocarina of Time. #2393
- Improve Lichii Optical Flow frame generation for fast camera pans and fine detail such as pixel art. Ported from sheepbun. #2386
- Add FlyHigh as an optional Vulkan frame generation mode for SDR on 64-bit Windows. Based on work by MONZikWasTaken. #2406
- Preserve memory protections on Windows when games free part of an allocation, so cached textures and buffers don't go stale. Ported from Dimitris Zervas. #2361
- Reduce periodic texture-cache overhead with a cheaper Windows memory check. Ported from DuskDarf1. #2358
- Skip unmapped texture regions rather than accessing invalid memory during uploads, an issue seen in Metroid Prime 4. Ported from mastorok. #2360
- Prevent linear texture uploads from writing past the end of their destination buffer. Ported from azeselh. #2414
- Add an opt-in Vulkan watchdog that logs and exits if the GPU stops responding instead of letting Lichii hang indefinitely. #2402
- Prevent an OpenGL compute and video-decoding race that could crash Lichii. #2436
Shader loading
- Make Precompile All Shaders remember to precache that game automatically on future launches. #2344
- Show how many shader builds are left in the status bar. Thanks to Reiixan. #1800
- Keep the shader progress counter from getting stuck when a queued compute shader build is canceled. Thanks to Reiixan. #1799
- Reuse newly saved Vulkan pipeline binaries in the same session on supported drivers and log shader cache deletions. #2349
- Give macOS shader compilation more stack space to prevent a crash seen in Ocarina of Time. Based on work by auz466. #2354
- Fix a crash when saving the Vulkan pipeline cache after shader precompilation, observed on Apple Silicon. Thanks to danieljesus. #2346
Diagnostics, tests and builds
- Fix the macOS build of the Mod Store without changing how downloads work. #2437
- Keep each running Lichii instance from moving or overwriting another instance's log on Linux, macOS and Android. Thanks to danieljesus. #2256
- Include compute shader IDs in Vulkan GPU logs so a dispatch can be traced to its shader. #2347
- Add opt-in Switch 2 audio codec tracing to help diagnose missing dialogue, including the Star Fox report. #2367
- Make detailed GPU command timing opt-in so ordinary frame traces no longer inject those periodic stalls. Thanks to pabCMX. #1811
- Add Super Smash Bros. Ultimate's title ID to the bug-report guide. #2430
- Update the debug adapter test to include the new render-thread control. #2428
- Run missing-header-key tests even on machines with keys installed, without changing key files. Thanks to Reiixan. #1841
- Speed up release builds by reusing compiler and dependency caches, including Windows link results. #2370
- Fix Windows release cache cleanup so old build caches don't pile up. #2377
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) | DMG · 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.