README

⚠️ Lichii has no official website ⚠️

 [!CAUTION]
 Lichii has no official website. The only site run by this project is the game compatibility website, lichii.zortos.me, for compatibility reports only. Download Lichii only from this repository's releases page. Any other "Lichii" website or download (such as lichii.org) is not ours and may contain malware (545).


  


 Lichii

Lichii is an experimental, open-source Nintendo Switch and Switch 2 emulator written in C++. It builds on Eglantine, Eden, yuzu and Sudachi, preserving their contributions while developing this fork's game compatibility and renderer fixes.

This is an independent fork, not an official release of those upstream projects. Lichii is not affiliated with Nintendo.

Visit the Lichii game compatibility website to find games and compare community compatibility reports.

 Downloads and setup

Download Lichii only from this repository's releases page. Lichii has no other download site: archives offered elsewhere, such as lichii.org, are not built by this project, and one has been reported to install malware (545).

On Windows, extract the entire build archive and run lichii.exe. Only use games and system files you have legally obtained. Games, keys and firmware are not included.

 Existing saves and settings

The rebrand intentionally retains the existing Eden/Eglantine data directories and configuration keys. It does not move or delete saves, settings or shader caches. Back up your saves before testing experimental builds.

 Compatibility and issue reports

Compatibility and performance vary by game, hardware and driver. Rendering errors, stutters and crashes remain possible. Passing automated tests does not establish that a game renders correctly, and this project makes no universal frame-rate guarantee.

Browse community compatibility reports for results with each player's build and setup.

Desktop reporting requires a build containing PR 303 and is not available in build 88. In builds that include it, play and stop a Switch 2 game, then right-click that game and choose Submit compatibility report. Only the latest session in the current Lichii process is eligible.

Confirm the matching website catalog entry and review the editable machine, game, setup, and enabled add-on details prefilled where available. Check the public preview and give explicit consent before submitting. Nothing uploads automatically, and the native v1 reporter does not read or upload logs or files.

When reporting an issue, include:

- The exact build, game version, CPU, GPU and driver version.
- Relevant settings and steps to reproduce the problem.
- A screenshot and the log from the affected session, after checking it for personal information.

Do not upload game files, keys, firmware or private account information.

 Building and contributing

See the build guide, user documentation and coding guidelines. Some inherited documentation and internal build target names still use upstream names. The GUI build ta

Top issues

Latest release

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 pa