Seus jogos, seus emuladores, uma só biblioteca.

Instalação · Como usar · Desenvolvimento · Documentação

---

RetroX é um launcher nativo para macOS que reúne seus jogos em uma biblioteca visual e os abre nos emuladores que você já tem instalados. Navegue pelo teclado ou controle, personalize perfis e temas, e volte à biblioteca quando terminar de jogar.

O RetroX não inclui emuladores, jogos, BIOS ou chaves. Ele lê suas pastas de jogos sem copiar, mover ou alterar os arquivos.

_{Tela inicial com uma biblioteca de demonstração.}

Destaques

• Biblioteca visual: navegue por prateleira, carrossel, grade ou lista e encontre seus jogos por busca e console.
• Perfis pessoais: cada pessoa mantém seus próprios favoritos, recentes e preferências.
• Feito para controle: percorra o aplicativo pelo controle ou teclado, com glifos para Xbox, PlayStation e Switch.
• Temas para escolher: personalize cores, fonte e animações com variantes claras e escuras.
• Seus emuladores: configure o PCSX2, abra o jogo e volte ao RetroX ao terminar.

Temas para o seu jeito de jogar

Rayo Paradise · claro	Gruvbox · escuro

Instalação

macOS (Apple Silicon)

Baixar a última versão

Você precisa do macOS 14 ou superior e dos emuladores instalados por você. Hoje o RetroX suporta o PCSX2 (PS2); o Dolphin (GameCube/Wii) está planejado.

1. Baixe RetroX-<versão>.zip na página de Releases e confira o SHA256SUMS.txt.
2. Descompacte e mova o RetroX.app para /Applications.
3. Na primeira vez, abra com o botão direito > Abrir. O app tem assinatura ad hoc e não é notarizado, então o Gatekeeper pede autorização.

Como usar

1. Escolha (ou crie) um perfil em Quem vai jogar?. Cada perfil tem foto, tema, favoritos e recentes próprios.
2. Vá em Emuladores, ative o PCSX2 e escolha a pasta dele: a que tem o PCSX2.app e as pastas de jogos (por exemplo ~/Emulators/ps2, com roms/ e covers/). O RetroX também usa as pastas de jogos, as capas (inclusive as que o PCSX2 baixa) e a BIOS que o próprio PCSX2 já conhece.
3. Em Início, navegue pela prateleira; em Biblioteca, veja todos os jogos em grade ou lista, com busca e filtro por console. Pressione Return (ou o botão de confirmar) para jogar. Quando o PCSX2 fecha, o RetroX volta para a frente.
4. Em Detalhes, troque a capa de um jogo ou busque informações na Wikipedia.
5. Em Ajustes, escolha tema, fonte, visualização da tela inicial (Prateleira, Carrossel ou Grade), animações e o tipo de controle. Cada perfil guarda os seus.

Controles

Ação	Teclado	Controle
Navegar	Setas	Direcional ou analógico
Confirmar ou jogar	Enter	Botão de confirmar¹
Voltar	Esc	Botão de voltar
Trocar de aba	[ / ] ou ⌘1–⌘4	Gatilhos
Trocar prateleira ou console	Q / E	Botões superiores
Abrir detalhes	Espaço	Botão de detalhes
Favoritar	F	Botão de favorito
Buscar na biblioteca	/	—
Abrir ajustes	M ou ⌘,	Start

¹ Por padrão, o botão inferior confirma; no layout Nintendo, é o botão da direita. Em Ajustes > Controle, escolha os glifos de Xbox, PlayStation (DualSense) ou Switch.

Desenvolvimento

Para compilar: Swift 6, com as Command Line Tools ou o Xcode.

swift build                       # app, ferramentas e núcleo
swift test                        # testes unitários
scripts/bundle-app.sh debug       # monta .build/RetroX.app
open .build/RetroX.app

Estrutura: Sources/RetroXCore (domínio, emuladores, biblioteca), Sources/RetroXApp (SwiftUI), Tests/ e docs/. Veja o guia de contribuição, a estratégia de testes e as decisões de arquitetura.

Documentação

• PRD: produto, escopo e critérios de aceite
• Decisões de arquitetura: interface, plugins, lançamento e metadados
• Decisões e pendências
• Estratégia de testes
• Design e marca

_{Conheça a Rayo no kit da marca.}

---

Licença

Copyright © 2026 Otávio Luque (yukaritake@proton.me).

Este projeto é licenciado sob a GNU General Public License v3.0. Veja LICENSE para os detalhes.

A licença vale para o código. A Rayo, o logo, o ícone e os nomes RetroX e Rayo são marca e ficam fora dela, com todos os direitos reservados. Veja BRAND.md para o que é permitido e como publicar um fork.

Contribuições são bem-vindas por fork e pull request. Veja o guia de contribuição.

Mesmo com a licença GPL, fique à vontade para entrar em contato se quiser usar o RetroX num projeto proprietário. Estou aberto a combinar licenças alternativas caso a caso.

PCSX2, Dolphin e os nomes de consoles citados pertencem aos seus respectivos donos. O RetroX não é afiliado a eles, e ilustrações, logos e telas de terceiros citados como inspiração não são usados no projeto.