Cómo configurar Moonlight en Raspberry Pi 5 para streaming de juegos sin límites

Durante los últimos años, el Raspberry Pi se ha ganado un hueco en la comunidad gamer como una alternativa compacta y eficiente para crear una consola de streaming casera. Si alguna vez has imaginado disfrutar tus juegos de PC favoritos en el televisor del salón, sin tener que mover tu torre o tirar cables interminables, la combinación del Raspberry Pi 5 y Moonlight puede ser tu solución ideal.

Este artículo aborda absolutamente todo lo que necesitas saber para transformar tu Raspberry Pi 5 en un centro de juegos en streaming utilizando Moonlight. Explicaremos preparativos, configuración, problemas frecuentes, consejos de optimización y hasta automatización avanzada para que logres la mejor experiencia posible, integrando los detalles más relevantes de los tutoriales, foros y experiencias de usuarios que lideran los resultados en Google.

¿Qué es Moonlight y por qué usarlo?

Moonlight es un software libre que permite jugar en streaming desde tu PC principal (u otro dispositivo potente) a cualquier otro equipo más sencillo, como un Raspberry Pi. Para lograrlo, utiliza el protocolo GameStream de Nvidia, aunque hoy en día se suele usar Sunshine como servidor compatible en el PC, incluso si tu gráfica no es Nvidia.

El Raspberry Pi, en particular el modelo 5, destaca en este contexto porque ofrece una excelente relación calidad-precio, bajo consumo eléctrico y suficiente potencia para decodificar el vídeo HD o incluso 4K en tiempo real. Esto te permite jugar en otra habitación o aprovechar tu televisor grande sin perder calidad de imagen ni lidiar con retardo molesto, siempre que la red esté bien preparada.

¿Qué hardware y software necesitas para tu proyecto?

Antes de entrar en detalles técnicos, conviene tener claro lo mínimo necesario:

• Raspberry Pi 4 o 5 (el 5 es más potente y recomendable para streamings exigentes o resolución 4K)
• Tarjeta microSD de 16 GB o más para el sistema operativo
• Fuente de alimentación oficial (27W para el Pi 5, activa mejor la refrigeración si puedes)
• Cable microHDMI 2.1 para conectar a tu televisor o monitor
• Teclado y ratón USB (al menos para la configuración inicial)
• Red Ethernet (recomendadísima para reducir latencia y cortes)
• PC principal con Windows y una GPU compatible, donde instalarás Sunshine
• Mando (Xbox, PlayStation, compatible con el Pi y los juegos que quieras disfrutar)

Preparando el Raspberry Pi 5: sistemas y actualizaciones

El primer paso es instalar Raspberry Pi OS Bookworm Lite (64 bits), que ofrece la mejor compatibilidad y rendimiento sobre el Pi 5. Es muy recomendable mantener todo el sistema actualizado antes de avanzar:

Actualiza tu Raspberry Pi ejecutando en la terminal:

sudo apt update && sudo apt full-upgrade -y

También deberás instalar los siguientes paquetes:

• curl: para descargar el repositorio oficial de Moonlight
• pulseaudio: imprescindible para transmitir el audio del juego desde el PC al Raspberry Pi

Hazlo con:

sudo apt install curl pulseaudio

Después, asegúrate de que PulseAudio se inicia siempre automáticamente:

sudo systemctl --global enable pulseaudio

Instalando Moonlight en el Raspberry Pi

Con el sistema preparado, solo te falta instalar el cliente de Moonlight. Ejecuta:

curl -1sLf 'https://dl.cloudsmith.io/public/moonlight-game-streaming/moonlight-qt/setup.deb.sh' | distro=raspbian codename=$(lsb_release -cs) sudo -E bash

Cuando termine, instala el cliente:

sudo apt install moonlight-qt

Hasta aquí, ya tienes Moonlight listo y funcional en tu Raspberry Pi. Para una experiencia de «consola real», muchos usuarios prefieren que Moonlight se ejecute automáticamente al encender el Pi. Hazlo añadiendo una línea al cron:

crontab -e

Y después:

@reboot moonlight-qt

Tras guardar y salir, reinicia el sistema y verás cómo la interfaz de Moonlight aparece al arrancar.

Configurando el servidor de streaming en tu PC: Sunshine

En el PC principal necesitarás instalar Sunshine, un software libre alternativo a Nvidia GameStream (ahora descontinuado). Una vez instalado:

• Crea un usuario y configura la seguridad inicial
• Añade manualmente los juegos y aplicaciones que quieras transmitir
• Apunta la dirección IP de tu PC, la necesitarás para emparejar Moonlight

