PS5 Emu Shell

Seus emuladores, recomps e jogos de PC numa interface no estilo do PS5, feita para o controle.

Telas · Instalação · Requisitos · Sistemas · Controles · FAQ · Arquitetura

▶️ Assista ao vídeo de demonstração (1 min 19 s)

Fileira de jogos no estilo do PS5, com a arte do jogo no fundo, filtros por console (L1/R1) e opções do jogo (△/Y).

Agrupe os jogos de uma saga. A capa é montada com as capas dos jogos ou pode ser uma imagem sua (△/Y › Capa).

No estilo do PS5, com páginas de letras, símbolos e acentos, Shift e cursor móvel, tudo pelo controle.

Progresso de cada jogo no RetroAchievements, em lista ou em grade, no tema escuro ou claro.

Dezenas de avatares incluídos, ou uma imagem sua.

1. Baixe o PS5EmuShell-<versão>-win-x64.zip na última versão.
2. Crie uma pasta base (ex.: C:\Emuladores) e extraia o zip dentro dela.
3. Execute launcher\Iniciar.bat.
4. Na primeira vez, aceite criar as pastas e baixar os emuladores:

Emuladores\
├── launcher\      ← o PS5 Emu Shell
├── bios\          ← BIOS e firmwares, por sistema
├── cores\         ← emuladores
├── roms\          ← jogos: roms\psx, roms\ps2, roms\psp, roms\nds, roms\gc…
├── saves\
└── screenshots\

5. Coloque as ROMs em roms\<sistema> e as BIOS em bios\<sistema>. As capas são baixadas sozinhas.

Os jogos rodam nos emuladores, e cada um tem seus próprios requisitos: veja requisites.md.

PlayStation, PS2, PSP, Nintendo DS e GameCube já vêm configurados; os demais entram em Configurações › Instalação › Adicionar mais sistemas. Cada emulador pode baixar a última versão da fonte oficial ou apontar para o seu próprio executável; se você instalar por fora, extraia em cores\<sistema>\<emulador> e use Sincronizar.

Jogos de PS3 e PS4 ficam em pastas (com EBOOT.BIN / eboot.bin) dentro de roms\ps3 ou roms\ps4, e o nome é lido do PARAM.SFO. Firmware, BIOS e chaves são configurados no próprio emulador.

O botão + no topo adiciona:

• Jogo de PC ou recomp: escolha o .exe num explorador de arquivos que funciona pelo controle e já mostra as pastas da Steam, Epic, GOG e Xbox. A imagem vem do ícone do executável, e o launcher acompanha o jogo até o último processo da pasta fechar.
• Pasta de ROMs: escolha a pasta e o sistema. O PS5 Emu Shell sugere o sistema pelos arquivos e pelo nome da pasta.

Renomear, trocar o executável, mudar as Thumbnails ou remover: △/Y no jogo. Em Informações há também Resetar estatísticas.

Durante o jogo

As combinações podem ser trocadas em Configurações › Atalhos.

Isso é um emulador de PS5?

Não. O PS5 Emu Shell é um launcher: não emula nenhum console, só organiza a sua biblioteca e abre cada jogo no programa certo. Quem roda os jogos são os emuladores, os recomps e os jogos de PC que você já tem. A aparência lembra a do PS5, mas é só a interface.

Qual é a proposta, então?

Ser um centralizador de jogos: juntar, numa interface feita para o controle, os jogos dos seus emuladores, os recomps (versões nativas para PC de jogos clássicos) e os seus jogos de PC.

Isso vai rodar GTA 6?

Não. O PS5 Emu Shell não emula PS5 nem nenhum console atual. Ele só abre o que você já consegue rodar no seu PC.

Quais são os requisitos?

O launcher é leve (Requisitos). Os jogos dependem de cada emulador: sistemas antigos rodam até em PCs modestos, enquanto PS3, PS4, Xbox 360 e Wii U pedem um PC forte. Veja requisites.md.

O PS5 Emu Shell vem com jogos ou BIOS?

Não. Os emuladores podem ser baixados pelo launcher, das fontes oficiais, mas jogos, BIOS e firmwares não acompanham. Use apenas cópias dos jogos que você tem.

O Windows mostrou um aviso do SmartScreen. É seguro?

O executável não é assinado digitalmente, então o Windows avisa na primeira execução. Clique em Mais informações › Executar assim mesmo. O código-fonte completo está neste repositório.

Meu controle de PlayStation não funciona. Preciso do DS4Windows?

Não. O DualShock 4 e o DualSense são lidos direto. Se o controle não aparecer, use Configurações › Controles › Autodetectar e feche o DS4Windows, se estiver aberto, porque ele pode esconder o controle original.

