Installation et dépannage

Installer et dépanner Lichii Emulator

Du téléchargement au premier lancement, configurez vos commandes, ajoutez vos jeux et résolvez les problèmes qui vous bloquent.

Manettes détachées, connexions USB-C et écran illustrant l’affectation des boutons dans le guide d’installation de Lichii Emulator
Illustration · Guide d’installation de Lichii Emulator
Latest recorded build build-117 Published November 7, 2026

Trois plateformes

Comment installer Lichii Emulator

Choisissez votre plateforme pour suivre l’installation pas à pas.

Installer Lichii sous Windows

  1. Téléchargez les fichiers Windows actuellement proposés (lichii-windows-x86_64-pgo.zip (x86_64), lichii-windows-x86_64.zip (x86_64)) depuis la version officielle build-117 et conservez leur nom d’origine.
  2. Extrayez l’archive dans un dossier où vous avez les droits d’écriture. Ne lancez pas l’exécutable directement depuis l’archive compressée.
  3. Lancez lichii.exe depuis le dossier d’extraction. Si Windows affiche un avertissement de sécurité, vérifiez que le fichier provient du lien officiel de la version avant de décider de poursuivre.

Besoin d’un autre fichier ? Voir les téléchargements pour windows.

Installer Lichii sous Linux

  1. Choisissez parmi les fichiers Linux publiés (lichii-linux-aarch64-pgo.AppImage (arm64), lichii-linux-aarch64-pgo.tar.gz (arm64), lichii-linux-aarch64.AppImage (arm64), lichii-linux-aarch64.tar.gz (arm64), lichii-linux-x86_64-pgo.AppImage (x86_64), lichii-linux-x86_64-pgo.tar.gz (x86_64), lichii-linux-x86_64.AppImage (x86_64), lichii-linux-x86_64.tar.gz (x86_64)) celui qui correspond à l’architecture de votre système, puis téléchargez-le depuis le lien de la version.
  2. Pour lichii-linux-aarch64-pgo.AppImage, exécutez chmod +x 'lichii-linux-aarch64-pgo.AppImage' dans le dossier du téléchargement, puis lancez cette AppImage.
  3. Pour lichii-linux-aarch64-pgo.tar.gz, extrayez d’abord l’archive, puis lancez l’exécutable depuis le dossier d’extraction. Si un message signale une dépendance glibc ou Qt manquante, consultez les notes de la version sélectionnée et le ticket d’origine pour connaître la version requise.
  4. Conservez l’URL et le tag de la version avec le fichier installé pour pouvoir rattacher vos futurs résultats de compatibilité à la même version.

Indications de la version

  • Linux AppImage requires glibc 2.39 or newer; the source lists Ubuntu 24.04, Fedora 40, Debian 13, and Arch.
  • Linux tar.gz packages use system libraries, so Qt 6 and the usual libraries must be installed.

Besoin d’un autre fichier ? Voir les téléchargements pour linux.

Installer Lichii sous macOS

  1. Choisissez parmi les fichiers macOS publiés (lichii-macos-arm64.dmg (arm64), lichii-macos-arm64.zip (arm64)) celui qui correspond à l’architecture de votre système, puis téléchargez-le depuis le lien de la version.
  2. Pour lichii-macos-arm64.dmg, ouvrez le DMG et déplacez l’application dans un dossier que vous gérez, par exemple Applications.
  3. Pour lichii-macos-arm64.zip, ouvrez le ZIP et déplacez l’application dans un dossier que vous gérez. Si macOS demande une confirmation au premier lancement, faites un clic droit sur l’application et choisissez Ouvrir.
  4. Si macOS affiche un avertissement de sécurité, comparez votre téléchargement à la version officielle avant de poursuivre. Laissez les protections habituelles du système activées.
  5. Lancez Lichii depuis le dossier où vous avez placé l’application.

Indications de la version

  • macOS arm64 requires macOS 15 or newer.

Besoin d’un autre fichier ? Voir les téléchargements pour macos.

Premier lancement

Configuration initiale

Configurez Lichii dès le premier lancement : choisissez la disposition de manette qui vous convient, réglez les graphismes et ajoutez votre bibliothèque de jeux.

Graphismes

