No description
  • C++ 63.4%
  • cpp 26.7%
  • POV-Ray SDL 3.9%
  • Kotlin 3.4%
  • CMake 0.8%
  • Other 1.7%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Zortos 8813b44794
Merge pull request #118 from zortos293/docs/renderdoc-debug-workflow
AGENTS: use RenderDoc alongside the live debug server
2026-11-05 14:06:11 +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 ci: keep Lichii's release-binaries workflow only 2026-11-05 09:45:02 +00:00
.patch [cmake] Use a debloated boost distribution (#4198) 2026-09-15 07:22:23 +02:00
.reuse Preserve Windows PGO shader, audio, upscaling and NUP changes 2026-11-03 22:47:19 +00:00
.tx [cmake] feat: FFmpeg CI, allow 16kb android builds, update translations for transifex (#2543) 2025-09-23 19:38:11 +02:00
CMakeModules Fix Lichii release update checks and platform downloads (#82) 2026-11-04 19:31:27 +00:00
dist Fix Mario Tennis Fever device loss when the first court loads (#38) 2026-11-04 07:19:33 +01:00
docs debugger: opt-in live debug server and MCP adapter (#111) 2026-11-05 11:48:53 +00:00
externals Preserve Windows PGO shader, audio, upscaling and NUP changes 2026-11-03 22:47:19 +00: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 shader: lower the green-hat kid adventure's 1080p upscaler gathers (#112) 2026-11-05 12:46:18 +00:00
tools debugger: opt-in live debug server and MCP adapter (#111) 2026-11-05 11:48:53 +00: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 AGENTS: pair RenderDoc captures with live emulator diagnostics 2026-11-05 13:04:05 +00:00
CHANGELOG.md feat: implemented coderabbit suggestions 2026-11-04 21:40:07 +01:00
CMakeLists.txt Fix Lichii release update checks and platform downloads (#82) 2026-11-04 19:31:27 +00:00
CONTRIBUTING.md Improve release build caching and remove inherited contribution policies (#31) 2026-11-03 10:48:32 +01:00
cpmfile.json Merge upstream Eglantine nx2 (#37) 2026-11-04 00:41:39 +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 README: reword the donation section (#108) 2026-11-05 10:29:45 +01:00
shell.nix fix: nix shell script 2026-11-01 18:51:59 +00:00
VERSION ci: whole new ci, needs a lot of review, this is draft 2026-11-04 21:19:45 +01: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 guidelines. 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

Art created by YOB (yobslab) 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.

Support Lichii

Lichii is free and stays free. If you want to help, you can donate in crypto. Donations help pay for the AI tools and build machines used to develop this open-source project faster.

Solana (SOL)

JepEjfyWjGjhJvHSrqj52KtLjcbbbmUh1iGqerYBF4w

Ethereum (ETH)

0x055ABa1b80Bc35C836Ce7E9F47c2b3d6C75b5534

Bitcoin (BTC)

bc1qcvxdpf4qvdhqp8ee4s355cjmxrzsphsdwpl8w4

BNB Smart Chain (BNB)

0x055ABa1b80Bc35C836Ce7E9F47c2b3d6C75b5534

Polygon

0x055ABa1b80Bc35C836Ce7E9F47c2b3d6C75b5534

Send each coin on its matching network. Coins sent on the wrong network can't be recovered.

Note

Donations are voluntary gifts and are non-refundable. A donation does not buy any product, service, perk, early access, exclusive build, priority support or say in the project. Every release stays free and public for everyone.

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.