Como fecho um jogo e volto para o launcher?

Segure Create/Back + Options/Start. Para só mostrar o launcher sem fechar o jogo, segure Create/Back + L1.

Coloquei ROMs na pasta, mas os jogos não aparecem.

Confira se estão em roms\<sistema>, com uma extensão que o emulador aceita, e se o sistema está ativo em Configurações › Sistemas e emuladores. Para pastas fora de roms, use + › Pasta de ROMs.

As capas não baixaram.

As capas são buscadas pelo nome do arquivo, então nomes no padrão No-Intro/Redump (ex.: Gran Turismo 4 (USA).iso) funcionam melhor. Em Configurações › Capas dá para baixar de novo ou limpar o cache.

Como levo tudo para outro PC?

Copie a pasta Emuladores inteira. Se for compartilhar com outra pessoa, apague antes launcher\data para não levar suas configurações e seu login.

Onde ficam meus dados?

Em launcher\data: configuração, tempo de jogo, coleções, login do RetroAchievements e cache de capas. A internet só é usada para baixar capas e emuladores, checar versões novas e consultar o RetroAchievements.

Requisitos: Windows 10/11 x64, Node.js 20+ e Git. Clone dentro da pasta base (ex.: C:\Emuladores), porque o launcher procura bios, cores e roms na pasta acima dele.

git clone https://github.com/felipeAguiarCode/PS5EmuShell.git launcher
cd launcher
npm install
npm start          # roda a partir do código-fonte (F12 abre o DevTools, F11 alterna a tela cheia)
npm run check      # ESLint + Prettier + testes (node:test)
npm run build      # gera app\win-unpacked\PS5EmuShell.exe

Se o npm bloquear os scripts de instalação (aviso install-scripts), rode uma vez node node_modules/electron/install.js.

Electron com dois processos: o main (Node.js) cuida de controles, arquivos, emuladores e rede; o renderer (HTML/CSS/JS sem framework) desenha a interface. Os dois conversam por IPC, através do preload.cjs.

📁 launcher/
├── 📁 src/
│   ├── 📁 main/                      processo principal (Node.js)
│   │   ├── 🟨 index.js               ciclo de vida do app e ligação das camadas
│   │   ├── 📁 constants/             constantes por contexto e mensagens da interface
│   │   ├── 📁 core/                  caminhos, config.json, stats.json e log
│   │   ├── 📁 defaults/              configuração padrão e catálogo de sistemas
│   │   ├── 📁 ipc/                   canais IPC, um arquivo por contexto
│   │   ├── 📁 input/                 XInput, HID (DualShock 4/DualSense), slots e combos
│   │   ├── 📁 library/               ROMs, capas, jogos de PC, coleções, avatares, tempo de jogo
│   │   ├── 📁 emulators/             downloads, instalação, versões, sincronização e execução
│   │   ├── 📁 retroachievements/
│   │   │   ├── 📁 api/               web API e caches
│   │   │   ├── 📁 formats/           INI e token do DuckStation
│   │   │   └── 📁 emulators/         um script de login por emulador
│   │   ├── 📁 system/                bateria, processos, desempenho e otimização
│   │   ├── 📁 files/                 explorador de arquivos e detecção de sistema
│   │   ├── 📁 window/                janela principal, overlay do jogo e atalhos
│   │   └── 📁 dev/                   modo snapshot (capturas e gravações automáticas)
│   ├── 🟨 preload.cjs                ponte segura entre main e renderer
│   └── 📁 renderer/                  interface
│       ├── 📄 index.html
│       ├── 📁 scripts/
│       │   ├── 🟨 main.js            inicialização da interface
│       │   ├── 📁 core/              estado, comandos, API e seletores
│       │   ├── 📁 input/             controle, teclado e mouse
│       │   ├── 📁 navigation/        navegação espacial pelo controle
│       │   ├── 📁 ui/                modal, toast, glyphs, sons e teclado virtual
│       │   └── 📁 views/             uma pasta por tela: home, library, collections,
│       │                             trophies, settings, game, pc-games, topbar…
│       ├── 📁 styles/                CSS por tela, na ordem da cascata
│       ├── 📁 fonts/                 Source Sans 3
│       └── 📁 img/                   ícones de botões e troféus
├── 📁 test/                          testes node:test (main e renderer)
├── 📁 assets/avatars/                avatares do perfil
├── 📁 build/                         ícone e script pós-empacotamento
├── 📁 docs/media/                    GIFs e vídeo deste README
└── 📄 .specs/coding-style.md         guia de estilo do código

Ícones de botões: Kenney Input Prompts (CC0) · Fonte: Source Sans 3 (SIL OFL) · Troféus: RetroAchievements · Capas: libretro-thumbnails