Tutorial detallado para instalar EmuDeck en Android

  • EmuDeck para Android permite centralizar y automatizar la configuración de emuladores sobre un entorno Termux bien preparado.
  • La estabilidad del sistema depende en gran medida de usar la versión correcta de Termux, ajustar repositorios y no actualizar paquetes críticos como termux-tools.
  • Modificar el script setup.sh para evitar que toque la gestión de paquetes de Termux es clave para una instalación limpia y funcional.
  • El proyecto todavía está madurando, pero cuenta con una comunidad activa en Discord y foros que facilita resolver problemas y compartir configuraciones.

EmuDeck

Si has visto cómo funciona EmuDeck en Steam Deck y te ha picado el gusanillo de montarlo también en Android, especialmente en una Nintendo Switch con Android 10 o en otros dispositivos portátiles, este artículo es para ti. Mucha gente se encuentra con que la teoría suena muy bonita, pero cuando se ponen a seguir las guías oficiales empiezan los errores, los repositorios rotos y los sustos en Termux. Aquí vamos a desgranar todo ese proceso paso a paso, con explicaciones claras y algunos trucos para evitar los problemas más habituales.

Partimos de una base real: una Switch con Android 10, acceso root y ganas de trastear con EmuDeck para Android. A partir de ahí, verás cómo preparar el sistema, qué hacer para que Termux no rompa los repos, cómo modificar el script de instalación de EmuDeck y qué limitaciones debes tener en cuenta. Además, comentaremos el estado actual de EmuDeck en Android, su relación con otros sistemas como GammaOS y su uso en dispositivos como Steam Deck y consolas portátiles dedicadas.

Qué es EmuDeck en Android y por qué puede interesarte

EmuDeck nació como una herramienta pensada para la Steam Deck, y su objetivo principal es automatizar la descarga, instalación y configuración de múltiples emuladores en un mismo entorno, dejándolos listos para integrarse cómodamente en la interfaz de SteamOS. Esta filosofía también se ha llevado a Android, donde el proyecto cuenta ya con una versión funcional orientada a dispositivos portátiles.

En Android, EmuDeck se apoya en scripts que se ejecutan a través de Termux y herramientas de línea de comandos, lo que permite preparar un entorno bastante completo sin que tengas que configurar a mano cada emulador. Si bien en Steam Deck el proceso está ya muy maduro, en Android todavía hay partes algo experimentales, pero el resultado puede ser espectacular si te gusta tener todos tus sistemas retro bien organizados.

En el caso concreto de una Nintendo Switch con Android 10 (Switchroot), la idea es aprovechar el hardware de la consola como si fuera una portátil Android potente, instalando EmuDeck encima para gestionar todo el entorno de emulación. Eso sí, no es un montaje oficial ni soportado al 100 %, por lo que hay que ir con paciencia, copias de seguridad y sabiendo que puede no funcionar igual en todos los casos.

Requisitos previos y advertencias importantes

Antes de lanzarte a instalar EmuDeck en Android, especialmente en una Switch con Android 10, conviene tener claros algunos requisitos técnicos y riesgos básicos. Estamos hablando de una instalación que implica root, manipulación de particiones (en el caso de Switchroot) y uso de repositorios alternativos en Termux.

Para una Nintendo Switch con Android, el primer paso real sucede incluso antes de pensar en EmuDeck: preparar la tarjeta microSD, crear particiones e instalar Android siguiendo las guías de Switchroot. Ese proceso es relativamente conocido en la escena, pero no es trivial: hay que bootear con un payload, flashear imágenes, elegir versión de Android, etc. Aunque aquí no entraremos al detalle de ese apartado, es importante entender que sin un Android estable y funcional en la Switch, el resto no tiene sentido.

Una vez tengas Android funcionando en tu Switch, o en cualquier otro dispositivo compatible, necesitarás asegurarte de que cuentas con acceso root mediante Magisk. Esto será clave para poder mover archivos a rutas internas de Termux y para ciertas operaciones que requieren permisos elevados. De nuevo, el proceso de rooteo varía según el dispositivo, pero existen montones de tutoriales específicos para cada modelo que puedes seguir.