Cuando abras Moonlight en el Pi, detectará el servidor automáticamente o te permitirá añadirlo manualmente usando la IP. La primera vez, verás un PIN de emparejamiento que deberás introducir en la web de Sunshine para autorizar la conexión. Una vez emparejados PC y Raspberry, ya puedes seleccionar el escritorio o cualquier juego disponible y transmitirlo.

Detalles clave en la configuración de vídeo y audio

Uno de los atractivos del Raspberry Pi 5 es su soporte para decodificación de vídeo por hardware, lo que permite streaming de alta calidad (FullHD, 4K, incluso alto bitrate y HDR) sin sobrecargar el procesador. Eso sí, hay que ajustar algunos parámetros para sacar el máximo partido:

• Resuelve problemas de imagen negra o artefactos: Si tienes un televisor 4K y usas el puerto microHDMI más cercano a la fuente de alimentación, asegúrate de configurar correctamente el archivo egls.json para detallar resolución, refresco y profundidad de color.
• Ajusta decodificador y codificador: Por lo general, lo mejor es dejar ambos como «Automático» en Moonlight, pero puedes forzar HEVC (H.265) si tu gráfica lo soporta para menor latencia y mayor calidad.
• Activa soporte HDR: Esta función está en fase experimental, pero puede activarse en la interfaz de Moonlight si la transmisión y la pantalla lo soportan. Ten cuidado de ejecutar Moonlight desde consola (no desde el entorno gráfico) para evitar problemas.
• Si el audio no funciona: Normalmente, tras instalar PulseAudio y configurarlo, todo debería ir bien. Si se resiste, prueba a lanzar Moonlight con SDL_AUDIODRIVER=pulseaudio moonlight-qt o ajusta la salida de audio desde raspi-config.

Rendimiento y problemas frecuentes en Raspberry Pi 5

En la práctica, la comunidad ha detectado algunos puntos conflictivos al usar Moonlight en el Raspberry Pi 5:

• El soporte de HEVC (H.265) en hardware puede fallar con versiones recientes de kernel (6.12), arrojando errores como «No functioning hardware accelerated video decoder was detected by Moonlight». Si esto ocurre, prueba a volver a la decodificación por software o revisa foros para posibles actualizaciones.
• En algunos juegos o configuraciones, la decodificación H.264 sigue funcionando perfectamente, así que si tienes problemas con el códec moderno, prueba a forzar el antiguo.
• El steam link oficial no está disponible en ARM64, así que Moonlight y Sunshine son actualmente la mejor opción para streaming avanzado en Pi 5.
• Algunos usuarios han reportado errores relacionados con FFmpeg, SDL o Qt. Han compartido logs y soluciones temporales en repositorios como GitHub – moonlight-stream/moonlight-qt. Merece la pena consultar estos hilos, ya que los desarrolladores suelen responder activamente.

Consejos para mejorar la experiencia de juego

Para que la sensación al jugar sea realmente «de consola», te recomendamos algunos extras:

• Controladores: Los mandos de Xbox suelen funcionar a la primera conectados por USB y usando el driver xone. Si el Bluetooth da problemas, considera desactivarlo para evitar interferencias.
• Wake On Lan (WOL): Activa esta opción en tu PC para poder encenderlo automáticamente desde el Pi antes de jugar, usando herramientas como etherwake.
• Automatización avanzada con udev: Hay usuarios que han creado reglas para que, simplemente conectando el mando al Pi, se despierte el ordenador, espere la conexión y arranque Moonlight de forma automática. Esto implica crear scripts personalizados y reglas en /etc/udev/rules.d, pero el control y la comodidad mejoran muchísimo.
• Logs y depuración: Si automatizas procesos, no olvides registrar logs en archivos accesibles para saber si los scripts se ejecutan correctamente.

Precauciones y detalles avanzados

En los foros y la documentación oficial aparece información útil para usuarios avanzados:

• Si usas Raspberry Pi OS Lite, configura correctamente PulseAudio siguiendo las instrucciones. Desde el menú de raspi-config puedes fijar la salida de audio y reiniciar si hace falta.
• En versiones antiguas de Raspberry Pi OS (Buster o Bullseye), es necesario editar /boot/config.txt para activar overlays específicos (como dtoverlay=rpivid-v4l2). Esto NO es necesario con la Pi 5 y Bookworm.
• Para transmitir contenido HDR, igual debes modificar /boot/config.txt y cambiar dtoverlay=vc4-fkms-v3d por dtoverlay=vc4-kms-v3d, pero esto solo es relevante en modelos anteriores.
• Si necesitas forzar un decodificador alternativo para evitar conflictos con Kodi u otros reproductores en la Pi, usa el parámetro --video-decoder v4l2m2m.
• Aumenta la memoria GPU si transmites en 4K 60Hz, especialmente desde el menú de raspi-config.