Installer Knulli pas à pas : le guide complet

Knulli est un firmware alternatif dérivé de Batocera, conçu pour les consoles portables dont le noyau Linux n'est pas mainline ou dont le fabricant ne publie pas de sources exploitables. Concrètement, vous écrivez une image sur une carte microSD, vous démarrez, et vous récupérez une interface EmulationStation qui gère les émulateurs, les manettes, le Wi-Fi, le scraping et les succès RetroAchievements depuis un seul menu. La version en cours au moment où nous écrivons s'appelle Scarab (marquage 20260511), publiée en mai 2026. Ce guide suit la documentation officielle du projet, étape par étape, sans raccourci. Comptez trente minutes pour l'installation, un peu plus si vous partez d'une carte vierge.

Ce que Knulli est, et ce qu'il n'est pas

Knulli est un fork de Batocera. Le projet l'assume clairement : la licence de Batocera n'autorise pas l'ajout de noyaux fermés, ce qui rendait impossible l'intégration des machines à BSP propriétaire dans la branche principale. Knulli reprend donc la base Batocera et l'adapte aux portables à faible mémoire. Si vous veniez de Batocera v39 ou v40 sur ce type d'appareil, Knulli en est le successeur direct.

Ce n'est pas une couche posée par-dessus le système d'origine, et ce n'est pas un produit commercial : la marque Knulli est sous licence non commerciale et n'a pas vocation à être vendue.

Sur quelles machines Knulli tourne

La liste officielle est publiée sur la page Devices du projet et sur la page des versions. Voici le recoupement avec les machines que nous vendons.

Deux remarques. Les Anbernic H700 ont chacune leur image : une RG35XX H ne démarre pas avec celle d'une RG35XX SP, malgré la même puce. Et certains modèles que nous vendons ne figurent pas dans les images de la version Scarab (RG353V, RG353PS, Powkiddy RGB20S) ; la liste bouge à chaque version. Notre tableau de compatibilité firmware reprend ces correspondances.

Ce que Knulli apporte face au firmware d'origine

Le gain principal est la centralisation : vous réglez les émulateurs depuis EmulationStation, sans entrer dans le menu de chaque cœur RetroArch. Le reste, dans les faits :

• Scraping des jaquettes et métadonnées intégré.
• Succès RetroAchievements.
• Bluetooth pour manettes externes, prise en charge clavier et souris.
• Sortie HDMI sur les machines qui la possèdent.
• Transfert de fichiers par le réseau, partage Samba accessible depuis l'explorateur Windows.
• Synchronisation des sauvegardes par Syncthing, améliorée dans la version Scarab.
• Thèmes, habillages d'écran (bezels), logo de démarrage, shaders, éclairage RGB.
• PortMaster, la logithèque de portages natifs, installable en deux menus.

Les contreparties, il faut les dire aussi. La documentation officielle n'est pas traduite en français. L'interface est plus dense que celle d'un firmware constructeur, et un débutant peut s'y perdre. Une mise à jour majeure impose souvent une réinstallation propre, donc une reconfiguration. Et dès que vous connectez la machine au Wi-Fi, ses données sont accessibles sur le réseau local sans mot de passe tant que vous n'avez pas activé la protection dans le menu Security.

Le matériel nécessaire

Une carte microSD de bonne qualité, un lecteur de cartes fiable, et un outil d'écriture d'image. La documentation Knulli cite Rufus, balenaEtcher, Raspberry Pi Imager et Win32 Disk Imager ; dd convient si vous êtes à l'aise en ligne de commande. Prévoyez aussi 7-Zip : certaines images sont livrées en archives découpées en plusieurs parties.

Sur la carte, ne lésinez pas : une contrefaçon ou une carte lente provoque des corruptions de sauvegarde qu'on attribue ensuite au firmware. Nos critères sont détaillés dans le guide choisir une carte microSD. Les cartes que nous expédions sont vérifiées par écriture-relecture complète avant départ.

Installation pas à pas

1. Identifiez votre modèle exact. Pas la gamme, le modèle et sa variante : RG35XX Plus, RG35XX 2024, RG35XX H, RG35XX SP et RG35XX Pro sont cinq machines différentes. Regardez la sérigraphie au dos et la boîte.
2. Vérifiez si votre appareil demande une préparation. Le guide de démarrage rapide signale que certaines machines, dont la Miyoo Flip et les Retroid Pocket, exigent une opération préalable avant l'écriture de la carte. Les Anbernic H700 et les TrimUI, non.
3. Téléchargez l'image sur la page officielle des versions, dépôt knulli-cfw/knulli-linux sur GitHub. Les fichiers suivent le schéma knulli-<puce>-<modèle>-<nom de version>-<date>.img.gz, par exemple une image h700 pour les Anbernic ou a133 pour les TrimUI. Ne prenez jamais une image trouvée ailleurs.
4. Contrôlez l'intégrité du téléchargement. Le projet ne publie pas de sommes de contrôle à côté de ses images : il n'y a pas de SHA-256 officiel à comparer. Faites plutôt tester l'archive par 7-Zip avant l'écriture, les formats gzip et 7z embarquant un CRC. Si l'image est découpée, téléchargez toutes les parties (.001, .002…) et extrayez depuis la première.
5. Écrivez l'image sur la carte avec l'outil de votre choix. L'opération efface entièrement la carte. Vérifiez trois fois la lettre de lecteur avant de valider.
6. Premier démarrage. Insérez la carte dans le premier emplacement, retirez toute carte du second emplacement, allumez. Le démarrage est long : Knulli étend et formate la partition de jeux. Ne coupez pas l'alimentation, ne retirez pas la carte.
7. Attendez EmulationStation. L'installation n'est terminée que quand l'interface s'affiche. La partition SHARE n'atteint sa taille définitive qu'à ce moment : inutile d'essayer d'y copier quoi que ce soit avant.