Por último, recuérdalo: todo este proceso implica riesgos de inestabilidad, pérdida de datos o mal funcionamiento del sistema. No es algo que debas hacer en un dispositivo de uso principal si no estás dispuesto a asumir fallos, pruebas y errores. Haz copias de seguridad, lee bien cada paso y no actualices cosas a lo loco en Termux, porque es justo ahí donde suelen empezar los problemas.

Preparar el acceso root y el explorador de archivos

El primer pilar de la instalación en Android, y especialmente en Switch, es tener un sistema con Magisk correctamente instalado y funcionando. Magisk te da root de forma relativamente limpia y te permite gestionar módulos adicionales si los necesitas. En el caso de la Switch con Android 10, la comunidad de Switchroot documenta bien cómo integrar Magisk en sus builds, por lo que lo habitual es seguir sus instrucciones paso a paso.

cómo usar Magisk en Android

Una vez tengas root operativo, el siguiente paso es contar con un explorador de archivos con soporte para acceso root. Hay aplicaciones muy conocidas en la Play Store y en repositorios alternativos (por ejemplo, MiXplorer, Solid Explorer con add-on de root, o similares) que permiten navegar por rutas del sistema como /data o /root. Esto te hará falta más adelante para mover el script de instalación de EmuDeck a la carpeta interna de Termux, donde no puedes entrar con un simple explorador sin permisos elevados.

Es buena idea comprobar desde el principio que tu explorador de archivos realmente tiene acceso a /data/data y puede leer y escribir en esas rutas. Si no, luego te encontrarás con errores tontos al mover el archivo setup.sh, y te tocará volver hacia atrás a cambiar de app o revisar la configuración de permisos.

Instalación de Termux y configuración de repositorios sin romper nada

El corazón de EmuDeck en Android es Termux, una aplicación que convierte tu Android en un entorno Linux de línea de comandos con gestor de paquetes propio. Sin embargo, no vale cualquier versión ni cualquier fuente de instalación, porque las más nuevas o las que vienen de la Play Store pueden tener repos duplicados, en desuso o incompatibles.

Para evitar esos problemas, la experiencia práctica demuestra que es mejor instalar la versión 0.117 de Termux desde F-Droid, y no desde la Play Store ni desde otros orígenes aleatorios. Descarga el APK de Termux 0.117 desde F-Droid, instálalo y, si el sistema lo pide, concédele permiso para instalar apps desde orígenes desconocidos. Este detalle puede no ser crítico en todos los dispositivos, pero ayuda a que todo funcione sin trabas.

Una vez abierto Termux por primera vez, el siguiente paso es cambiar los repositorios por defecto para evitar errores de actualización. Para ello, en la terminal escribe:

termux-change-repo

Se abrirá un asistente en modo texto donde deberás seleccionar las tres opciones disponibles y confirmar con Enter. Después, cuando te pida elegir servidor, selecciona el repositorio de la Universidad Tsinghua TUNA Association. Este punto es crucial porque algunos repositorios estándar de Termux o están caídos o dan problemas de compatibilidad con las operaciones que necesita EmuDeck.

Con los repositorios ya ajustados, toca realizar una actualización cuidada del entorno para que todo esté al día sin romper paquetes sensibles. El comando recomendado es:

apt-get -o "Dpkg::Options::=--force-confold" upgrade

Durante este proceso, Termux te preguntará si quieres continuar y possibly te pedirá confirmación para reemplazar algunos archivos de configuración. Acepta las opciones seguras y deja que finalice la actualización. Al terminar, tendrás una base casi lista, pero aún hay que afinar algunos paquetes clave.

Instalar las dependencias necesarias en Termux

configurar Termux para descargar vídeos web con yt-dlp

Con el sistema de paquetes medio actualizado, lo siguiente es instalar las herramientas que EmuDeck va a necesitar para descargarse, descomprimir archivos, sincronizar datos y ejecutar sus scripts. Para eso, desde Termux introduce el siguiente comando largo:

pkg install git wget jq rsync unzip whiptail binutils build-essential liblz4 libuv ninja

