Atualize primeiro o Citron
Use a versao estavel para um comportamento previsivel ou uma nightly recente apenas quando precisar de uma correcao especifica. A nightly verificada atual e a b4a62b4e0 de 12 de julho de 2026.
Guia de configuracao legal
As keys e o firmware do Citron sao arquivos de sistema fornecidos pelo proprio utilizador. Este guia explica a funcao de cada um, um fluxo seguro para extracao a partir do seu console, verificacoes de compatibilidade e resolucao de problemas sem oferecer downloads protegidos por direitos de autor.

O Citron Neo so pode executar conteudo que tenha permissao legal para usar, e o projeto do emulador nao inclui prod.keys, title.keys, firmware, jogos nem pacotes de ROMs. Obtenha os arquivos de sistema a partir de hardware que lhe pertence, usando metodos legais aplicaveis na sua jurisdicao.
Nunca carregue, partilhe, cole nem transfira as keys de outra pessoa. Trate os seus proprios ficheiros de keys como credenciais: mantenha copias de seguranca privadas e evite sites espelho que os distribuem com instaladores do emulador.
| Ficheiro ou conceito | Finalidade | Problema comum |
|---|---|---|
| prod.keys | Keys criptograficas derivadas do console, usadas para ler conteudo compativel que extraiu legalmente. | Keys em falta ou desatualizadas podem fazer falhar conteudo encriptado ou atualizacoes. |
| title.keys | Keys especificas de titulos que podem estar associadas a conteudo que lhe pertence. | Nao transfira pacotes de keys publicos; use apenas ficheiros obtidos legalmente a partir do seu proprio hardware e conteudo. |
| Firmware | Arquivos do software de sistema do console usados por alguns recursos e jogos do emulador. | Um firmware incompatível pode fazer falhar menus, tipos de letra, servicos ou titulos mais recentes. |
| Game dump | Uma copia de seguranca pessoal de um jogo que lhe pertence, num formato suportado pelo emulador. | O Citron nao usa ficheiros de jogo Windows .exe e este site nao fornece jogos. |
Use a versao estavel para um comportamento previsivel ou uma nightly recente apenas quando precisar de uma correcao especifica. A nightly verificada atual e a b4a62b4e0 de 12 de julho de 2026.
Feche o Citron e copie a pasta de dados do utilizador antes de substituir keys ou firmware. Isto da-lhe um ponto de retorno.
Importe os ficheiros extraidos legalmente pela interface do emulador quando essa opcao estiver disponivel. Nao copie ficheiros de um pacote de tutorial nao fiavel.
Keys, firmware, atualizacoes e copias de jogos devem vir de uma configuracao compativel. Misturar keys antigas com conteudo mais recente e uma causa comum de falha.
Reinicie o Citron, confirme que os ficheiros foram reconhecidos e teste uma copia pessoal conhecida por funcionar antes de alterar definicoes graficas ou de desempenho.

Mais recente nao significa automaticamente melhor. Atualize keys ou firmware apenas a partir de uma nova extracao legal quando um titulo seu mais recente ou um recurso do sistema o exigir.
| Sintoma | Causa provavel | Proximo passo seguro |
|---|---|---|
| Keys nao detetadas | Nome de ficheiro incorreto, pasta errada, ficheiro ilegivel ou o Citron ainda estava aberto durante a importacao. | Feche o Citron, confirme o nome e a localizacao documentados, restaure a sua copia privada e reinicie. |
| Erro de key em falta ou incorreta | As keys podem estar desatualizadas para esse conteudo, danificadas ou nao pertencerem ao mesmo conjunto legal. | Crie uma nova extracao a partir do seu proprio console atualizado; nunca resolva isto com um pacote de keys publico. |
| A instalacao do firmware falha | Extracao de firmware incompleta, versao incompatível ou mistura de ficheiros de diferentes versoes do sistema. | Refaça uma copia completa, mantenha uma unica versao junta e verifique espaco livre em disco e permissoes. |
| O jogo nao aparece | Formato nao suportado, copia pessoal incompleta, pasta errada ou o utilizador espera um Windows .exe. | Verifique o formato suportado pelo emulador e adicione a pasta que contem a sua propria copia completa do jogo. |
| Falha apos atualizar ficheiros | Novo comportamento da nightly, cache incompatível ou incompatibilidade entre keys, firmware e conteudo. | Reponha a sua copia dos dados do utilizador, teste a build estavel e altere apenas um componente de cada vez. |
Mais recente nao significa automaticamente melhor. Atualize keys ou firmware apenas a partir de uma nova extracao legal quando um titulo seu mais recente ou um recurso do sistema o exigir.
Mantenha copias privadas datadas, mas nao guarde ficheiros de keys em pastas na cloud, capturas de ecran, pedidos de suporte ou repositorios publicos.
Ao reportar um erro, partilhe o hash da build do Citron, o sistema operativo, o texto do erro e os passos para reproduzir o problema; nunca anexe keys, firmware nem ficheiros de jogos protegidos por direitos de autor.
