💙 Créditos
Todo o catálogo de jogos do RecompHUB vem do PortsDR.com, criado e mantido por TinSoldier97.
O PortsDR é quem reúne e organiza todos esses ports da comunidade. Sem esse trabalho o RecompHUB não existiria. Visite o site e apoie o criador!
Os ports em si pertencem aos seus respectivos autores e projetos (N64Recomp, XenonRecomp, PS2Recomp, Ship of Harkinian, OpenGOAL e muitos outros). O RecompHUB apenas baixa as releases oficiais diretamente do GitHub de cada projeto.
🎮 O que é o RecompHUB?
Existem dezenas de jogos clássicos (N64, PS1, PS2, Xbox 360…) que a comunidade transformou em versões nativas para PC. O problema é que cada um tem um jeito diferente de instalar: baixar do GitHub, descompactar, colocar a ROM com um nome específico, rodar um extrator, configurar…
O RecompHUB faz tudo isso por você, com uma interface parecida com a da Steam.
✨ O que ele faz
-
Catálogo sempre atualizado: a lista de jogos é puxada automaticamente do PortsDR.com. Jogo novo no site = jogo novo no app.
-
Instalação em 1 clique: baixa a versão mais recente do jogo direto do GitHub oficial do projeto, já escolhendo a versão certa para o seu sistema.
-
Use a sua própria ISO/ROM: você escolhe onde está o arquivo do seu jogo. Pode ser a ISO/ROM direto ou um arquivo compactado (.zip, .7z, .rar) com ela dentro. O app descompacta sozinho.
-
Reconhece a ROM certa: o app confere o arquivo (hash SHA-1) para saber se é a ROM certa, mesmo que o nome esteja diferente.
-
Configura tudo sozinho: coloca a ROM com o nome que o jogo espera, ativa o modo portátil (saves ficam na pasta do jogo), roda extratores de assets quando necessário, etc.
-
Jogos de Windows no Linux: se o port só tem versão para Windows, o RecompHUB roda automaticamente com Proton / umu-run, sem precisar adicionar na Steam.
-
Jogos gigantes (PS4, 25 GB ou mais): escolha a pasta do dump e ela fica registrada onde já está, sem copiar nada. Arquivos .zip de qualquer tamanho (inclusive acima de 2 GB) são extraídos em fluxo, com barra de progresso e checagem de espaço em disco.
-
Extração de PKG do PS4: aponte a pasta com os arquivos .pkg (jogo, patch e DLC) e o RecompHUB extrai tudo sozinho, aplicando o patch por cima do jogo, guardando os DLC e deixando de fora as variantes de MOD. O app não inclui nem baixa nenhuma ferramenta ou chave, você usa o que já tem (Configurações > Extrair PKG do PS4):
- PKG Extractor (do projeto ShadPs4Plus,
pkg_extractor.AppImage no Linux ou pkg_extractor.exe no Windows): se você já o baixou, o RecompHUB acha em Downloads, Applications ou no PATH (ou você escolhe o arquivo) e o executa como programa externo. É o caminho recomendado.
- Arquivo de chaves (
keys.json, formato do shadPS4): sem o PKG Extractor, o extrator próprio do RecompHUB usa as suas chaves.
Só PKGs "fake" são suportados.
-
Patches, atualizações e DLC: em qualquer jogo você pode adicionar arquivos ou pastas (ex.: update 1.09, DLC, patches da comunidade); o app cria atalhos na pasta patches/ do jogo, sem copiar.
-
Remover a ISO/ROM do jogo com escolha: a lixeira ao lado da ISO/ROM sempre remove o caminho dela do jogo (e o atalho na pasta de instalação, se o jogo já estiver instalado). Apagar o arquivo do computador é opcional e vem desmarcado, então dá para só tirar a ISO dali sem perdê-la. Pastas que você apontou nunca são apagadas.
-
Aba Comunidade: ports do GitHub que ainda não estão no PortsDR, com a mesma instalação em 1 clique. Sugira o seu pelo botão "Sugerir novo port".
-
Barra de progresso nos Downloads: download, descompactação e instalação aparecem na aba Downloads, mesmo trocando de página.
-
Tela cheia: botão para ativar/desativar tela cheia nos jogos que suportam (ex.: Ace Combat 5).
-
Desinstalar de verdade: ao excluir um jogo você pode escolher apagar também a ISO/ROM do seu computador, para não ficar ocupando espaço escondido.
⚠️ Importante sobre ISOs e ROMs
O RecompHUB não baixa e nunca vai baixar ISOs ou ROMs. Você precisa ter a sua própria cópia original do jogo. Todos os ports precisam desse arquivo para funcionar.
📥 Como instalar
Baixe a versão mais recente na aba Releases.
Linux
Windows
- Instalador (
...-Setup.exe): instala para o seu usuário (sem administrador) e cria os atalhos. É a opção que abre mais rápido.
- .zip: descompacte e abra
RecompHUB.exe (também abre rápido).
- Portable (.exe): um único arquivo, é só abrir. Como ele precisa se descompactar na pasta temporária a cada abertura, demora um pouco mais que as opções acima.
🕹️ Como usar
- Abra o Catálogo e escolha um jogo.
- Clique em Instalar e indique onde está a ISO/ROM (ou o .zip com ela).
- Acompanhe pela aba Downloads.
- Quando aparecer JOGAR, é só clicar. 🎉
Dica: em Configurações você pode definir uma pasta com todas as suas ISOs/ROMs, e o app encontra sozinho a certa para cada jogo.
🛠️ Para desenvolvedores
Feito com Electron + React + TypeScript + Tailwind CSS.
npm install
npm run dev # modo desenvolvimento
npm run build # compila
npm run dist:linux # gera AppImage + tar.gz em ./release
npm run dist:win # gera .zip + instalador (Setup.exe) + portable .exe em ./release
npm run dev:web # só a interface no navegador, com dados de exemplo (src/renderer/dev)
npm run test:assets # testa a escolha do arquivo de cada release
npm run test:vault # testa cofre, receitas, pastas, patches e extração de PKG (--big: zip acima de 2 GB)
npm run test:pkg # testa o extrator de PKG próprio (PKGs sintéticos) e o uso do PKG Extractor externo (programa falso; --bench: velocidade)
npm run audit:catalog # confere, jogo a jogo, o que o app instalaria a partir do catálogo do PortsDR
Estrutura principal:
src/
├── main/ # Processo principal (catálogo, downloads, cofre de ROMs, receitas, execução)
├── preload/ # Ponte segura entre interface e sistema
├── renderer/ # Interface React (estilo Steam)
└── shared/ # Tipos compartilhados
🐞 Status
Esta é uma versão beta. Alguns jogos podem precisar de ajustes. Encontrou um problema? Abra uma Issue dizendo qual jogo, seu sistema e o que aconteceu.
📄 Licença
MIT. O RecompHUB não é afiliado ao PortsDR, à Valve, nem a nenhuma empresa dona dos jogos.
