Ryujinx Canary

Solução de problemas

Checagens rápidas para “não abre”. Chaves, firmware e jogos: veja a documentação oficialprimeiro; wiki Forge para casos raros.

App não inicia (Windows)

  • Instale o .NET Desktop Runtime indicado no erro (via Microsoft).
  • Permita o app no Windows Security se estiver em quarentena.
  • SmartScreen: Mais informações → Executar mesmo assim (arquivos oficiais).
Baixar .NET (Microsoft)

Quebrou após atualizar

Em Canary ou Stable, abra tag antiga e baixe o mesmo asset de plataforma. Caminhos via Arquivo → Abrir pasta Ryujinx quando um build abrir. Faça backup.

Escolher build e reverter

Asset errado

x64 e ARM64 são diferentes; baixe o que combina com seu PC. Passos de instalação.

Linux / SteamOS

  • AppImage não roda: chmod +x ou marque executável nas propriedades.
  • Steam Deck: use build x64 Linux, não ARM64. Veja Linux → Steam Deck.
  • Não abre após instalação antiga: feche Ryujinx, renomeie ~/.config/Ryujinx, abra de novo (config limpa) e repita primeira configuração.
  • Forge / GitLab fora ou login: pode ser manutenção — veja Ryubing/fóruns ou tente depois; abra tag e Assets direto quando o host permitir.
  • Modo jogo (Deck) — Apply/OK: abra teclado Steam (Steam + X), focus com Tab para Apply → OK; input Steam Controller em Options → Settings → Input (também Setup → Steam Deck).
  • Teclado virtual ausente após sleep? reinício completo costuma recuperar.

Gráficos / som / entrada

Teste Vulkan vs OpenGL e confira Options. Docs completos:

Downloads oficiais

Perguntas frequentes

Ryujinx não abre — preciso do .NET?
No Windows, instale a versão do .NET Desktop Runtime indicada no erro, da Microsoft, e abra o Ryujinx de novo.
Ryujinx no Steam Deck — qual build?
Baixe sempre o AppImage ou tar.gz Linux x64 — não ARM64. Configure chaves e firmware primeiro no Modo Desktop. Guia Steam Deck.
Tela preta ou crash nos jogos?
Tente alternar o backend gráfico entre Vulkan e OpenGL em Opções → Configurações → Gráficos. Atualize drivers e limpe o cache de shaders se necessário.
Canary vs Stable — qual usar?
Stable é melhor para iniciantes; Canary atualiza mais rápido mas pode quebrar. Você pode reverter na página de releases. Canary vs Stable.