Skip to content

About

Desktop workshop for a homebrew Switch: MTP and FTP library, installs, homebrew, NSP tools, sys-con virtual pad, MCP server

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

GODsend Switch

Website Discord Ko-fi ETH

A desktop workshop for a homebrew-enabled Nintendo Switch: connect over USB, manage the installed library, install games and homebrew, drive the console with a virtual controller, and convert the files Switch tools use. Built with a Rust engine, Tauri 2 and React.

Console Library
Console Library

What it does

  • USB, three ways: MTP (DBI, Sphaira), the Tinfoil/Awoo bulk install protocol, and the LAN installer on TCP 2000. FTP covers consoles without USB access.
  • Library: reads the MTP responder's "Installed games" storage plus the SD card, parses NSP/NSZ/XCI/XCZ names for title ids, shows box art from the cover base with monograms as the fallback, and lists local packages beside what is installed.
  • Installs: send an NSP/NSZ/XCI/XCZ straight to "SD install" or "NAND install" (DBI installs on arrival), over Tinfoil USB, or to the LAN installer. NRO homebrew always goes to /switch on the SD card.
  • Files: browse any MTP storage and the local disk side by side, upload, download, create folders, delete.
  • Virtual controller: sys-con's network controller over UDP. Every face and shoulder button, D-pad, both sticks, HOME and Capture, with keyboard mapping and press-and-hold.
  • Game Index: search a Switch game index or the Internet Archive, resolve through Real-Debrid or TorBox, and download with aria2c (16 connections, single-connection fallback).
  • Downloads: one folder for everything, with send-to-console, reveal and delete.
  • Homebrew: catalog of GitHub NRO projects (Homebrew App Store, ftpd, sys-con, NX-Shell, DBI, Awoo Installer, sys-ftpd, NXThemes Installer), fetched from each project's latest release.
  • Conversions: FAT32 split into .00, .01 parts and merge back, NSP format and title-id inspection.
  • MCP server: starts with the app on 127.0.0.1:3939/mcp, so an agent can read status, browse storages, install files, drive the pad and search the index. The CLI also serves the same tools over stdio.
  • Preflight: one panel for the MTP responder, install storage, Tinfoil mode, FTP host, sys-con, download folder, aria2c, debrid and the MCP port.

Guides

Step-by-step walkthroughs live in docs/guides:

  1. Connect your Switch
  2. Installing games
  3. Homebrew and sys-con
  4. Virtual controller
  5. Conversions
  6. Troubleshooting
  7. Build from source

Download

Build GoFile (primary) file.kiwi (backup) Size
godsend-switch-0.1.0-linux-x64.AppImage Download Mirror 80.3 MiB
godsend-switch-cli-0.1.0-linux-x64.tar.gz Download Mirror 2.2 MiB
godsend-switch-cli-0.1.0-macos-arm64.tar.gz Download Mirror 2.0 MiB
godsend-switch-cli-0.1.0-macos-x64.tar.gz Download Mirror 2.1 MiB
godsend-switch-cli-0.1.0-windows-x64.zip Download Mirror 2.4 MiB
godsend-switch-0.1.0-linux-x64.deb Download Mirror 5.5 MiB
godsend-switch-0.1.0-arm64.dmg Download Mirror 5.5 MiB
godsend-switch-0.1.0-x64.dmg Download Mirror 5.9 MiB
godsend-switch-0.1.0-x64-setup.exe Download Mirror 3.8 MiB

GoFile is the primary host and file.kiwi is the encrypted backup. Links are refreshed by scripts/publish-release.sh, which rebuilds every platform on CI, uploads the artifacts, and rewrites this table and docs/downloads.json.

The desktop builds are not notarized: right-click, Open, Open on first launch (or xattr -dr com.apple.quarantine "/Applications/GODsend Switch.app").

Build from source

Requirements: Rust 1.85+, Node 20+, and the Tauri 2 prerequisites for your platform (Xcode CLT on macOS, MSVC + WebView2 on Windows, webkit2gtk-4.1 on Linux). Details in docs/guides/build-from-source.md.

npm install --prefix app
npx --prefix app tauri icon app/src-tauri/icons/icon.png   # once
cargo build --release -p godsend-switch-cli                # CLI
npx --prefix app tauri build                               # desktop bundles

Dev without a console:

npm run --prefix app dev:mock    # UI with fixture data (?mock=1)
npm run --prefix app test:ui     # Playwright against the mock bridge

CLI quick tour:

godsend-switch status            # MTP, Tinfoil USB, FTP, sys-con
godsend-switch storages          # storage units with free space
godsend-switch library           # installed titles
godsend-switch install game.nsp  # configured transport
godsend-switch install game.nsp --via tinfoil
godsend-switch pad a             # sys-con virtual pad
godsend-switch stick l 0 -1      # left stick up
godsend-switch homebrew-install sys-con
godsend-switch split game.nsp    # FAT32 parts
godsend-switch mcp               # MCP over stdio

MCP

The app hosts the MCP endpoint while it runs. This repo ships a .mcp.json that points at it; elsewhere register it once:

claude mcp add --transport http godsend-switch http://127.0.0.1:3939/mcp

Tools: switch_status, doctor, list_storages, list_storage, library, install_file, pad, search_games, homebrew, nsp_split, nsp_merge. A port change or the on/off toggle applies as soon as you press Save in Settings. The CLI's mcp command speaks the same JSON-RPC over stdio for clients that spawn their own server.

What the console needs

  • A homebrew-enabled Switch (Atmosphere). USB transfers need a responder running in MTP mode (DBI's "Run MTP responder", or Sphaira); the bulk installer path needs a Tinfoil/Awoo-family installer in USB mode. FTP needs ftpd or sys-ftpd.
  • The virtual pad needs sys-con with network_controller=1 in its config; the default UDP port is 56789.
  • Nothing is decrypted or signed: NSZ/XCZ decompression and XCI to NSP need console keys and are out of scope.

Architecture

core/            godsend-core: MTP, Tinfoil USB, LAN install, FTP, library,
                 NSP tools, sys-con pad, homebrew, store, debrid, downloads,
                 files, jobs, doctor, config, MCP.
cli/             godsend-switch headless CLI.
app/             Tauri 2 desktop app: React 18 + TypeScript, 44 commands in
                 app/src-tauri, events for job progress, MCP server on start.

See DESIGN.md for the design system and docs/features.md for the feature reference.

License

MIT. Not affiliated with Nintendo. Use with content you own.

About

Desktop workshop for a homebrew Switch: MTP and FTP library, installs, homebrew, NSP tools, sys-con virtual pad, MCP server

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages