Nintendo Switch Homebrew

Instale ports no Switch
direto do seu servidor

Homebrew para Nintendo Switch que faz browse e instalação de ports NSP/NSZ/XCI/XCZ a partir de um catálogo JSON remoto — sem etapas intermediárias.

⬇ Download NRO ⌥ Ver no GitHub
C++20 Atmosphere CFW NSZ / NSP / XCI Tinfoil Index PT-BR / EN Open Source

Tudo que você precisa

Feito para quem quer instalar ports de forma rápida e organizada, sem depender de aplicativos externos.

🗂

Browse de catálogo

Navega catálogos JSON remotos em grade 3×2 com ícones 256×256, paginação por L/R e cache local de ícones.

Stream install

Instala NSZ/NSP/XCI/XCZ direto via NCM + ES, sem precisar de armazenamento intermediário no SD.

📥

Fila de instalação

Adicione vários títulos à fila e acompanhe o progresso de download e instalação com barra e porcentagem.

🔒

Índice criptografado

Suporta o formato TINFOIL (RSA-2048-OAEP + AES-128-ECB + zstd/zlib) além de JSON puro.

Detecção de instalados

Marca titles já instalados consultando o NCM, com fallback por histórico de sessão para títulos sem nome.

🌐

PT-BR & English

Interface completamente traduzida. Troca de idioma em Ajustes, sem reiniciar. Padrão: Português (BR).

Pronto em 4 passos

Requer um Nintendo Switch com Atmosphere CFW instalado.

1

Baixe o PortNX.nro

Na página de releases do GitHub, baixe a versão mais recente do PortNX.nro.

2

Copie para o SD

Coloque o arquivo em sdmc:/switch/PortNX/PortNX.nro.

3

Abra pelo hbmenu

No hbmenu do Switch (botão R + jogo), selecione PortNX.

4

Configure a URL do índice

Em Ajustes → URL do índice, insira a URL do seu servidor JSON.

sdmc:/switch/
PortNX/
├── PortNX.nro
├── config.json      # gerado automaticamente
└── icons/           # cache de ícones
    └── *.jpg
⚠ Requisitos

  • Nintendo Switch com Atmosphere CFW
  • prod.keys acessível ao homebrew (para NSZ/XCZ)
  • Servidor com catálogo JSON acessível via HTTP/HTTPS

Formato do índice JSON

O PortNX usa o formato padrão do Tinfoil. Qualquer servidor compatível com Tinfoil funciona. Abaixo um exemplo mínimo e um completo.

Mínimo

index.json
{
  "files": [
    {
      "url": "https://example.com/Port.nsz",
      "size": 1234567890
    }
  ]
}

Completo

index.json
{
  "files": [
    {
      "url":     "https://cdn.example.com/Port.nsz",
      "name":    "My Port Name",
      "size":    1234567890,
      "version": "1.0.0"
    }
  ],
  "directories": [
    "https://cdn.example.com/action/"
  ]
}
Índice criptografado  —  O PortNX também aceita índices no formato TINFOIL (binário com cabeçalho TINFOIL). Para gerar índices criptografados compatíveis, use as ferramentas em tools/.

Compilar do fonte

Requer devkitPro com as toolchains do Switch.

bash
# Clone com submodules
git clone --recurse-submodules \
  https://github.com/CostelaCNX/PortNX.git

# Build
cd PortNX
make -j$(nproc)

# Output
 PortNX.nro