Este paquete de utilidades cubre prácticamente todo lo que el script de EmuDeck requiere: git para clonar repositorios, wget para descargas directas, jq para procesar JSON, rsync para copias eficientes y varios paquetes de compilación y bibliotecas que algunos componentes pueden necesitar. Aunque pueda parecer una lista exagerada, ahorra muchos problemas posteriores.

Después de esto, es buena idea revisar qué paquetes todavía se podrían actualizar sin jugárnosla. Para ello, en Termux escribe:

apt list --upgradable

Este comando mostrará una lista de todos los paquetes que tienen versiones nuevas disponibles. Aquí es donde hay que ir con cuidado, porque uno de los grandes puntos de fallo es actualizar paquetes que no se deben tocar. En concreto, es fundamental que NO actualices el paquete termux-tools; si lo haces, corres riesgo de romper el entorno y de que nada funcione como debería.

El resto de paquetes (excepto termux-tools) sí puedes actualizarlos manualmente, uno a uno, usando el formato:

pkg install nombre_del_paquete

De esta manera, controlas con precisión qué se actualiza y qué se mantiene en su versión estable. Tómate tu tiempo, revisa la lista y ve aplicando las actualizaciones que te interesen. Cuando hayas terminado, conviene ejecutar una limpieza rápida:

pkg autoclean

Así eliminas los archivos temporales de instalación y dejas Termux algo más ligero y ordenado, con todo al día salvo termux-tools, que debe permanecer intacto.

Descarga y modificación del script setup.sh de EmuDeck Android

Con Termux listo, llega una de las partes más delicadas del proceso: obtener el script de instalación de EmuDeck para Android y adaptarlo para que no reviente el entorno que acabas de configurar. El script oficial está alojado en GitHub, en la rama destinada a Android.

Desde el navegador web de tu dispositivo (no desde Termux), entra en la siguiente URL:

https://raw.githubusercontent.com/EmuDeck/EmuDeck-Android/beta/setup.sh

El contenido se mostrará como texto plano. En lugar de ejecutarlo directamente, debes guardar el archivo setup.sh en la memoria del dispositivo. Muchos navegadores permiten hacerlo manteniendo pulsado sobre la página o usando la opción de guardar en menú. Asegúrate de que el archivo se guarde con el nombre setup.sh y no como .txt u otra extensión extraña.

Luego, con tu editor de texto favorito (puede ser una app de notas avanzada o un editor de código para Android), abre el archivo setup.sh y localiza la parte del script vinculada a systemTermux y las operaciones de actualización. En concreto, debes eliminar del paréntesis de systemTermux todas las instrucciones que intentan actualizar y modificar Termux a su manera. Lo que hay que borrar del script es este bloque:

apt-get update && apt-get -o "Dpkg::Options::=--force-confold" upgrade -q -y --force-yes && apt-get -o "Dpkg::Options::=--force-confold" dist-upgrade -q -y --force-yes
pkg autoclean
pkg update -y && pkg upgrade -y

La razón es sencilla: ya has realizado tú mismo una actualización controlada y segura del entorno de Termux, y si dejas que el script vuelva a intentarlo a su manera, corres el riesgo de que te cambie repositorios, te actualice termux-tools u otros paquetes críticos y termine rompiendo el propio Termux.

Una vez eliminadas esas líneas, guarda el archivo setup.sh modificado. Asegúrate de que mantiene permisos de texto sin formato y que no ha cambiado el formato de fin de línea (la mayoría de editores modernos respetan esto sin problemas). Este pequeño ajuste es la clave para que la instalación de EmuDeck se ejecute sin tocar lo que no debe en tu entorno.

Colocar el script en la ruta correcta de Termux

Con el setup.sh ya editado, toca llevarlo a la ubicación específica donde Termux podrá encontrarlo sin complicaciones. Para ello, abre tu explorador de archivos con acceso root y navega hasta la ruta interna de Termux, que suele ser:

/data/data/com.termux/files/home/

Dentro de esa carpeta deberías ver, entre otras, la subcarpeta downloads. Si no existe, puedes crearla manualmente. El objetivo es mover el archivo setup.sh a:

/data/data/com.termux/files/home/downloads/

