Graphics
Start with the graphics settings described in your build's release notes. Change one setting at a time and keep the build tag with any result you record.
For a game-specific starting point, open its compatibility report.
Install and troubleshoot
Lichii Emulator Setup & Troubleshooting
Go from a fresh download to your first launch. Set up your controls, bring in your games, and get past the problems standing in the way.
Latest recorded build
build-88
Pre-release
Published November 6, 2026
Three platforms
How to Install Lichii Emulator
Choose your platform for a step-by-step install.
Lichii Setup on Windows
- Download the current Windows file(s) lichii-windows-x86_64.zip (x86_64) from the official build-88 and keep the original filename.
- Extract the archive into a folder you can write to. Do not run an executable directly from the compressed archive.
- Start lichii.exe from the extracted folder. If Windows shows a security prompt, verify that the file came from the official release link before choosing whether to continue.
Need a different package? Browse windows downloads.
Lichii Setup on Linux
- Choose the published Linux file lichii-linux-aarch64.AppImage (arm64), lichii-linux-aarch64.tar.gz (arm64), lichii-linux-x86_64.AppImage (x86_64), lichii-linux-x86_64.tar.gz (x86_64) whose architecture matches your system, then download it from the linked release.
- For lichii-linux-aarch64.AppImage, run chmod +x 'lichii-linux-aarch64.AppImage' in the directory containing the download, then launch that AppImage.
- For lichii-linux-aarch64.tar.gz, extract the archive first and launch the included executable from the extracted folder. If it reports a missing glibc or Qt dependency, check the selected release notes and issue source for the required version.
- Keep the release URL and build tag with the installed file so a later compatibility result can be matched to the same build.
Release guidance
- Linux AppImage requires glibc 2.39 or newer.
- Linux tar.gz uses system libraries; Qt 6 and the usual libraries must be installed.
Need a different package? Browse linux downloads.
Lichii Setup on macOS
- Choose the published macOS file lichii-macos-arm64.dmg (arm64), lichii-macos-arm64.zip (arm64) whose architecture matches your system, then download it from the linked release.
- For lichii-macos-arm64.dmg, open the DMG and move the application to a location you control, such as Applications.
- For lichii-macos-arm64.zip, open the ZIP, move the application to a location you control, then right-click it and choose Open the first time if macOS asks for confirmation.
- If macOS displays a security warning, check the download against its official release before proceeding. Keep normal system protections enabled.
- Launch Lichii from the application location you chose.
Release guidance
- macOS arm64 package requires macOS 15 or newer.
Need a different package? Browse macos downloads.
First launch
Initial Configuration
Make the first launch yours: a comfortable controller layout, the right graphics settings, and your own game library.
Input devices
Connect your controller, map the buttons, then save the profile. If a button doesn't work, search for your controller model and Lichii build in the troubleshooting section.
Your game files
Add your own legally obtained games through Lichii's library or game-file control. Games, keys, and firmware are supplied separately.
Current official setup notes
- Games and system files are not included; use only games and system files you have legally obtained.
- The rebrand retains the existing Eden/Eglantine data directories and configuration keys. It does not move or delete saves, settings or shader caches.
- Back up saves before testing experimental builds.
- Before changing settings, try booting games with stock options.
Get back to the game
Common Lichii Errors and Fixes
128 issue entries
No issue matches that search. Check the release notes or try the exact error text.
GitHub issue · open
macOS/MoltenVK: Ocarina of Time (0400486024DEC000) kills or hangs the Metal device at the intro-video boundary
On macOS arm64 through MoltenVK, the Metal device may be lost or the GPU thread may hang at the intro-video/gameplay boundary. A commenter attributes the device loss to an attachment-less framebuffer reaching 32768×32768, above the stated Apple GPU limit of 16384.
GitHub issue · open
macOS/MoltenVK: Ocarina of Time (0400486024DEC000) kills or hangs the Metal device at the intro-video boundary
After a local workaround for device loss, a commenter reports that the 3D scene remains black while sound and subtitles work on an older Eglantine fork; current nx2 behavior was not yet checked.
GitHub issue · open
[VBug]
In stages past the first one, the gameplay screen is black while the UI remains visible; pausing shows the world rendered in the background.
GitHub issue · open
[Crash]
User reports a crash when opening the game on Arch Linux with an AMD Radeon AI PRO R9700 (9070XT); the console reports a segmentation fault.
GitHub issue · open
[Crash] AMD Crash/AudioDesync
User reports audio/video desynchronization during the opening cutscene and a system freeze at the Deku Tree cutscene on Vulkan with an AMD RX 9000 series GPU. Comments report crashes on AMD GPUs, including while building shaders. One commenter reports that OpenGL GLSL stops the crashes but leaves only the UI visible.
GitHub issue · open
[AMD RX 9070 XT] Black screen with UI visible and GPU driver timeout (Build 88)
On some AMD GPUs, the UI may remain visible while the 3D world is black; reports also describe AMD driver timeouts or crashes.
GitHub issue · open
[VBug] Black Rendering
A user reports black visuals except for the UI after starting a new game, while audio is audible.
GitHub issue · open
[VBug] Black Rendering
A commenter reports that the PGO build produces a black screen in both docked and handheld modes.
GitHub issue · open
[Crash] An error occured initializing the video core
While booting an unidentified "little green hat adventure game," the emulator reports an error initializing the video core, suggesting outdated GPU drivers. On OpenGL, the game launches but shows a black screen while sound works. The reporter says their RX 9070XT drivers are updated; a commenter reports the same problem with a 7000 series GPU.
GitHub issue · closed
[GBug] Mario Kart World – Severe Performance Regression in Build 75
User reports a performance regression in Build 75 on Linux with an AMD RX 6000 series or older GPU: around 10 FPS on the title screen, barely reaching 15 FPS with constant stuttering, GPU usage at 100%, and RAM usage increasing nonstop.
GitHub issue · open
[GBug] Pokémon Pokopia: black screen (only character outlines and UI are visible)
Only character outlines and UI are visible after launching the game.
GitHub issue · open
[Crash] Ocarina of Time (0400486024DEC000): freezes in Hyrule Castle Town pot room near the guard
User-reported reproducible freeze when walking deeper into the pot room in Hyrule Castle Town, near the guard.
GitHub issue · open
[GBug] Green hat kid bushes, shrubbery and grass turn dead when approaching too close.
Shrubbery, bushes, and grass turn dead-looking when approached in Hyrule Castle, especially in Zelda's garden. A user reports that it still occurs in build 83.
GitHub issue · open
[GBug] Ocarina of Time (0400486024DEC000): gameplay settles at ~29 fps, CPU-bound on two cores (build 75)
User reports describe gameplay performance below 60 FPS on multiple systems and builds. One report also describes a black 3D screen in Handheld mode; switching to Docked allowed rendering.
GitHub issue · open
[GBug] Ocarina of Time (0400486024DEC000): gameplay settles at ~29 fps, CPU-bound on two cores (build 75)
A user report says resolution 2X caused flicker or line artifacts; a separate candidate-build report says the release's overexposure warning was not cleared by its limited test.
GitHub issue · open
[Crash] AMD Ocarina of time Doesn't Start
The issue reporter using an AMD RX 6600 8GB on Windows 10 reports that the emulator starts loading and then remains on a black screen.
GitHub issue · open
[Crash] AMD Ocarina of time Doesn't Start
Commenters report rendering failures, black screens, and AMD driver crashes; one reports that audio continues while rendering is crashed.
GitHub issue · open
Ocarina of Time: frame dump findings (overlay source, bloom/exposure, missing vegetation, rejected gathers)
A half-resolution layer drawn by pixel shader c72b6ea746c00433 causes dark blotches and translucent patches over objects in reported scenes. Users traced the issue to an occlusion-depth copy being wiped by deferred clears before the layer samples it.
Suggested fix: A user-reported workaround is EDEN_NX2_REJECT_HASH=c72b6ea746c00433; it removes the blotches in tested scenes but removes the river's visible water surface. Another user described PR #185 as fixing the ordering issue, but did not provide a tested result for that fix.
GitHub issue · open
Ocarina of Time: frame dump findings (overlay source, bloom/exposure, missing vegetation, rejected gathers)
The Deku Tree exterior cutscene can render black except for a small area around Navi; a user also reported an AMD graphics-driver crash while building graphics pipelines in that scene.
GitHub issue · open
Ocarina of Time: frame dump findings (overlay source, bloom/exposure, missing vegetation, rejected gathers)
Users reported missing grass, ferns, and broadleaf vegetation, with associated haze or overexposure in Kokiri Forest. A user reported that a local build with listed rendering commits restored grass and ferns and removed heavy haze in one location; a later comment proposed PR #204 for stale occlusion-query reads, but did not report a test result for that PR.
GitHub issue · open
Ocarina of Time: frame dump findings (overlay source, bloom/exposure, missing vegetation, rejected gathers)
A user reported river-water flicker depending on sun direction relative to the camera; the proposed link to lighting or light volumes was unconfirmed.
GitHub issue · open
Ocarina of Time: frame dump findings (overlay source, bloom/exposure, missing vegetation, rejected gathers)
A user reported zero-format texture assertions, Unmapped Device ReadBlock errors, and flickering terrain and subtitles; causation was not established.
GitHub issue · open
Ocarina of Time (Switch 2) gets stuck at "Building 9 shaders" on AMD RX 6750 XT
On AMD RDNA2 GPUs, the game may freeze during shader or pipeline building, sometimes with background audio continuing. A commenter also reports black-screen or shader-building hangs with asynchronous shader compilation enabled.
GitHub issue · open
[GBug] Ocarina of Time (0400486024DEC000): intro freezes for 6 to 18 minutes on AMD while the driver optimizes two compute shaders
On AMD's proprietary Windows driver, two compute pipelines can take 6 to 18 minutes to compile during the intro, leaving the game at 0 FPS while audio continues. Rejecting the shader hashes avoids the wait but causes black areas in the intro, title, and castle scenes.
Suggested fix: Leave the game at the intro for about 20 minutes once so both pipelines finish and are cached; later boots reportedly pass the intro immediately until the driver or Lichii is updated. Alternatively, set `EDEN_NX2_REJECT_HASH=eff3ccbe1438679d,f9ea14a22394f5b1`; this avoids the wait but leaves parts of the picture black.
GitHub issue · open
[Perf] OoT (0400486024DEC000): per-fence Preflushable buffer downloads (~430 MB/s) are the biggest GPU back-thread cost; batching them gives +55% draws/s but breaks exposure
In the measurement-only experiment, disabling per-fence Preflushable downloads or batching downloads by 64 fences caused overexposure in Kokiri Forest.
GitHub issue · open
[Perf] OoT (0400486024DEC000): per-fence Preflushable buffer downloads (~430 MB/s) are the biggest GPU back-thread cost; batching them gives +55% draws/s but breaks exposure
A commenter reports that an experimental compute storage write-extent analysis reduced marked GPU-written data and fence copies while preserving correct auto-exposure. It was described as code on a user's branch, not as an upstream or validated release fix.
GitHub issue · open
[Perf] OoT (0400486024DEC000): per-fence Preflushable buffer downloads (~430 MB/s) are the biggest GPU back-thread cost; batching them gives +55% draws/s but breaks exposure
Static review and a separate research comment describe read-trap bookkeeping and dirty-state issues that can leave stale GPU-written data when per-fence downloads are disabled; proposed corrections and batching remain untested or local experiments.
GitHub issue · open
[VBug] OoT Slows when booting.
Slows when booting.
GitHub issue · open
Ocarina of Time harvest fork: findings and open tasks
Community comments describe AMD black or corrupted-world output, fragment-pipeline compiler crashes on Windows, later timeouts or TFB stalls, corrupted output, and a RADV depth-image SPIR-V failure. These are separate reported cases; the comments do not establish a universal cause or resolution.
GitHub issue · open
[Crash] Linux/RADV (RX 9070 XT): invalid SPIR-V fragment shader (depth image u32 sampled as f32) segfaults in VkPipelineBuild, Ocarina of Time
User reports a segfault during gameplay on Linux with an AMD RX 9000-series GPU and RADV, when a graphics pipeline is built for an invalid fragment shader.
GitHub issue · open
Old Gtx e new rtx, same fps
GitHub issue · open
[Crash]
User reports repeated crashes around Deku Tree, followed by booting getting stuck compiling shaders; deleting the shader cache allows booting again. Another user reports the problem only with RADV.
Suggested fix: Deleting the shader cache allows booting again, according to the user report.
GitHub issue · open
[Bug] Windows build-83 can hang on Closing software after OoT gameplay
On Windows build-83, shutdown can hang at “Closing software…” after gameplay. Some sessions completed shutdown successfully; the cause is undetermined.
GitHub issue · open
[VBug] playing mario kart world but textures wont load. also crashes when playing the grand prix race
A user reports missing textures and buggy visuals after booting, occasional startup crashes, and crashes when playing the Grand Prix race on build-83 with Intel integrated graphics on Windows 11.
GitHub issue · open
[VBug] fairy fountain invisible green hat boy game
GitHub issue · open
[GBug] OoT (0400486024DEC000): the same ~60 cached graphics pipelines are rebuilt on the GPU thread every boot
Persistent graphics pipeline cache entries are reportedly rebuilt on the GPU thread during gameplay on repeated boots, causing a visible hitch.
GitHub issue · open
[VBug] Oot is in a "nightmare mode"? also gameplay speed is at like 30%
With GPU Mode: Accurate (High), gameplay may run in slow motion at about 30 FPS; shader compilation can cause stutter on new content.
Suggested fix: Set GPU Mode to Fast; the commenter reports this resolved the slow gameplay for their setup.
GitHub issue · open
[GBug] literally The Legend of Green
The issue title says “literally The Legend of Green,” but the game field is “Other / not listed”; no specific compatibility symptom is stated.
GitHub issue · open
[GBug] Black Screen In AMD - Zelda Ocarina Of Time
Black screen after boot; some reports say sound and the title/logo work.
GitHub issue · open
[GBug] Black Screen In AMD - Zelda Ocarina Of Time
On build-83, one user reports a solid-green displayed image although a screen capture shows the game rendering correctly.
GitHub issue · open
[GBug] Black Screen In AMD - Zelda Ocarina Of Time
On build 83, a user reports device loss at gameplay start with VK_ERROR_DEVICE_LOST.
GitHub issue · open
[Crash] Ocarina of Time: AMD RX 7900 XTX driver timeout / device lost at gameplay start, gone with #150 reverted
User reports GPU driver timeout or device loss when gameplay starts on AMD Windows systems, including RX 7900 XTX and RX 9060 XT. Reports associate the issue with #150 pointer-binding changes, but this is an unconfirmed hypothesis.
GitHub issue · open
[GBug] Ocarina of Time on RADV (RX 9070 XT): 28-35 fps, 35 ms frame with no saturated thread (translation/sync bound)
PGO artifact crashes in dynarmic with Unhandled SIGSEGV after 2–10 minutes on the reported machine.
GitHub issue · open
[VBug] start up on OoT remake screen plays, but after that only audio and a black screen
After the startup screen, audio plays but the screen is black.
GitHub issue · open
[GBug]
GitHub issue · open
[Crash] Loading Shaders AMD
The emulator closes while loading shaders before a game is opened; the report says it used 20GB of RAM. Reports mention Windows 11 and Linux, and AMD GPUs.
GitHub issue · open
10-20 min BUILD 83] Legend of Green hat boy Crash
User reports the game crashes after about 15 to 20 minutes.
GitHub issue · open
[VBug] Regression: Legend of green hat blacks out
User reports the game blacks out when booted in build 83; they state it worked in build 75.
GitHub issue · open
[Crash after 5 - 10min BUILD 83] Legend of Green hat boy (PGO Crashes on boot)
The emulator crashes after 5 to 10 minutes of gameplay on Linux with an AMD RX 9000 series GPU.
GitHub issue · open
[GBug] Zelda: Ocarina of Time (0400486024DEC000): the audio plays a different part of the stream than the picture
Clean audio from a different point of the game plays while the intro image is displayed; audio and picture are substantially out of sync.
GitHub issue · open
Ocarina of Time (0400486024DEC000) build-75: macro parameter desync + unknown texture format 100, broken lighting/bloom and corrupted textures
On build-75, user reports over-bright bloom/glow, overly dense fog, incorrect lighting, and some textures decoded as garbage; logs include macro-parameter assertions and an unknown texture format 100.
GitHub issue · open
[VBug] OoT (0400486024DEC000): textures flicker with Low GPU accuracy + EDEN_NX2_SPLIT=2 on AMD RX 9070 XT; High fixes it but turns the split off (~9 fps)
Textures and surfaces flicker with Low GPU accuracy and EDEN_NX2_SPLIT=2 on Radeon RX 9070 XT; some surfaces remain white temporarily.
GitHub issue · open
[VBug] OoT (0400486024DEC000): textures flicker with Low GPU accuracy + EDEN_NX2_SPLIT=2 on AMD RX 9070 XT; High fixes it but turns the split off (~9 fps)
Outdoor haze is very strong, and the river surface can appear dark or black.
GitHub issue · open
[VBug] OoT (0400486024DEC000): textures flicker with Low GPU accuracy + EDEN_NX2_SPLIT=2 on AMD RX 9070 XT; High fixes it but turns the split off (~9 fps)
A commenter reports being unable to load a save, with the PC hard-locking or freezing before recovering after a driver crash or timeout; same GPU, 32GB RAM, and i7 9700K.
GitHub issue · open
Donkey Kong Bananza: terrain missing (white/black) on builds 70 and 75, renders correctly on build 65
On Windows builds 70 and 75, terrain/world renders solid white while the HUD and characters still render. On build 75, EDEN_NX2_RESETFIX=0 changes the ground to black with no texture or lighting.
GitHub issue · open
[GBug] Fast Fusion runs at max 24 fps
GitHub issue · open
[Crash] Kirby Air Raiders force quit in "Loading Shaders" screen
The emulator force quits after being stuck on the "Loading Shaders" screen for about 2 seconds.
GitHub issue · closed
[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)
The 3D gameplay scene can appear black while the HUD remains visible.
Suggested fix: Switch to Docked mode; one commenter reported this resolved the black screen. Other reports say this workaround did not help.
GitHub issue · closed
[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)
A commenter reported stuttering, FPS drops, and overexposure after switching to Docked mode.
GitHub issue · closed
[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)
A commenter reported flickering shadows and trees with no leaves.
GitHub issue · closed
[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)
A commenter reported audio playing ahead of the video during the intro.
GitHub issue · open
[VBug] OoT Black screen after the first cutscene and weird vhs filter in docked mode
Black screen after the first cutscene in handheld mode and VHS-like visual filter in docked mode.
GitHub issue · open
[VBug] black screen and slow stuttery dialogue
After the intro, the scene where the deku tree is talking is completely black with very slow, stuttery dialogue.
GitHub issue · open
[GBug] Mac: 20 fps + audio cuts in and out
GitHub issue · closed
[VBug] Green-hat adventure game boots to black screen, only audio, on mac
Boots to a black screen with audio on macOS.
Suggested fix: Clear the cache and launch again.
GitHub issue · open
[Crash]
On Radeon RX 580, hangs at a black screen at 0 FPS while building compute pipelines as the intro video starts.
GitHub issue · open
[VBug] Video doesn't display on Zelda Ocarine of time
Black screen after starting a new game, with audio continuing; a commenter also reports an FFmpeg error stating there is no decoder for video/av1.
Suggested fix: A commenter reports that using the MSVC build instead of the PGO build worked for them. Other commenters report that shared settings resolved the black screen, and one reports that switching from handheld to docked mode resolved it.
GitHub issue · open
[VBug] Video doesn't display on Zelda Ocarine of time
Very low FPS and graphics problems, including missing textures, lighting or ambient occlusion issues, and a blown-out white image.
GitHub issue · open
[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)
With use_disk_shader_cache = true, subsequent boots hang indefinitely at Loading Shaders 25 / 27.
Suggested fix: Delete cache/shader/0400486024dec000 and set use_disk_shader_cache = false; the reporter says this resolves the startup freeze.
GitHub issue · open
[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)
Black screen after the intro on AMD RX 9070 XT; the game's 1080p upscaler shader is rejected.
Suggested fix: Comment reports that #112 fixes the shader rejection; its CI build is fix/oot-upscaler-gathers / 7459f10 (build-80), and the fix is on nx2, but not in a release yet.
GitHub issue · open
[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)
On AMD, the world is black except around Navi and Link; an RX 6800 XT reporter says the workaround still leaves all 3D geometry black.
Suggested fix: Comment reports that #127 fixes AMD-only demote reordering. Before it is merged, setting EDEN_NX2_REJECT_HASH=e40561a7a0f7a0b3 in %APPDATA%\eden\nx2_switches.txt makes the world visible on the RX 9070 XT report; another reporter says it does not resolve 3D rendering on the RX 6800 XT.
GitHub issue · open
[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)
Texture flicker with Low GPU accuracy and GPU thread split on AMD RX 9070 XT.
GitHub issue · open
[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)
Handheld mode is reported as much brighter and blurrier than Docked mode.
GitHub issue · open
[GBug] StarFox: nx2_sysmix accepts a constant 70.32% of mixer output, so audio plays as "robot voice"
User reports heavily distorted speech, music, and effects (“robot voice”) on build 70. Comments clarify that the approximately 0.7032 accepted/copied ratio reflects retries rather than lost samples; possible causes discussed include emulated time running ahead of wall time or slow host audio draining, but the cause is not confirmed.
GitHub issue · open
[VBug] Ocarina of Time: AV1 cutscenes render solid green on AMD/RADV (audio and subtitles OK)
On Linux with AMD/RADV, AV1 intro cutscene video renders solid green while audio and subtitles work.
GitHub issue · open
[VBug] Ocarina of Time: AV1 cutscenes render solid green on AMD/RADV (audio and subtitles OK)
On Windows 10 with AMD, the intro AV1 cutscene shows a black video layer with working audio and subtitles, then the emulator hangs indefinitely.
GitHub issue · open
[VBug] OOT eventually turns into hard black screen outside of captions in handheld mode, renders as though looking through vaseline in docked mode
Black screen or intermittent black-screen flashes during gameplay and GDT; additional reports describe distorted docked rendering, overly bright and low-resolution handheld rendering, and intro audio ahead of video.
GitHub issue · open
[Build] Tree does not compile with clang-cl on Windows (NOMINMAX and FARPROC casts)
A local ClangCL build of b8c812b18 stalled at max present 8 and showed no frames; a local MSVC build of the same commit stalled at max present 8 and died within a minute, unlike the reported build-75 release.
GitHub issue · open
[Build] Tree does not compile with clang-cl on Windows (NOMINMAX and FARPROC casts)
clang-cl configure/compile failures are reported from min/max macros exposed by windows.h and direct FARPROC-to-function-pointer casts.
Suggested fix: The commenter says PR #164 contains the NOMINMAX/WIN32_LEAN_AND_MEAN definitions and two FARPROC cast changes that resolved the compile failures.
GitHub issue · closed
[VBug] OOTRemake only title screen, no video and ui (only sound)
User reports a black background at the title screen and a black screen after starting a new game, with sound still audible.
GitHub issue · open
[GBug] Ocarina of Time / Audio Desync
User reports audio/video desynchronization on the title screen and intro; a commenter reports slow-motion live-rendered title-screen video with audio leading by approximately three seconds, worsening by the initial dream cutscene.
GitHub issue · open
[VBug] [nx2-build-75] Zelda: Ocarina of Time (0400486024DEC000) black screen — no AV1 decoder
User reports a black screen after the game's AV1 video streams fail to decode; FFmpeg reports no decoder for "video/av1". The game idles indefinitely on a black frame.
GitHub issue · open
[GBug] Audio disappears the legend of zelda
Music disappears during the cutscene after booting the game.
GitHub issue · open
[VBug] OoT (0400486024DEC000): world renders black except areas lit by Navi and around Link, AMD RX 9070
In gameplay, the world renders almost entirely black, with only the HUD and some areas near light sources visible; some shapes appear blown out with heavy bloom.
GitHub issue · open
[Crash]
The game crashes while building shaders after the title card fades.
GitHub issue · open
[GBug] Ocarina of Time (0400486024DEC000): black screen on Adreno 740/Turnip, pipeline builders stuck in driver until memory runs out
On Adreno 740 with Turnip, large native compute-shader pipelines can keep Vulkan pipeline-builder workers busy, consume substantial memory, and result in a black screen; some tests also reported GPU hangs or device loss.
GitHub issue · open
[Crash] StarFox, Device loss occurred!
The emulator closes about a minute after gameplay begins on Windows 11 with an NVIDIA RTX 50 series GPU.
GitHub issue · open
[VBug]
An error appears after the cinematic and remains on screen, blocking the view.
GitHub issue · open
crash or infinite loading when use windows 10 (any game)
GitHub issue · open
[VBug] Black screen on cinematic
Black screen during cinematic after the main menu appears; reported on Windows 11 with an AMD RX 6000 series or older GPU.
GitHub issue · open
Discord invite link doesn't work
GitHub issue · open
[Bug] linux-aarch64 PGO build fails ZBIC NSO decompression (assert r > 0); non-PGO of the same commit works
On linux-aarch64, the PGO AppImage logs `assert r > 0` during ZBIC NSO decompression and does not present a frame for the reported game. The non-PGO AppImage of the same commit has no such assertions and decompresses the same game without errors. The issue report does not identify the game by name.
GitHub issue · open
[Crash] Starfox is crashing right before the training mission begins. I got it to pass one time havent been able to get it work again.
Users report crashes before the training mission begins and during the campaign.
GitHub issue · open
[Crash] infinite launch screen with legend of zelda ocarina of time
Infinite startup launch loop when booting the .NUP version.
GitHub issue · open
[GBug] Zelda OOTR Won't Load
Issue reporter says Zelda Ocarina Of Time Remake stays on "Launching..." indefinitely; the log records an emulated program break with error F001. Other reports mention an infinite launch screen.
GitHub issue · open
[GBug] Zelda OOTR Won't Load
A user reports severe shader problems with white visuals; handheld mode shows a black screen.
GitHub issue · open
[GBug] Zelda OOTR Won't Load
A user reports a black screen past the title screen.
GitHub issue · open
[GBug] Starfox - Unmapped write64 error spam in console
A user reports repeated Unmapped Write64 errors, possible audio popping, and an emulation crash when closing the game.
GitHub issue · closed
[GBug]
The 3D gameplay scene is black while HUD elements remain visible; menus and item preview can render correctly.
GitHub issue · closed
[Crash] macOS MKW Loading Splash animation shows, but crashes after.
GitHub issue · open
[VBug] OOTR Terrain visible trough objects
Terrain is visible through solid objects after getting past the intro.
GitHub issue · open
[GBug] Fire Emblem Fortunes Weave - FMVs Skipped/Do not play.
FMVs and pre-rendered videos are skipped, including the opening cut-scene.
GitHub issue · open
[Crash] Bananza runs at ~57 fps then aborts silently, 0xC0000409 at +0x2ecd3bd
On build 70 (286117c), the MSVC zip aborts after 133.8 seconds of gameplay with 0xC0000409 at lichii.exe+0x2ecd3bd. The MinGW PGO zip reportedly aborts on the intro screen at the same offset.
GitHub issue · open
[GBug] Donkey kong bananza, black rectangle
A black rectangle appears in a mini-example guide; the reporter says it persists on build-70.
GitHub issue · open
Pokémon Pokopia: colors washed out with a purple haze at normal camera angle, correct when camera looks straight down
GitHub issue · open
GPU crash
GitHub issue · open
[VBug] Shadow artifacts
Weird artifacts, especially on shadows.
GitHub issue · open
Donkey kong bananza Crash loading
GitHub issue · open
[GBug] Unable to start Pokopia. Constant Black Screen and GPU Idle at 16%
User reports a black screen while loading in Build 65.
GitHub issue · open
[Crash] Kirby Riders
Freezes while menu preview videos play on build 65. A comment reports a custom kirby-test build log showing the game aborting (2162-0001) during menu videos.
GitHub issue · open
Crash on open after installing Update and DLCs
GitHub issue · open
Screen Shaking (Fire Emblem Fortune's Weave)
GitHub issue · open
graphics memory leak in MKW
GitHub issue · open
Fortune's Weave boots but no visuals, only black screen
GitHub issue · open
macOS: GitHub Updates, UI Scaling, Rendering, Performance, Graphics, and Fullscreen Crashes
GitHub issue · open
Mario kart Crash on SplashScreen
GitHub issue · open
Donkey Kong Bananza (040074A01BF12000): fatal 2111-3604 right after a VP9 video reaches end of stream (nx2:vdecsvc)
GitHub issue · closed
donkey kong bananza purple screen issue
GitHub issue · closed
[MKW 1.8.0] Grand Prix crash during course selection, but excellent Free Roam performance on 16 GB RAM (Build 31)
Lichii release
Release note · build-88
An existing fence-worker shutdown race can leave the emulator waiting during shutdown; it was reproduced during testing and is unchanged by this release.
Lichii release
Release note · build-75
Outdoor areas have far too much fog and glow compared with console; performance is about 12–22 fps on a Ryzen 5900X with an RTX 3080, and three rare shaders remain unsupported.
Lichii release
Release note · build-75
On RTX 50-series GPUs, the GPU device can still be lost after a scene change.
Suggested fix: Try NVIDIA driver 610.88.
Lichii release
Release note · build-75
“Failed to allocate 14336 MiB of backing memory” means Windows ran out of RAM plus page file.
Suggested fix: Set the page file to system-managed.
Lichii release
Release note · build-70
Gameplay is capped at about 30 fps, even though the game asks for 60.
Lichii release
Release note · build-70
On RTX 50-series GPUs (5070 Ti, 5090), the GPU device can be lost shortly after a scene change.
Suggested fix: Try NVIDIA driver 610.88.
Lichii release
Release note · build-70
Failed to allocate 14336 MiB of backing memory means Windows ran out of RAM plus page file.
Suggested fix: Set the page file to system-managed and close memory-heavy apps.
Lichii release
Release note · build-70
Some textures are still black, and the game can crash later in play.
Lichii release
Release note · build-70
Some races still stall while shaders build.
Game check
Check Game Compatibility
Setup FAQ
Setup FAQ
Should I remove the old version first?
Keep your working version until the new build is installed and tested. Back up save data and configuration before switching builds.
What should I check if Windows reports a missing dependency?
Keep all companion files from the same release together with lichii.exe. Search the exact dependency message in the release notes or issue tracker.
The controller works in menus but not in my game. What next?
Recheck the input profile and button mappings, then search for the controller model or game in the troubleshooting section.
Why does a closed issue still appear here?
Closed is the issue tracker's status. Read the discussion to find whether it was fixed, moved, or closed for another reason, and which build is affected.
What should I include when asking for help?
Include the Lichii build, OS, GPU and driver, the full error text, and the steps that trigger it. Note whether it also happens in a previously working build.