La configuration juste après

Langue

La langue de l'interface se règle depuis le menu principal, touche Start, dans les réglages du système. Le libellé exact du menu change d'une version à l'autre, à confirmer sur votre build. La documentation du projet, elle, n'existe qu'en anglais, espagnol, allemand, polonais, turc, portugais du Brésil, italien et japonais.

Wi-Fi et réseau

Start puis Network settings, activez le Wi-Fi dans la section des réglages. Une fois connecté, la machine apparaît dans l'explorateur Windows à l'adresse \\KNULLI\share, et l'accès SSH utilise l'identifiant root. Passez immédiatement par le menu Security pour poser un mot de passe si vous n'êtes pas sur votre réseau domestique.

Boutons

Start, Controller & Bluetooth Settings, Controller Mapping pour associer une manette externe. En revanche, ne remappez pas les commandes intégrées de la console : chaque image Knulli est livrée avec un mappage optimisé pour la machine, et le remappage casse des fonctions virtuelles cachées, comme la conversion croix directionnelle vers stick. Pour changer les touches d'un jeu précis, passez par les réglages de l'émulateur.

Veille et autonomie

La FAQ officielle traite d'une décharge rapide de la batterie sur les Anbernic RG35XX et RG40XX, et d'un affichage déformé sur les révisions récentes de la RG35XX SP. Lisez la fiche de dépannage du projet avant de conclure à un défaut matériel.

Où placer vos jeux

Tout passe par le dossier /userdata, qui correspond à la partition SHARE de la carte principale, ou à la partition principale de la seconde carte si vous en utilisez une. Le chemin à retenir est /userdata/roms/, avec un sous-dossier par système, plus /userdata/bios pour les fichiers système et /userdata/saves pour les sauvegardes.

Point important sur la double carte : SD1 et SD2 ne peuvent pas servir de stockage de jeux en même temps. Vous choisissez l'une ou l'autre dans les réglages, et en mode double carte la partition SHARE interne n'est plus utilisée ni accessible par le réseau. Pour le détail des noms de dossiers par système, reportez-vous à notre article sur l'arborescence des firmwares, nous ne le réécrivons pas ici.

Le piège le plus fréquent

C'est la précipitation au premier démarrage. Trois erreurs reviennent sans arrêt : copier des jeux avant que la partition SHARE ait été étendue, laisser une seconde carte insérée pendant l'installation, accepter la proposition de formatage de Windows. Les trois se soldent par une réinstallation complète.

Le second piège concerne les mises à jour majeures : après une montée de version, ne restaurez pas le dossier system de votre installation précédente. Les fichiers de configuration ne sont pas compatibles d'une version majeure à l'autre et vous héritez de réglages incohérents. Restaurez les jeux, les sauvegardes, les thèmes, pas le dossier system. Si malgré tout un jeu refuse de démarrer, notre guide mon jeu ne se lance pas passe les causes en revue.

Mettre à jour

Trois voies existent, documentées par le projet.

• OTA. Menu principal, Updates & Downloads, type de mise à jour sur Stable, puis Start Update. Une connexion internet est nécessaire. N'interrompez rien pendant l'opération, ne lancez pas de jeu en parallèle.
• Paquet de démarrage. Pour les mises à jour mineures, on télécharge le paquet correspondant sur la page des versions, on remplace le fichier boot/batocera de la partition BATOCERA par le fichier fourni, renommé, puis on redémarre.
• Réécriture complète. Pour les versions majeures. Les notes de la version Scarab recommandent explicitement de repartir sur une installation propre, les fichiers de configuration n'étant pas compatibles avec les versions antérieures. Sauvegardez /userdata avant.

Sur les versions récentes, l'installation propre reste la voie sûre, même quand une mise à jour semble possible. C'est plus long, mais cela évite des comportements erratiques impossibles à diagnostiquer ensuite.

Revenir en arrière

Si vous avez suivi la règle d'or, il n'y a rien à défaire : vous éteignez la console, vous remettez la carte microSD d'origine, vous rallumez. Le firmware constructeur revient tel quel, puisque Knulli vit sur sa propre carte et ne touche pas à la carte d'origine.

Cela vaut pour les machines qui démarrent depuis la carte, Anbernic H700 et TrimUI notamment. Sur les modèles qui ont demandé une préparation préalable, la remise en état suit la procédure inverse décrite dans leur documentation : à vérifier au cas par cas. Pour comparer les firmwares alternatifs entre eux, voir notre guide d'installation des firmwares personnalisés.

Questions fréquentes

Si vous hésitez encore sur la machine à installer, ou si vous cherchez un modèle dont le firmware alternatif est bien pris en charge, parcourez notre sélection de consoles rétro Linux.