Para hacerlo, localiza el archivo setup.sh donde lo guardaste inicialmente (por ejemplo, en Downloads, Descargas o en la carpeta de tu navegador), selecciónalo y muévelo o cópialo a la carpeta downloads de Termux usando tu explorador con permisos root. Comprueba al final que la ruta sea exactamente la indicada y que el nombre del archivo sea setup.sh, respetando mayúsculas y minúsculas.

Este paso es el que suele dar más dolor de cabeza a usuarios sin root o con exploradores limitados, ya que las rutas dentro de /data/data están protegidas. Por eso es tan importante haber preparado el root con Magisk y un explorador de archivos competente.

Ejecutar la instalación de EmuDeck en Android desde Termux

configurar Termux para descargar vídeos web con yt-dlp

Ahora sí, con el script en su sitio, llega el momento de lanzar la instalación real de EmuDeck. Abre Termux de nuevo y, desde tu directorio home (o estando igualmente en cualquier ruta), escribe el siguiente comando:

bash /downloads/setup.sh

Este comando invocará el script setup.sh que has colocado previamente. A partir de ese momento, el script comenzará a descargar componentes, configurar rutas, instalar emuladores y preparar la estructura de carpetas necesaria para que EmuDeck funcione correctamente en Android.

Durante el proceso, es posible que aparezcan mensajes de confirmación, preguntas sobre rutas o configuraciones específicas, dependiendo de la versión concreta del script y de cómo el equipo de EmuDeck lo haya actualizado. Procura leer con calma lo que te pide y acepta las opciones por defecto si no tienes una necesidad muy concreta de cambiar algo.

Si todo va bien, la instalación avanzará sin errores graves y al cabo de un rato tendrás EmuDeck Android en funcionamiento. A partir de aquí podrás ir añadiendo tus ROMs, configurando mandos, ajustando emuladores y dejando tu biblioteca retro bien ordenada. No obstante, conviene recordar que este proceso no está garantizado en todos los dispositivos, y la Switch con Android puede ser especialmente caprichosa.

Limitaciones, errores frecuentes y la importancia del ensayo y error

Aunque la guía anterior parte de un caso de éxito parcial, no hay que perder de vista que no existe garantía de que EmuDeck para Android funcione en todas las Switch con Android 10, ni en todos los dispositivos Android en general. La diversidad de hardware, kernels, capas de personalización y versiones de Android hace que surjan comportamientos muy distintos entre usuarios.

En la experiencia compartida, el proceso supuso una semana entera de pruebas, errores, roturas de repositorios y reinstalaciones hasta dar con una fórmula estable. Termux, en particular, es muy sensible a cambios bruscos en los repos o a actualizaciones masivas sin control. Si cometes el error de actualizar termux-tools o de dejar que el script haga un dist-upgrade completo, puedes verte obligado a borrar datos de Termux y empezar de cero.

Por eso es tan importante asumir desde el principio que este montaje es más un proyecto de experimentación que un producto “plug and play”. Tómalo con calma, ve haciendo capturas de pantalla o notas de los comandos que te funcionen y no dudes en repetir pasos si algo no cuadra. Algunas personas de la comunidad han comentado incluso que, pese a seguir esta guía, en su Switch concreta no han conseguido un funcionamiento estable, lo cual entra dentro de lo esperable cuando se fuerza tanto un dispositivo fuera de sus usos oficiales.

Si se te bloquea el sistema, aparecen errores extraños en Termux o la instalación de EmuDeck se queda a medias sin explicación, es aconsejable acudir a las comunidades de Discord de EmuDeck y Switchroot, donde suelen estar al día de bugs recientes, cambios en los scripts o soluciones para problemas concretos.

EmuDeck para Android y su relación con otros sistemas como GammaOS

Más allá del caso específico de la Nintendo Switch con Android, EmuDeck para Android está empezando a extenderse a otros dispositivos portátiles, como consolas Android chinas y mini PCs. De hecho, la propia gente de EmuDeck ha publicado en su Patreon una versión funcional de EmuDeck Android que, según sus notas, ha sido probada en dispositivos como el Ayn Odin o ciertos modelos Pocket (por ejemplo, Pocket 3+).

emudeck

