PortsDR

---

💙 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):

  1. 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.
  2. 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

• AppImage (recomendado):

  chmod +x RecompHUB-beta-0.2-linux-x86_64.AppImage
  ./RecompHUB-beta-0.2-linux-x86_64.AppImage
  

• tar.gz: descompacte e rode ./recomphub.
• Para jogos que só têm versão Windows, instale o umu-launcher (umu-run) ou tenha o Proton instalado pela Steam.

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

1. Abra o Catálogo e escolha um jogo.
2. Clique em Instalar e indique onde está a ISO/ROM (ou o .zip com ela).
3. Acompanhe pela aba Downloads.
4. 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.