SWizard v1.0.0

The macOS Switch Installer That Actually Works

The most complete and reliable macOS app for installing Nintendo Switch games. 3 transport modes — at least one will work regardless of your setup, including Apple Silicon + macOS Tahoe where other tools fail.

Highlights

🎮 MTP Mode — First working MTP solution on macOS Tahoe. Uses privileged libmtp with kernel driver detach to bypass Apple's broken MTP stack. One-time admin password prompt.

⚡ DBI Backend Mode — Custom DBI0 binary protocol over raw USB. Fastest mode with automatic retry, stall recovery, and session reconnect on cable disconnect.

📡 Network (FTP) Mode — Wireless game installation over WiFi. No USB cable needed. Upload to DBI's FTP server with progress tracking.

Features

• Drag-and-drop or Browse for .nsp, .nsz, .xci, .xcz files
• Split panel UI — file queue + color-coded activity log
• Transfer speed + ETA — real-time MB/s and time remaining
• SD Card / NAND picker — choose install destination (MTP mode)
• Structured logging — debug/info/warning/error with filtering
• Persistent settings — remembers transport mode and FTP address
• 278 tests — TDD throughout, SOLID architecture

Install

1. Download SWizard-v1.0.0-macos-arm64.zip below
2. Unzip
3. Open Terminal and run:

ditto "$HOME/Downloads/SWizard-v1.0.0/SWizard.app" "/Applications/SWizard.app" && xattr -dr com.apple.quarantine "/Applications/SWizard.app" && open "/Applications/SWizard.app"

Quick Start

Mode	On your Switch	In SWizard
MTP	DBI → Run MTP responder	Select MTP → Drop files → Install (enter admin password)
DBI Backend	DBI → Run DBI backend	Select DBI Backend → Drop files → Install
Network	DBI → Start FTP → Install on SD Card	Select Network → Enter IP:port → Drop files → Install

Requirements

• macOS 15+ (Apple Silicon)
• Nintendo Switch with DBI homebrew
• For building from source: brew install libusb libmtp, Xcode 16+

SWizard v0.2.1-alpha

SWizard v0.2.1-alpha

Focused alpha update centered on the new network transport flow.

What's New

• Switched network installs from local HTTP serving to a dedicated FTP upload client for DBI.
• Added FTP target input + Connect flow in the app, including validation and clearer connection status UX.
• Added persistence for FTP address and selected transport mode across app launches.
• Fixed FTP upload edge cases for filenames with spaces/brackets by URL-encoding paths and disabling curl glob interpretation.
• Improved troubleshooting with better curl diagnostics (logged URL + stderr on failures).
• Expanded behavioral test coverage across network UX/FTP flows and refreshed README documentation for all transport modes.

Download

• Use SWizard-v0.2.1-alpha-macos-arm64.zip
• Unzip the archive
• Install and open from Terminal:
  ditto "$HOME/Downloads/SWizard-v0.2.1-alpha/SWizard.app" "/Applications/SWizard.app" && xattr -dr com.apple.quarantine "/Applications/SWizard.app" && open "/Applications/SWizard.app"

Notes

• This hobby alpha build is unsigned/not notarized.
• If macOS blocks launch, run the Terminal command above to remove quarantine.

SWizard v0.2.0-alpha

SWizard v0.2.0-alpha

Huge alpha update with major transport, UX, and diagnostics improvements.

What's New

• Added full MTP install path with privileged USB claim flow, install destination picker (SD/NAND), retry improvements, and much broader test coverage.
• Added Network mode so DBI installs can run over local HTTP/Wi-Fi.
• Improved stability and transfer behavior across USB/MTP paths (reconnect logic, chunk handling, protocol/layout fixes, and many bug fixes).
• Expanded app UX with better help/status flows, log tooling (copy + export diagnostics), and visible app version in the UI.
• Added diagnostics export reports including app version, transport mode, state, and full logs for easier bug reporting.
• Updated release automation to support tag-driven publishing and improved release-note generation.

Post-release fixes on master

• Replaced network HTTP serving with FTP upload mode and added FTP address UX (Connect flow + validation).
• Added persistence for FTP address + selected transport mode across launches.
• Fixed FTP uploads for filenames with spaces/brackets by URL-encoding and disabling curl glob parsing.
• Improved network diagnostics by logging curl URL + stderr in failure paths.
• Expanded tests significantly (up to 277 tests) and refreshed README docs for all three transport modes.

Download

• Use SWizard-v0.2.0-alpha-macos-arm64.zip
• Unzip the archive
• Install and open from Terminal:
  ditto "$HOME/Downloads/SWizard-v0.2.0-alpha/SWizard.app" "/Applications/SWizard.app" && xattr -dr com.apple.quarantine "/Applications/SWizard.app" && open "/Applications/SWizard.app"

Notes

• This hobby alpha build is unsigned/not notarized.
• If macOS blocks launch, run the Terminal command above to remove quarantine.
• The "Post-release fixes" listed above are currently on master; publish v0.2.1-alpha (or newer) to distribute them in a release asset.

SWizard v0.1.0-alpha

SWizard v0.1.0-alpha

First public alpha release of SWizard.

What's New

• Initial macOS app for Nintendo Switch installs via DBI.
• Added drag-and-drop queue for .nsp, .nsz, .xci, and .xcz files.
• Implemented DBI backend transfer flow with progress tracking and activity logs.
• Added transfer resiliency improvements (USB retry, reconnect handling, and stability fixes).
• Introduced one-click build/install scripts and packaged .app release distribution.

Download

• Use SWizard-v0.1.0-alpha-macos-arm64.zip
• Unzip the archive
• Install and open from Terminal:
  ditto "$HOME/Downloads/SWizard-v0.1.0-alpha/SWizard.app" "/Applications/SWizard.app" && xattr -dr com.apple.quarantine "/Applications/SWizard.app" && open "/Applications/SWizard.app"

Notes

• This hobby alpha build is unsigned/not notarized.
• If macOS blocks launch, run the Terminal command above to remove quarantine.