Cómo instalar Dusklight (Twilight Princess PC) en Linux — AppImage x86_64 + ARM64

Instala Dusklight (antes Dusk), el port nativo para PC de The Legend of Zelda: Twilight Princess, en Linux. Evita el bug de permisos del AppImage, encuentra las rutas reales de partidas y elige el backend gráfico correcto para tu distro.

Publicado 2026-05-10 ·Actualizado 2026-06-20

Esta guía cubre cómo instalar Dusklight (antes Dusk) — el port nativo para PC de Twilight Princess — en Linux desktop. Para Steam Deck, mira la guía dedicada de Steam Deck (en inglés; el Deck usa el mismo binario Linux x86_64 pero el flujo de configuración es distinto).

Tiempo necesario: ~10 minutos Dificultad: Fácil

ℹ️ Linux ahora se distribuye como AppImage (x86_64 y ARM64)

v1.4.1 (2026-06-16) publica AppImages para Linux x86_64 y, de forma nativa, para ARM64. Ya no hace falta recurrir a builds antiguas: ambos arquitectura llegan como .AppImage.

El bug de permisos del AppImage (#818) que antes causaba errores fatales de arranque como:

[fatal] [dusk] Unable to get PrefPath: Couldn't create directory '/TwilitRealm': 'Permission denied'

…parece haber sido sorteado, ya que AppImage es ahora la ruta oficial de distribución en Linux. Si todavía ves ese error en v1.4.1, abre un issue.

Si antes corriste el AppImage de v1.0.0 y dejaste una carpeta huérfana /TwilitRealm en la raíz, límpiala: sudo rm -rf /TwilitRealm (ejecuta solo si estás seguro de que esa ruta es tuya).

Antes de empezar

1. Identifica tu arquitectura

En terminal:

uname -m

x86_64 → la mayoría de desktops, laptops y Steam Deck → usa el build x86_64
aarch64 / arm64 → Raspberry Pi 5, laptops ARM → usa el build arm64

2. Soporte Vulkan (recomendado)

Dusklight soporta 7 backends gráficos, pero Vulkan y OpenGL son los típicos defaults en Linux. Verifica que Vulkan esté disponible:

Ubuntu / Debian:

sudo apt install vulkan-tools mesa-vulkan-drivers
vulkaninfo --summary

Arch:

sudo pacman -S vulkan-tools vulkan-icd-loader

Fedora:

sudo dnf install vulkan-tools mesa-vulkan-drivers

Si por alguna razón Vulkan no funciona, puedes cambiar a OpenGL u OpenGL ES en Settings → Prelaunch → Graphics Backend.

3. Tu propio volcado del disco de GameCube de Twilight Princess

Obligatorio. Mira Cómo volcar legalmente tu disco de TP (en inglés).

Soportado en v1.0.0:

GameCube USA (GZ2E01) — SHA-1 75edd3ddff41f125d1b4ce1a40378f1b565519e7
GameCube PAL (GZ2P01) — SHA-1 2601822a488eeb86fb89db16ca8f29c2c953e1ca

Paso 1 — Descargar Dusklight

Toma el AppImage desde github.com/TwilitRealm/dusklight/releases:

Arquitectura	Archivo	Tamaño	Notas
x86_64	`Dusklight-v1.4.1-linux-x86_64.AppImage`	32.0 MB	La mayoría de PCs, laptops y Steam Deck
ARM64	`Dusklight-v1.4.1-linux-arm64.AppImage`	30.7 MB	AppImage nativo (Raspberry Pi 5, laptops ARM)

⚠️ Cuidado: existe un juego adulto llamado “Dusklight Manor” sin relación. Descarga solo desde GitHub TwilitRealm o twilitrealm.dev.

Verifica la descarga:

sha256sum ~/Downloads/Dusklight-v1.4.1-linux-x86_64.AppImage

Compara la salida con lo que publique la página de releases de GitHub para ese asset.

Paso 2 — Hacerlo ejecutable

cd ~/Downloads
chmod +x Dusklight-v1.4.1-linux-x86_64.AppImage
mkdir -p ~/Applications && mv Dusklight-v1.4.1-linux-x86_64.AppImage ~/Applications/

Puede que también necesites libfuse2 para AppImages en algunas distros:

Ubuntu/Debian: sudo apt install libfuse2
Arch: sudo pacman -S fuse2
Fedora: usualmente preinstalado

Paso 3 — Verificar la ROM

sha1sum ~/path/to/your-dump.iso

El SHA-1 debe coincidir con 75edd3ddff41f125d1b4ce1a40378f1b565519e7 (NTSC-U) o 2601822a488eeb86fb89db16ca8f29c2c953e1ca (PAL).

Paso 4 — Primer arranque

~/Applications/Dusklight-v1.4.1-linux-x86_64.AppImage

Se abre la ventana de prelaunch de Dusklight. Haz clic en Select Disc Image, busca tu volcado del disco y espera a que “Verifying disc image” termine. Cuando el estado diga “Disc ready.”, haz clic en Play.

Paso 5 — Configurar control (mando) / giroscopio

Ruta verificada:

Settings → Input → Controller → Configure Controller

Se abre la ventana por puerto con pestañas Port 1, Port 2, … y páginas Controller / Buttons / Triggers / Sticks / Rumble.

Para activar el apuntado por giroscopio:

Settings → Input → Gyro → Gyro Aim (activar)

Linux soporta DualShock 4/5, Switch Pro Controller (con el módulo de kernel hid-nintendo en la mayoría de distros), 8BitDo Pro 2, Xbox Wireless vía xpadneo y más.

Para usar apuntado por ratón:

Settings → Input → Gyro → Gyro Input Method → Mouse

Ubicación de las partidas guardadas

~/.local/share/TwilitRealm/Dusklight/USA/Card A/01-GZ2E01-gczelda2.gci

Para el disco PAL, reemplaza USA por EUR.

ℹ️ El escritorio ahora usa la carpeta Dusklight. Si venías de una versión con marca Dusk, tu carpeta antigua ~/.local/share/TwilitRealm/Dusk/ se migra automáticamente al primer arranque.

Si ~/.local/share/TwilitRealm/Dusklight/ no existe tras el primer arranque, mira la sección solución del #818 abajo.

Migrar desde Dolphin

Partidas de Dolphin en Linux: ~/.local/share/dolphin-emu/GC/USA/Card A/01-GZ2E01-gczelda2.gci. Copia a la carpeta de Dusklight. Reinicia Dusklight.

Notas por distro

Ubuntu / Debian

Funciona de fábrica en 22.04+. Para releases más antiguos puede que necesites instalar libsdl3-0 desde un repositorio de backports o compilar SDL3 desde el código fuente.

Arch / Manjaro

Funciona. Asegúrate de tener vulkan-tools y el paquete de driver correspondiente (vulkan-radeon o nvidia-utils).

Fedora

Funciona. Misma historia de Vulkan que Arch.

NixOS

El repo incluye flake.nix y flake.lock. Compilar desde el código fuente es el camino soportado.

Otras distros

Prueba el binario; si Vulkan falla, cambia el backend gráfico en Settings → Prelaunch.

Problemas comunes

”Couldn’t create directory ‘/TwilitRealm’: ‘Permission denied’”

Este era el bug de la variante AppImage de v1.0.0 (#818). Como AppImage es el formato oficial de Linux, el comportamiento de fondo fue ajustado. Si todavía ves esto en v1.4.1, abre un issue nuevo y limpia cualquier carpeta huérfana /TwilitRealm en la raíz: sudo rm -rf /TwilitRealm (solo si estás seguro de que es tuya).

Vulkan no encontrado

Instala mesa-vulkan-drivers (Ubuntu/Debian) o vulkan-radeon/nvidia-utils (Arch) y reinicia. O cambia a OpenGL en Settings → Prelaunch → Graphics Backend.

El audio no funciona

La mayoría de las distros usan PipeWire por defecto; Dusklight debería detectarlo automáticamente. Si no, instala pipewire-pulse para el shim de compatibilidad con PulseAudio.

El juego corre pero no puede asignar teclado

El binding de teclado en Linux funciona según los reportes (el issue #830 es específico de macOS). Si tienes problemas de binding en Linux, revisa la página de issues de GitHub para reportes recientes.

Tirones con framerate desbloqueado

Problema conocido: artefacto de bloom pulsante con framerate desbloqueado (#825). Bloquea el framerate o convive con la rareza visual.

Necesitas compilar desde el código fuente

Según docs/building.md:

Ubuntu 24.04, Arch, Fedora soportados
CMake 3.25+
Python 3+
Presets de build: linux-default-relwithdebinfo, linux-default-debug, linux-clang-relwithdebinfo, linux-clang-debug

Problemas comunes en Linux

“Couldn’t create directory ‘/TwilitRealm’: Permission denied” (AppImage) → fix del #818
Hash verification failed → guía de solución
Error de juego no soportado → guía por región
Atascado a 30 FPS → checklist
Partida de Dolphin no carga → guía de migración
Hub completo → todos los problemas conocidos

¿Qué probar después?

🎨 Instalar el pack de texturas 4K Henriko Magnifico (ruta: ~/.local/share/TwilitRealm/Dusk/texture_replacements/)
🚀 Framerate y 60 FPS, explicado
💾 Rutas de partidas y sincronización entre dispositivos
🎮 Guía específica para Steam Deck (usa este mismo build Linux x86_64)

Última actualización: 2026-06-20. Actualizamos esta guía cuando salen parches específicos de Linux.

← Todas las guías de instalación (EN) · Guía pilar (EN) →