Configurer Lichii : installation, clés, firmware et sauvegardes
Avant de commencerSauvegardez vos données de jeu avant d'installer une version expérimentale de build. Le développement de Lichii avance vite, et la communauté de README invite chaque testeur à faire une copie préalable.
La configuration de Lichii Switch 2 Emulator s'effectue en six étapes : téléchargez le bon paquet depuis GitHub, décompressez-le, installez vos clés et votre firmware, assurez-vous que votre dossier de données actuel est bien conservé, puis lancez un jeu. L'archive téléchargée ne contenant aucun jeu, aucune clé ni aucun firmware, ces éléments doivent provenir de votre propre console et de vos titres. La liste de vérification The ci-dessous enregistre votre progression dans ce navigateur pour vous permettre de reprendre après un redémarrage ou une mise à jour de pilote.
6Étapes d'installation
4Paquets de bureau officiels
2.39glibc minimale sur Linux
15macOS minimal sur Apple Silicon
Liste de configuration
0 / 6 étapes terminées
01
Télécharger uniquement depuis GitHub
Rendez-vous sur la page Releases de github.com/zortos293/Lichii et sélectionnez le paquet de la build 117 adapté à votre système. Windows nécessite un zip, Linux un AppImage ou tar.gz, et les Mac Apple Silicon un dmg ou zip. Le paquet The PGO est l'option recommandée.
Windows x86_64 · Linux x86_64 ou aarch64 · macOS arm64
Pourquoi c'est importantlichii.org et les sites similaires ne font pas partie du projet. Le ticket #545 rapporte qu'un zip issu de ce site lance node.exe depuis %TEMP%.
Les paquets Windows sont des archives autonomes : décompressez l'ensemble du zip dans un dossier standard et lancez lichii.exe (ou eden-cli.exe depuis un terminal). Sous Linux, rendez l'AppImage exécutable via chmod +x, ou extrayez le tar.gz puis lancez ./lichii. Sur un Mac, ouvrez le dmg et glissez lichii.app dans Applications.
AppImage : glibc 2.39+ · tar.gz : Qt 6 système · macOS 15+, non notarié
Pourquoi c'est importantExécuter lichii.exe directement depuis l'archive sans l'extraire empêche le programme d'accéder à ses bibliothèques.
Lichii est fourni sans clés de déchiffrement. En cas de lancement sans ces clés, les logs indiquent Decryption keys are missing: NCA, NSP and XCI games need them. Utilisez les clés extraites de votre propre console ; vous ne trouverez ici aucune clé ni aucun lien de téléchargement pour vous les procurer.
Clés extraites d'une console en votre possession
Pourquoi c'est importantSans ces clés, la liste de jeux reste vide ou les titres refusent de se charger, ce qui ressemble à un crash sans en être un.
Sans firmware, le fichier journal affiche Installed firmware: No firmware available. Installez le firmware extrait de votre propre console. De nombreux jeux en ont besoin pour afficher les polices partagées et charger les archives système ; les rapports de bugs sur le dépôt indiquent d'ailleurs la version du firmware à côté de celle du jeu.
Firmware extrait de votre propre console
Pourquoi c'est importantL'absence de polices de firmware et d'archives système entraîne des corruptions de texte et des erreurs inexistantes sur une installation complète.
Lichii continue d'utiliser les répertoires de données et clés de configuration existants de Eden et Eglantine. Vos sauvegardes, réglages et caches de shaders ne sont jamais déplacés ni supprimés. Copiez ce dossier en lieu sûr avant de lancer une nouvelle build pour la première fois. L'option Fichier > Ouvrir les dossiers de Lichii y mène directement.
Espace disque suffisant pour une copie de vos sauvegardes
Pourquoi c'est importantUne build expérimentale de build peut endommager une sauvegarde. Une copie de secours de A en dehors des dossiers de l'émulateur reste la seule sécurité fiable en cas de régression.
Lancez Lichii, ajoutez votre dossier de jeux ou utilisez Fichier > Charger un fichier, puis démarrez le jeu. Le premier lancement de The compile les shaders, donc les premières minutes saccadent. En cas de problème, le journal se trouve sous File > Open Lichii Folders > Log Folder > eden_log.txt.
Votre propre dump de jeu obtenu légalement
Pourquoi c'est importantPour qu'un rapport de bug soit exploitable, joignez-y impérativement le fichier eden_log.txt ainsi que le numéro de votre build.
Décompressez l'archive zip et lancez lichii.exe. L'archive The PGO est compilée avec un profil ThinLTO optimisé pour Ocarina of Time. Cette version Windows totalise 122 388 téléchargements sur la build 117.
Linux
The AppImage nécessite glibc 2.39 ou plus récent : Ubuntu 24.04, Fedora 40, Debian 13 ou Arch. Les distributions plus anciennes doivent utiliser le tar.gz avec les bibliothèques Qt 6 du système. Des paquets existent pour x86_64 et aarch64.
macOS
Uniquement sur Apple Silicon avec macOS 15 ou supérieur. L'application The n'étant pas notariée, macOS bloque le premier lancement tant qu'elle n'est pas autorisée dans les Réglages System sous Confidentialité et sécurité.
Téléchargements de Build 117 par plateforme. Android ne propose aucun paquet officiel.
Mise à jour vers une version plus récente de build
01
Utiliser l'outil de mise à jour
Depuis la build 75, le gestionnaire de mise à jour intégré vérifie les versions de Lichii publiées sur GitHub et télécharge le paquet adapté à votre machine (#82).
02
Ou remplacer le dossier
Téléchargez la nouvelle archive et extrayez-la dans un dossier propre. Vos sauvegardes restent dans le répertoire de données, pas dans le dossier du programme.
03
Sauvegarder à nouveau
Effectuez une sauvegarde propre avant de basculer vers une nouvelle build, tout particulièrement si les notes de version signalent des modifications du système de fichiers ou des sauvegardes.
Foire aux questions
Lichii inclut-il des clés, des firmwares ou des jeux ?
Non. The README précise que les jeux, clés et firmwares ne sont pas inclus et que vous ne devez utiliser que des jeux et fichiers système acquis légalement. Lors d'un premier démarrage sans ces éléments, Lichii signale dans les journaux que les clés de déchiffrement sont absentes et qu'aucun firmware n'est installé.
Où Lichii stocke-t-il mes sauvegardes ?
Dans les répertoires de données existants de Eden et Eglantine, que Lichii conserve avec leurs clés de configuration. Les sauvegardes, réglages et caches de shaders ne sont jamais déplacés ni écrasés. Ouvrez cet emplacement via Fichier > Ouvrir les dossiers de Lichii pour en faire une copie avant de tester une nouvelle build.
Faut-il tout reconfigurer à chaque nouvelle version de build ?
Non. Les clés, firmwares, paramètres et sauvegardes restent dans le répertoire de données, et la nouvelle build les reprend automatiquement. À partir de la build 75, l'outil de mise à jour intégré peut récupérer le bon paquet sur GitHub à votre place. Pensez tout de même à sauvegarder vos données de jeu avant chaque mise à jour.
Pourquoi mon Mac refuse-t-il d'ouvrir Lichii ?
L'archive The macOS build n'étant pas notariée, Gatekeeper bloque son exécution au premier lancement. Autorisez-la dans les Réglages Système de System, section Confidentialité et sécurité. Elle nécessite également une puce Apple Silicon Mac sous macOS 15 ou supérieur ; aucun paquet officiel n'existe pour les Mac Intel.
