RetroX
Plataforma de emulación retro auto-alojada ejecutada en navegador, basada en EmulatorJS. Permite gestionar colecciones, sincronizar guardados entre dispositivos y usar controles por gamepad o móvil sin instalar software adicional. Requiere Docker y gestión manual de ROMs.
Ficha actualizada 25 sept 2026, 9:55 · upstream 25 sept 2026, 9:46 · release v2.3.0
Qué es RetroX
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
RetroX es una solución de emulación web ligera que permite ejecutar consolas retro directamente desde el navegador mediante contenedores Docker. Utiliza Python como framework principal y soporta sistemas como Game Boy, N64 y PlayStation (PSX). La arquitectura está diseñada para ser eficiente, con imágenes de menos de 150 MB y requisitos bajos de recursos (1 CPU, 1 GB RAM), ideal para servidores domésticos o VPS económicos.
La plataforma destaca por su capacidad de sincronización continua de guardados en la nube local, permitiendo continuar partidas en diferentes dispositivos sin perder progreso. Incluye soporte nativo para controles de gamepad, incluyendo la funcionalidad "móvil como mando" mediante QR. Además, ofrece gestión multiusuario con autenticación opcional y panel administrativo para configurar emuladores y metadatos.
El despliegue se realiza mediante Docker, utilizando un volumen persistente para almacenar ROMs, bases de datos y guardados en una carpeta local `data/`. El sistema permite añadir nuevos núcleos de emulación manualmente descargando archivos `.data` desde EmulatorJS. La licencia es GPLv3 y la interfaz es responsiva para móviles, tablets y televisores.
- Crear un centro de entretenimiento retro en una TV o navegador sin instalar software pesado.
- Sincronizar partidas entre varios dispositivos (laptop, móvil) mediante guardados en el servidor.
- Gestionar una biblioteca de ROMs localmente con metadatos y portadas editables vía panel admin.
- Utilizar un teléfono móvil como controlador inalámbrico para juegos retro sin emparejar Bluetooth.
- Ejecutar sesiones locales de multijugador en consolas como N64 o PSX conectando dos gamepads.
- Imagen Docker ligera inferior a 150 MB con requisitos mínimos de 1 CPU y 1 GB RAM.
- Sincronización automática de guardados en segundo plano entre dispositivos conectados al servidor.
- Soporte completo para controles de gamepad y funcionalidad "móvil como mando" vía QR.
- Gestión de juegos multi-disc (ej. PSX) con carga secuencial de archivos `.cue` y `.bin`.
- Panel administrativo para añadir emuladores personalizados mediante núcleos `.data` de EmulatorJS.
- Interfaz responsiva compatible con móviles, portátiles y televisores sin necesidad de teclado o ratón.
- Requiere gestión manual de la carpeta `data/roms/` para añadir juegos y núcleos nuevos.
- No incluye Docker Compose por defecto en el análisis técnico (requiere configuración manual o uso del ejemplo).
- La sincronización de guardados depende de la conexión activa al servidor local.
- Soporte limitado a sistemas retro específicos (GB, GBA, N64, PSX) sin núcleos adicionales preinstalados.
- Licencia GPLv3 requiere distribución del código fuente si se modifica o redistribuye el software.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Ejecutar `docker run -d --name retrox -p 8080:8080 -v $(pwd)/data:/data poliuscorp/retrox`. Crear carpeta `data/` para persistencia de ROMs y guardados. Usar credenciales iniciales admin/admin. Para añadir sistemas, descargar núcleos `.data` en `data/cores/` y escanear desde el panel admin. Actualizar con `docker pull` y reiniciar contenedor.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.