Instalar Knulli paso a paso: la guía completa

Knulli es un firmware alternativo derivado de Batocera, diseñado para consolas portátiles cuyo núcleo Linux no es mainline o cuyo fabricante no publica fuentes utilizables. En concreto, escribe una imagen en una tarjeta microSD, arranca y recupera una interfaz EmulationStation que gestiona los emuladores, los mandos, el Wi-Fi, el scraping y los logros de RetroAchievements desde un único menú. La versión actual en el momento en que escribimos se llama Scarab (marcado 20260511), publicada en mayo de 2026. Esta guía sigue la documentación oficial del proyecto, paso a paso, sin atajos. Cuenta con treinta minutos para la instalación, un poco más si partes de una tarjeta vacía.

Qué es Knulli y qué no es

Knulli es un fork de Batocera. El proyecto lo asume claramente: la licencia de Batocera no autoriza la adición de núcleos cerrados, lo que hacía imposible la integración de las máquinas con BSP propietario en la rama principal. Knulli toma la base de Batocera y la adapta a las portátiles con poca memoria.

No es una capa superpuesta al sistema original, ni es un producto comercial: la marca Knulli está bajo licencia no comercial y no está destinada a ser vendida.

En qué máquinas funciona Knulli

La lista oficial se publica en la página Devices del proyecto y en la página de versiones. Aquí está el cruce con las máquinas que vendemos.

Dos observaciones. Las Anbernic H700 tienen cada una su imagen: una RG35XX H no arranca con la de una RG35XX SP, a pesar de tener el mismo chip. Y algunos modelos no aparecen en las imágenes de la versión Scarab (RG353V, RG353PS, Powkiddy RGB20S); la lista cambia en cada versión. Nuestra tabla de compatibilidad de firmware recoge estas correspondencias.

Lo que Knulli aporta frente al firmware original

La principal ventaja es la centralización: configuras los emuladores desde EmulationStation, sin entrar en el menú de cada núcleo de RetroArch. El resto, en la práctica:

• Scraping de carátulas y metadatos integrado.
• Logros de RetroAchievements.
• Bluetooth para mandos externos, soporte de teclado y ratón.
• Salida HDMI en las máquinas que la poseen.
• Transferencia de archivos por red, compartido Samba accesible desde el explorador de Windows.
• Sincronización de partidas guardadas mediante Syncthing, mejorada en la versión Scarab.
• Temas, adornos de pantalla (bezels), logo de arranque, shaders, iluminación RGB.
• PortMaster, la biblioteca de ports nativos, instalable en dos menús.

Las desventajas, también hay que decirlas. La documentación oficial no está traducida al francés. La interfaz es más densa que la de un firmware del fabricante, y un principiante puede perderse. Una actualización mayor a menudo exige una reinstalación limpia, por lo tanto, una reconfiguración. Y en cuanto conectas la máquina al Wi-Fi, sus datos son accesibles en la red local sin contraseña mientras no hayas activado la protección en el menú Security.

El hardware necesario

Una tarjeta microSD de buena calidad, un lector de tarjetas fiable y una herramienta de escritura de imágenes. La documentación de Knulli cita Rufus, balenaEtcher, Raspberry Pi Imager y Win32 Disk Imager; dd sirve si te sientes cómodo con la línea de comandos. Prevé también 7-Zip: algunas imágenes se entregan en archivos comprimidos divididos en varias partes.

En la tarjeta, no escatimes: una falsificación o una tarjeta lenta provoca corrupciones de partidas guardadas que luego se atribuyen al firmware. Nuestros criterios están detallados en la guía elegir una tarjeta microSD. Las tarjetas que enviamos se verifican con una escritura-lectura completa antes de salir.

Instalación paso a paso

1. Identifica tu modelo exacto. No la gama, el modelo y su variante: RG35XX Plus, RG35XX 2024, RG35XX H, RG35XX SP y RG35XX Pro son cinco máquinas diferentes. Mira la serigrafía en la parte posterior y la caja.
2. Comprueba si tu dispositivo requiere una preparación. La guía de inicio rápido indica que algunas máquinas, como la Miyoo Flip y las Retroid Pocket, requieren una operación previa antes de escribir la tarjeta. Las Anbernic H700 y las TrimUI, no.
3. Descarga la imagen en la página oficial de versiones, repositorio knulli-cfw/knulli-linux en GitHub. Los archivos siguen el esquema knulli-<chip>-<modelo>-<nombre de versión>-<fecha>.img.gz, por ejemplo, una imagen h700 para las Anbernic o a133 para las TrimUI. Nunca tomes una imagen encontrada en otro sitio.
4. Comprueba la integridad de la descarga. La página de versiones en GitHub muestra la huella SHA-256 de cada archivo: compárala con la que calcules. Haz también que 7-Zip pruebe el archivo comprimido antes de escribirlo, ya que los formatos gzip y 7z incluyen un CRC. Si la imagen está dividida, descarga todas las partes (.001, .002…) y extráela desde la primera.
5. Escribe la imagen en la tarjeta con la herramienta de tu elección. La operación borra completamente la tarjeta. Comprueba tres veces la letra de la unidad antes de confirmar.
6. Primer arranque. Inserta la tarjeta en la primera ranura, retira cualquier tarjeta de la segunda ranura, enciende. El arranque es largo: Knulli amplía y formatea la partición de juegos. No cortes la alimentación, no retires la tarjeta.
7. Espera EmulationStation. La instalación solo termina cuando aparece la interfaz. La partición SHARE solo alcanza su tamaño definitivo en ese momento: no intentes copiar nada en ella antes.