Commencez par les réglages graphiques décrits dans les notes de votre version. Changez un seul réglage à la fois et notez le tag de la version avec vos résultats.

Pour trouver des réglages de départ adaptés à un jeu, ouvrez son rapport de compatibilité.

Périphériques d’entrée

Connectez votre manette, attribuez les boutons, puis enregistrez le profil. Si un bouton ne fonctionne pas, recherchez le modèle de votre manette et votre version de Lichii dans la section de dépannage.

Vos fichiers de jeu

Ajoutez vos jeux obtenus légalement depuis la bibliothèque ou l’option d’ouverture de fichiers de jeu de Lichii. Les jeux, les clés et le micrologiciel sont à fournir séparément.

Notes officielles d’installation actuelles

  • Recommended download: the PGO build.
  • Back up saves before testing experimental builds.
  • To submit a desktop compatibility report, use a build containing PR #303. Play and stop a Switch 2 game, then right-click it and choose Submit compatibility report. Review the prefilled details and public preview, and explicitly consent before submission.
  • Test games with stock options first; try changing settings only if they do not work.

Reprendre la partie

Erreurs fréquentes dans Lichii et solutions

453 problèmes dans la liste

GitHub issue · open

[Regression] OoT black screen with audio on Linux AMD RADV (RX 9070 XT): Build 83 works, Build 95 fails

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : CachyOS (Arch Linux), KDE Plasma / Wayland Version : 95 Non-PGO

On Build 95 Non-PGO in Linux AMD RADV, the game remains black-screened while intro audio plays, even after shader compilation. The symptom persisted across the reported Wayland/XWayland and environment-variable tests, and after removing Vulkan Pipeline Cache and Cache Storage.

GitHub issue · open

[Regression] OoT black screen with audio on Linux AMD RADV (RX 9070 XT): Build 83 works, Build 95 fails

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : CachyOS, KDE Plasma, Linux; Wayland and XWayland reported Version : 117

Build 117 renders again, but the user reports substantial FPS and frametime variability, including drops to 19 FPS.

GitHub issue · open

[Crash] Ocarina of Time (0400486024DEC000): VK_ERROR_DEVICE_LOST right after the intro cutscene on RX 7800 XT (build-88)

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2)

AMD GPU users report Vulkan VK_ERROR_DEVICE_LOST crashes around the intro-to-gameplay transition or while loading a save. Reports include RX 7800 XT, RX 9070 XT, and RX 6900 XT systems; the issue is not universal across all reports or tested builds.

GitHub issue · open

[Crash] Ocarina of Time (0400486024DEC000): VK_ERROR_DEVICE_LOST right after the intro cutscene on RX 7800 XT (build-88)

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2)

Some users report crashes or black screens after trying the EDEN_NX2_NO_MESH=1 workaround; results vary by GPU, operating system, and build.

GitHub issue · open

Title: Feature request: precompile all of a game's shaders at first boot (shader warm-up)

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Linux (CachyOS) Version : Lichii build 88 (Linux AppImage)

Hard lag or freezes when shaders are being built, mostly on first visits to areas, as reported by the issue author.

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Windows 11 Version : build-93

On build 93 with RX 9070 XT, gameplay is slow-motion at reported frame rates, with heavy bloom and overexposure in bright areas and the Great Deku Tree rendered as a dark silhouette in its intro scene.

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Windows 11 Version : build-95 (the release tagged `build-94`)

On RX 5700 (RDNA1), Kokiri Forest performance is reported at 14–15 FPS, compared with 22–24 FPS indoors; build 95 is reported to have the same outdoor performance as build 93.

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Windows 11 Version : Lichii-AMD 2026.11.07 (nauxph fork, f4e938f516)

On Lichii-AMD 2026.11.07 with RX 9070 XT using GPU Mode Fast, repeated rolling and jumping triggered black game frames while the HUD remained visible; the game continued running. Blackouts recurred in Kokiri Forest and were not accompanied by log output during the reported black periods.

Solution proposée : Switching GPU Mode from Fast to Accurate at runtime restored the picture without restarting; the commenter reports stutter afterward. Accurate mode was also reported to avoid blackouts but cause heavy stutter.

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Windows 11 Version : local clang-cl Release build of nx2 at 91d1aada6 (not PGO)

