VERY experimental Nintendo Switch 2 emulator
  • C++ 63.5%
  • cpp 26.4%
  • POV-Ray SDL 4.2%
  • Kotlin 3.6%
  • CMake 0.8%
  • Other 1.4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Zortos 3bdd53d08a
Merge nx2 CI fixes with the Fire Emblem upscaler workaround
Assisted-by: GPT-6 Astra (integration and verification)
2026-11-02 23:20:31 +01:00
.ci [tools] refactor, use #!/bin/sh, update license files (#3998) 2026-05-22 21:15:31 +02:00
.forgejo/workflows [ci] Only update translations once a week (#4256) 2026-08-08 05:46:52 +02:00
.github Compensate Fire Emblem upscaler jitter without frame history 2026-11-02 23:20:31 +01:00
.patch [cmake] Use a debloated boost distribution (#4198) 2026-09-15 07:22:23 +02:00
.reuse [qt] nuke game compat list (again) (#4201) 2026-07-12 09:32:11 +02:00
.tx [cmake] feat: FFmpeg CI, allow 16kb android builds, update translations for transifex (#2543) 2025-09-23 19:38:11 +02:00
CMakeModules Rebrand desktop emulator as Lichii 2026-11-02 22:29:30 +01:00
dist Rebrand desktop emulator as Lichii 2026-11-02 22:29:30 +01:00
docs Compensate Fire Emblem upscaler jitter without frame history 2026-11-02 23:20:31 +01:00
externals Merge pull request #218 from Djihads80/fix/nx2-video-av1 2026-11-01 17:25:14 +01:00
hooks [tools] refactor, use #!/bin/sh, update license files (#3998) 2026-05-22 21:15:31 +02:00
LICENSES general: fix trailing whitespace 2024-01-08 09:34:32 -05:00
src Compensate Fire Emblem upscaler jitter without frame history 2026-11-02 23:20:31 +01:00
tools Rebrand desktop emulator as Lichii 2026-11-02 22:29:30 +01:00
.codespellrc core: refactor emulated cpu core activation 2023-12-04 10:37:16 -05:00
.git-blame-ignore-revs Skip git blame 2023-11-04 18:26:49 +00:00
.gitattributes chore: make yuzu REUSE compliant 2022-07-27 12:53:49 +02:00
.gitignore [chore] re-add out/ to .gitignore (#4578) 2026-10-26 16:23:23 +01:00
.shellcheckrc [tools, cmake] refactor: update/hash check scripts, use tags for some more deps, proper CPMUtil separation (#2666) 2025-10-05 03:04:53 +02:00
AGENTS.md [docs] revise AI policy (#4522) 2026-10-13 23:54:51 +02:00
CMakeLists.txt Rebrand desktop emulator as Lichii 2026-11-02 22:29:30 +01:00
CONTRIBUTING.md [docs] revise AI policy (#4522) 2026-10-13 23:54:51 +02:00
cpmfile.json Merge pull request #218 from Djihads80/fix/nx2-video-av1 2026-11-01 17:25:14 +01:00
Doxyfile chore: make yuzu REUSE compliant 2022-07-27 12:53:49 +02:00
eglantine.profdata Added FSR 4 and AMD Boost 2026-10-31 22:20:08 +01:00
LICENSE.txt chore: make yuzu REUSE compliant 2022-07-27 12:53:49 +02:00
NX2_GPU_THREAD_SPLIT.md video_core: GPU thread split on by default for Switch 2 titles; cheaper front paths 2026-10-29 20:49:48 -04:00
NX2_NOTES.md NX2_NOTES: task/mesh programs and their support 2026-11-01 11:29:35 -05:00
README.md Rebrand desktop emulator as Lichii 2026-11-02 22:29:30 +01:00
shell.nix fix: nix shell script 2026-11-01 18:51:59 +00:00

Lichii

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.

Downloads and setup

Published builds belong on this fork's releases page. The repository still uses its historical Eglantine name; the desktop application is now Lichii.

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.

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 policy. Some inherited documentation and internal build target names still use upstream names. The GUI build target remains yuzu; its output is lichii.exe on Windows and lichii on other desktop platforms.

Keep changes focused and distinguish code-level checks from actual gameplay testing.

Artwork

The supplied Lichii logo, icon and library artwork are in dist/branding. Windows, Linux and macOS icon resources are generated from that artwork by Generate-LichiiIcons.ps1.

Credits and license

Lichii inherits the work of the Eglantine, Eden, yuzu and Sudachi projects and their contributors, including Eglantine's original developer Camille LaVey. Original copyright notices and third-party licenses are retained.

See LICENSE.txt and the source files for applicable license terms.