La configuración justo después

Idioma

El idioma de la interfaz se configura desde el menú principal, pulsando Start, en los ajustes del sistema. La denominación exacta del menú cambia de una versión a otra, por confirmar en tu build. La documentación del proyecto, por su parte, solo existe en inglés, español, alemán, polaco, turco, portugués de Brasil, italiano y japonés.

Wi-Fi y red

Start y luego Network settings, activa el Wi-Fi en la sección de ajustes. Una vez conectado, la máquina aparece en el explorador de Windows en la dirección \\KNULLI\share, y el acceso SSH utiliza el identificador root. Pasa inmediatamente por el menú Security para poner una contraseña si no estás en tu red doméstica.

Botones

Start, Controller & Bluetooth Settings, Controller Mapping para asociar un mando externo. Sin embargo, no remapees los comandos integrados de la consola: cada imagen de Knulli se entrega con un mapeo optimizado para la máquina, y el remapeo rompe funciones virtuales ocultas, como la conversión de la cruceta al stick. Para cambiar las teclas de un juego específico, pasa por los ajustes del emulador.

Suspensión y autonomía

La FAQ oficial trata una descarga rápida de la batería en las Anbernic RG35XX y RG40XX, y una visualización deformada en las revisiones recientes de la RG35XX SP. Lee la ficha de solución de problemas del proyecto antes de concluir que hay un defecto de hardware.

Dónde colocar tus juegos

Todo pasa por la carpeta /userdata, que corresponde a la partición SHARE de la tarjeta principal, o a la partición principal de la segunda tarjeta si utilizas una. La ruta a recordar es /userdata/roms/, con una subcarpeta por sistema, más /userdata/bios para los archivos del sistema y /userdata/saves para las partidas guardadas.

Punto importante sobre la doble tarjeta: SD1 y SD2 no pueden servir como almacenamiento de juegos al mismo tiempo. Eliges una u otra en los ajustes, y en modo doble tarjeta la partición SHARE interna ya no se utiliza ni es accesible por la red. Para el detalle de los nombres de las carpetas por sistema, consulta nuestro artículo sobre la estructura de los firmwares, no lo volvemos a escribir aquí.

La trampa más frecuente

Es la precipitación en el primer arranque. Tres errores se repiten sin parar: copiar juegos antes de que la partición SHARE haya sido ampliada, dejar una segunda tarjeta insertada durante la instalación, aceptar la propuesta de formateo de Windows. Los tres resultan en una reinstalación completa.

La segunda trampa se refiere a las actualizaciones mayores: después de una subida de versión, no restaures la carpeta system de tu instalación anterior. Los archivos de configuración no son compatibles de una versión mayor a otra y heredas ajustes incoherentes. Restaura los juegos, las partidas guardadas, los temas, no la carpeta system. Si a pesar de todo un juego se niega a arrancar, nuestra guía mi juego no arranca revisa las causas.

Actualizar

Existen tres vías, documentadas por el proyecto.

• OTA. Menú principal, Updates & Downloads, tipo de actualización en Stable, luego Start Update. Es necesaria una conexión a internet. No interrumpas nada durante la operación, no inicies ningún juego en paralelo.
• Paquete de inicio. Para las actualizaciones menores, se descarga el paquete correspondiente en la página de versiones, se reemplaza el archivo boot/batocera de la partición BATOCERA por el archivo proporcionado, renombrado, y luego se reinicia.
• Reescritura completa. Para las versiones mayores. Las notas de la versión Scarab recomiendan explícitamente partir de una instalación limpia, ya que los archivos de configuración no son compatibles con las versiones anteriores. Haz una copia de seguridad de /userdata antes.

En las versiones recientes, la instalación limpia sigue siendo la vía segura, incluso cuando una actualización parece posible. Es más largo, pero evita comportamientos erráticos imposibles de diagnosticar después.

Volver atrás

Si has seguido la regla de oro, no hay nada que deshacer: apagas la consola, vuelves a poner la tarjeta microSD original, la enciendes. El firmware del fabricante vuelve tal cual, ya que Knulli vive en su propia tarjeta y no toca la tarjeta original.

Esto vale para las máquinas que arrancan desde la tarjeta, Anbernic H700 y TrimUI en particular. En los modelos que requirieron una preparación previa, la vuelta al estado original sigue el procedimiento inverso descrito en su documentación: por comprobar caso por caso. Para comparar los firmwares alternativos entre sí, ver nuestra guía de instalación de firmwares personalizados.

Preguntas frecuentes

Si todavía dudas sobre la máquina a instalar, o si buscas un modelo cuyo firmware alternativo esté bien soportado, recorre nuestra selección de consolas retro Linux.