With an older configuration retaining GPU accuracy High, GPU thread splitting did not start, leaving work on one GPU thread. The commenter also reports long hitches while native pipelines were built, even with async shaders on.

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Windows 11 Version : build-117 (PGO)

On RX 9070 XT with extracted base-game version 1.0.0, the commenter reports blackouts and a Native compute shader rejected (per-tap gather) log error. They report no blackouts or such error during about 70 minutes of play using version 2.0.0 from a .nup on build 117 PGO.

GitHub issue · open

Ocarina of Time (Switch 2) gets stuck at "Building 9 shaders" on AMD RX 6750 XT

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Windows 11 25H2 Version : build-75

On an AMD RX 6750 XT, the emulator freezes at “Building 9 shaders” after launching; background audio continues and the game does not progress.

GitHub issue · open

[Crash]

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Windows 11 26H2 Version : nx2-build-92

Heavy stuttering during shader compilation, sometimes dropping to 0 FPS, with poor reported performance.

GitHub issue · closed

[Crash]

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Windows 10 Version : Lichii nx2-build-75

On Radeon RX 580 (Polaris / GCN4), the game hangs at 0 FPS with a black screen while building compute pipelines as the intro video starts.

GitHub issue · open

[Investigation] OoT build-88: Vulkan pipeline stalls + reproducible hidden-window NVIDIA crash (static findings, test candidates)

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : Windows Version : build-88

Two hidden/minimized Windows CLI launches crashed in nvoglv64.dll with exception 0xc0000094 at offset 0xEFC9BB. Static findings identify stale SDL visibility state and no zero-extent guard as possible leads, but neither is proven to cause the crash.

GitHub issue · open

macOS/MoltenVK: Ocarina of Time (0400486024DEC000) kills or hangs the Metal device at the intro-video boundary

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : macOS Version : nx2 at 8813b44 and 5a50f50

On macOS arm64 with Vulkan via MoltenVK, the Metal device may be lost with a GPU address fault or device error during intro video playback, or the GPU thread may hang at the video-to-gameplay transition in fence waiting or buffer download.

GitHub issue · open

macOS/MoltenVK: Ocarina of Time (0400486024DEC000) kills or hangs the Metal device at the intro-video boundary

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : macOS

On Apple GPUs, attachment-less framebuffer draws using a 32768×32768 surface clip can exceed device framebuffer limits and cause GPU failure/device loss. A user also reports a stream-buffer constant-buffer tail read issue on Metal.

GitHub issue · open

macOS/MoltenVK: Ocarina of Time (0400486024DEC000) kills or hangs the Metal device at the intro-video boundary

Jeu : The Legend of Zelda: Ocarina of Time (Switch 2) Système : macOS Version : Local nx2 builds 27226d2 and 55532f2 with user patches

User reports that rejecting shader programs containing native opcode 0x4a4 avoids a Metal page fault, but may leave the run stalled at the end of the video with semaphore waits and GPU-thread abort.

Vérification des jeux

Vérifier la compatibilité d’un jeu

Questions sur l’installation

FAQ sur l’installation

Dois-je d’abord supprimer l’ancienne version ?

Gardez la version qui fonctionne jusqu’à ce que la nouvelle soit installée et testée. Sauvegardez vos parties et votre configuration avant de changer de version.

Que vérifier si Windows signale une dépendance manquante ?

Conservez tous les fichiers associés de la même version dans le même dossier que lichii.exe. Recherchez le message exact de dépendance dans les notes de version ou le suivi des tickets.

La manette fonctionne dans les menus, mais pas dans mon jeu. Que faire ?

Vérifiez le profil de la manette et l’affectation des boutons, puis recherchez le modèle ou le jeu dans la section de dépannage.

Pourquoi un ticket fermé apparaît-il encore ici ?

« Fermé » est le statut dans le suivi des tickets. Lisez la discussion pour savoir si le problème a été résolu, déplacé ou si le ticket a été fermé pour une autre raison, et quelle version est concernée.

Quelles informations fournir lorsque je demande de l’aide ?

Indiquez la version de Lichii, le système d’exploitation, le GPU et son pilote, le texte complet de l’erreur et les étapes qui la déclenchent. Précisez si elle survient aussi dans une version qui fonctionnait auparavant.