Guía de Phosphor OS
Phosphor OS convierte una Raspberry Pi en una consola retro que arranca directamente en su propio menú. Funciona en televisores y monitores CRT (con las placas RGBerry, por SCART o VGA) y en pantallas planas por HDMI, también en vertical para muebles arcade.
Es gratuito. Las placas RGBerry se venden aparte, pero no son necesarias para usar Phosphor OS por HDMI.
1. Qué necesitas
| Raspberry Pi | Pi 4 / Pi 400 (recomendada), Pi 5 / Pi 500, Pi 3 o Zero 2 W |
| microSD | 8 GB o más (mejor 32 GB o más si vas a tener muchos juegos). A1 / Class 10 |
| Alimentación | La oficial de cada modelo: Pi 4/400 → USB-C 5 V 3 A · Pi 5/500 → USB-C 27 W · Pi 3/Zero 2 W → micro-USB 2,5 A |
| Pantalla | Por HDMI (TV o monitor) o por SCART/VGA con una placa RGBerry |
| Mando | Cualquier mando USB o Bluetooth. Un teclado USB también sirve |
Rendimiento orientativo:
| Sistema | Zero 2 W / Pi 3 | Pi 4 / 400 | Pi 5 / 500 |
|---|---|---|---|
| NES, Master System, Game Boy, PC Engine | ✓ | ✓ | ✓ |
| SNES, Mega Drive, Game Gear | ✓ (casi todo) | ✓ | ✓ |
| PlayStation | justo | ✓ | ✓ |
| Arcade (MAME 2003-Plus) | según el juego | ✓ casi todo | ✓ |
| Filtro CRT en HDMI | — | ligero / CRT-Pi | todos |
2. Grabar la tarjeta
- Descarga
phosphor-os-rpi.img.xz. No hace falta descomprimirlo. - Abre Raspberry Pi Imager (o balenaEtcher).
- Elegir sistema operativo → Usar personalizado y selecciona el
.img.xz. - Elige la microSD y graba. Se borra todo lo que tenga.
En Raspberry Pi Imager no uses la "personalización" (usuario, Wi-Fi...): Phosphor OS no la lee. El Wi-Fi se configura como se explica en el apartado 5.
3. Primer arranque
Mete la tarjeta, conecta pantalla y mando y enciende. Verás la animación de Phosphor OS y, la primera vez, el sistema crea una partición llamada SHARE en el espacio libre de la tarjeta (tarda unos segundos). Después aparece el menú con el aviso "Aún no hay juegos".
Salida de vídeo
- Sin placa RGBerry: sale por HDMI a la resolución de la pantalla.
- Con placa RGBerry: se detecta sola y usa SCART o VGA según sus interruptores. El HDMI queda apagado.
| Interruptor 1 | Interruptor 2 | Salida |
|---|---|---|
| OFF | — | SCART (TV de 15 kHz, resolución original de cada juego) |
| ON | OFF | VGA 31 kHz (monitor de PC, 640×480) |
| ON | ON | VGA 15 kHz (monitor arcade o multifrecuencia) |
Si algo no se ve bien, consulta el apartado 9.
4. Añadir juegos
Phosphor OS no incluye juegos. Usa solo copias de juegos que tengas.
Desde el ordenador (lo más fácil)
- Apaga la consola (Ajustes → Apagar) y saca la microSD.
- Métela en el PC. Aparecerán dos unidades: PHOSPHOR (arranque, no la toques salvo
para
wifi.txt) y SHARE. - Copia cada juego en
SHARE/roms/<sistema>:
| Carpeta | Sistema | Formatos |
|---|---|---|
nes |
NES / Famicom | .nes .fds .unf .zip .7z |
snes |
Super Nintendo | .sfc .smc .fig .swc .bs .st .zip .7z |
megadrive |
Mega Drive / Genesis | .md .gen .smd .bin .zip .7z |
mastersystem |
Master System | .sms .zip .7z |
gamegear |
Game Gear | .gg .zip .7z |
segacd |
Mega-CD | .cue .chd .iso .m3u |
pcengine |
PC Engine / TurboGrafx | .pce .cue .chd .sgx .zip .7z |
psx |
PlayStation | .cue .chd .pbp .m3u .exe |
gb |
Game Boy | .gb .zip .7z |
gbc |
Game Boy Color | .gbc .zip .7z |
arcade |
Arcade (MAME 2003-Plus) | .zip .7z |
- Vuelve a meter la tarjeta y enciende. En el menú solo aparecen los sistemas que tienen juegos.
Arcade: los zip tienen que ser del set de MAME 2003-Plus; los de otras versiones
de MAME a menudo no funcionan. Las BIOS de arcade (neogeo.zip, etc.) van en la misma
carpeta arcade. No aparecen en la lista, porque no son juegos.
PlayStation y CD: usa .chd (un fichero por disco, ocupa menos) o .cue + .bin.
Para juegos de varios discos, crea un .m3u con un disco por línea.
Por red
Con el Wi-Fi o el cable conectados, la consola acepta SCP en el puerto 22 (usuario root,
contraseña phosphor). Con WinSCP elige el protocolo SCP y copia a
/userdata/roms/<sistema>. Desde la terminal:
scp -O "Super Metroid.sfc" root@<IP>:/userdata/roms/snes/
La IP aparece en Ajustes → Información. Al copiar por red, vuelve al menú de inicio y entra de nuevo en el sistema, o reinicia, para ver los juegos nuevos.
BIOS
Algunos sistemas necesitan la BIOS original, que no se incluye. Va en SHARE/bios:
| Sistema | Fichero | ¿Obligatoria? |
|---|---|---|
| PlayStation | scph5501.bin (USA) · scph5502.bin (EUR) · scph5500.bin (JAP) |
Recomendada (sin ella funciona con una BIOS libre menos compatible) |
| Mega-CD | bios_CD_E.bin · bios_CD_U.bin · bios_CD_J.bin |
Sí |
| PC Engine CD | syscard3.pce |
Sí, para juegos en CD |
| Famicom Disk System | disksys.rom |
Sí, para .fds |
| Game Boy / Color | gb_bios.bin · gbc_bios.bin |
No (solo la animación de inicio) |
Capturas en la lista
Si pones una imagen PNG con el mismo nombre que el juego en roms/<sistema>/media/, se
ve en el panel de la lista de juegos (en HDMI). Por ejemplo:
roms/snes/media/Super Metroid.png.
5. Wi-Fi y Bluetooth
Wi-Fi
- Desde el menú: Ajustes → Wi-Fi. Busca redes, elige la tuya y escribe la contraseña con el teclado en pantalla. Si tienes un teclado USB conectado, puedes escribir directamente con él.
- Desde el PC, antes de arrancar: en la unidad PHOSPHOR edita
wifi.txt, quita los#y pon tu red:
SSID="MiRed"
PASSWORD="MiContraseña"
COUNTRY=ES
Las redes se guardan en SHARE, así que no se pierden al actualizar Phosphor OS.
Mandos Bluetooth
Ajustes → Bluetooth → Buscar mandos. Pon el mando en modo emparejamiento antes de buscar:
| Mando | Modo emparejamiento |
|---|---|
| 8BitDo | Mantén Start + el botón del modo (X, B...) y luego el de emparejar |
| DualShock 4 | Mantén Share + PS hasta que la luz parpadee rápido |
| DualSense | Mantén Create + PS |
| Switch Pro | Botón pequeño de arriba, junto al USB-C |
Elige el mando en la lista y se empareja solo. La próxima vez basta con encenderlo. Para olvidar un mando, pulsa A dos veces sobre él.
6. Usar el menú
| Botón | En el menú |
|---|---|
| Cruceta | Moverse |
| A | Entrar / jugar |
| B | Volver |
| Y | Marcar como favorito |
| L / R | Filtro: todos, favoritos, recientes |
| START | Ajustes |
Con teclado: flechas, Enter (A), Esc o Retroceso (B), Y (favorito), Q/W (L/R) y Tab (Ajustes). Si no tienes ni mando ni teclado, el ratón sirve de emergencia: la rueda mueve, el clic izquierdo entra, el derecho vuelve y la rueda pulsada abre Ajustes.
Durante el juego
- SELECT + START: menú rápido de RetroArch (guardar y cargar partida, opciones...). Allí, Cerrar contenido vuelve al menú de Phosphor.
- Con teclado, Esc sale del juego.
7. Ajustes
| Ajuste | Qué hace |
|---|---|
| Salida | Auto usa los interruptores de la placa. Forzar otra salida requiere reiniciar |
| Monitor | Solo CRT: TV de 15 kHz, monitor arcade de 15 kHz o VGA de 31 kHz |
| Centrado H / V | Solo CRT: mueve la imagen si se sale por un lado |
| Filtro CRT | Solo HDMI: scanlines o simulación de tubo (CRT-Pi es el más fiel) |
| Patrón de ajuste | Rejilla y barras para centrar y ajustar el monitor. En CRT, la cruceta centra en directo |
| Rotación | 0°, 90° o 270°, para monitores en vertical |
| Tema | Cambia el aspecto del menú (ver más abajo) |
| Animación de arranque | Activa o quita el logo animado al encender |
| Sonidos del menú | Los "blips" al moverte |
| Mandos | Ver los conectados y configurar uno que no responda bien |
| Wi-Fi / Bluetooth | Ver apartado 5 |
| Información | Modelo, placa, salida, IP y espacio libre |
Configurar un mando que no funciona bien
Si un mando USB barato tiene los botones cambiados, en Ajustes → Mandos elígelo y pulsa A. El asistente te pide cada botón por su posición. Si tu mando no tiene alguno (X/Y, L/R, SELECT), espera 6 segundos y se salta solo. La configuración sirve para el menú y para los juegos.
Temas
Los temas van en SHARE/themes/<nombre> y se eligen en Ajustes → Tema. Un tema puede
cambiar solo los colores o todo el diseño. Ver docs/TEMAS.md del proyecto.
8. Ajustes avanzados (SHARE/phosphor.conf)
El mismo fichero que cambia el menú se puede editar desde el PC:
PHOS_FORCE_OUTPUT=hdmi # scart | vga | hdmi (vacío = automático)
PHOS_FORCE_MONITOR= # generic_15 | arcade_15 | vga
PHOS_CENTER_H=0
PHOS_CENTER_V=0
PHOS_ROTATION=0 # 0 | 90 | 270
PHOS_CRT_FILTER=none # none | scanlines | light | crtpi | lottes
PHOS_THEME=phosphor
PHOS_SPLASH=1
PHOS_UI_SOUNDS=1
PHOS_FRONTEND=phosphor # retroarch = usar el menú de RetroArch en su lugar
PHOS_DEBUG=0 # 1 = registro detallado de RetroArch
La configuración de RetroArch está en SHARE/system/configs/retroarch/retroarch.cfg y las
partidas en SHARE/saves y SHARE/states.
9. Solución de problemas
No se ve nada por HDMI con la placa RGBerry puesta. Es lo normal: con placa, el HDMI
se apaga. Quita la placa o pon PHOS_FORCE_OUTPUT=hdmi en phosphor.conf.
La imagen del CRT está desplazada o cortada. Ajustes → Patrón de ajuste y centra con la cruceta. Si el monitor tiene mandos de geometría, ajústalos con el patrón.
Un sistema no aparece en el menú. Comprueba que los juegos están en la carpeta correcta (apartado 4) y con una extensión de la lista.
Un juego de arcade no arranca. Casi siempre es un zip de otra versión de MAME. Usa el
set de MAME 2003-Plus y, si el juego necesita BIOS (Neo Geo, por ejemplo), pon también
el zip de la BIOS en roms/arcade.
El mando no responde en los juegos, pero sí en el menú. Configúralo en Ajustes → Mandos.
Se ha quedado en negro después de la animación. Espera unos segundos: si el menú
falla tres veces seguidas, arranca el menú de RetroArch como alternativa. Si quieres
mirar qué ha pasado, entra por SSH (ssh root@<IP>, contraseña phosphor) y revisa
/userdata/system/logs/phosphor-ui.log y retroarch.log.
10. Licencias
Phosphor OS es software libre y gratuito. Algunos emuladores incluidos (Snes9x, Genesis Plus GX y MAME 2003-Plus) tienen licencias que no permiten el uso comercial: no vendas tarjetas SD con Phosphor OS ya grabado ni lo incluyas en un producto de pago.