Esto ha generado bastante conversación en la comunidad sobre si EmuDeck Android podría llegar a sustituir o complementar sistemas personalizados como GammaOS en máquinas como la Anbernic RG405, RG505, o incluso futuros modelos más potentes tipo 556. GammaOS se centra en ofrecer una experiencia de sistema operativo completa y optimizada para juegos, mientras que EmuDeck se enfoca principalmente en la capa de emulación, automatizando la parte de instalación y configuración.

Si EmuDeck Android sigue madurando, no es descabellado pensar que pueda convertirse en una alternativa muy potente para quienes ya tienen un Android base estable y solo quieren mejorar la experiencia retro sin cambiar completamente de sistema operativo. En dispositivos donde GammaOS ya ofrece un entorno muy pulido, EmuDeck podría convivir como una herramienta adicional o, en algunos casos, como solución preferida si priorizas la versatilidad de Android stock.

En cualquier caso, hay que tener en cuenta que la versión de EmuDeck Android que se va moviendo en Patreon aún es relativamente joven. Esto implica cambios frecuentes, posibles bugs nuevos y la necesidad de estar atento a las notas de cada actualización. No conviene tratarlo todavía como algo completamente cerrado y definitivo, sino como un proyecto que está evolucionando a buena velocidad.

Uso de EmuDeck en Steam Deck y diferencias con Android

Aunque aquí nos centramos en Android, merece la pena comparar brevemente con la experiencia en Steam Deck, ya que es ahí donde EmuDeck se ha hecho realmente popular. En Steam Deck, EmuDeck actúa casi como un “mega script” para Linux que instala, configura y organiza todos los emuladores de golpe, integrándolos en la interfaz de SteamOS junto a tus juegos de Steam.

En ese entorno, la madurez es mucho mayor: el script oficial para Linux lleva más tiempo puliéndose, las rutas de instalación están muy estandarizadas y la comunidad ha generado cantidad de tutoriales y vídeos explicando cada rincón del sistema. Esto contrasta con Android, donde aún hay que hacer más ajustes manuales, lidiar con versiones distintas de Termux y pelearse con capas de fabricante.

Aun así, la idea de fondo es la misma: un único asistente que te evita tener que instalar RetroArch, Dolphin, PPSSPP, etc. uno por uno, y que además te deja todo bien ordenado. Si vienes de usar EmuDeck en Steam Deck, la versión Android te resultará familiar en su filosofía, aunque tengas que pasar por más pasos técnicos para llegar al mismo punto.

Comunidad, soporte y recursos adicionales

Uno de los grandes apoyos cuando te metes en un montaje así es la comunidad. Tanto en el lado de EmuDeck como en el de Switchroot existe una red activa de usuarios en Discord y foros como Reddit, donde se comparten guías, scripts modificados, soluciones a errores y hasta trucos muy específicos para mandos o configuraciones de red.

En estos canales, algunos usuarios han compartido incluso guías adicionales para resolver fallos concretos, como el error R1 relacionado con quedarse atascado usando un mando DualShock 4 (DS4 o mando de PS4 por Bluetooth) en la última versión de Android 10 sobre Switchroot. Estos problemas, muy específicos, no suelen aparecer en las guías generales, pero la comunidad suele documentarlos y proponer parches o ajustes de configuración.

Si te sientes atascado o frustrado, entrar en los Discord de EmuDeck y Switchroot puede marcar la diferencia entre abandonar el proyecto y conseguir por fin que todo funcione. Además, compartir tus propias pruebas y errores ayuda también a otros usuarios que quizá estén en la misma situación y agradezcan que alguien haya documentado un camino alternativo.

Todo este proceso de instalación de EmuDeck en Android, ya sea en una Nintendo Switch con Android 10 o en otros dispositivos, combina paciencia, curiosidad y mucha prueba y error; si cuidas la configuración de Termux, eliges bien los repositorios, evitas actualizar paquetes críticos como termux-tools y adaptas el script setup.sh para que no rompa tu entorno, tendrás muchas más probabilidades de disfrutar de una plataforma de emulación unificada y potente sobre Android, aprovechando al máximo herramientas creadas inicialmente para Steam Deck pero que hoy empiezan a brillar también en el ecosistema móvil.