Skip to content

About

Install local titles into Nintendo switch via USB

Resources

Stars

6 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

dbibackend

PC-side server for installing games into Nintendo Switch via USB (DBI0 protocol).

Fork of lunixoid/dbibackend, rewritten in Go.

Screenshot

Features

  • System tray menu bar app (default) with start/stop control
  • CLI mode for headless usage (--cli)
  • Multiple directory support — scan all your title folders at once
  • Cross-platform: macOS, Linux, Windows
  • NFC-normalized filenames (fixes Korean/Unicode display on Switch)
  • Single binary — no Python or runtime dependencies
  • GoReleaser + Homebrew tap distribution

Requirements

Host:

  • macOS / Windows — no additional dependencies (libusb is embedded)
  • Linux — libusb (sudo apt install libusb-1.0-0-dev or equivalent)

Nintendo Switch:

Install

Homebrew (macOS & Linux)

brew install kyungw00k/tap/dbibackend

Linux also needs libusb: sudo apt install libusb-1.0-0-dev (or equivalent).

Homebrew cask (macOS app)

brew install --cask kyungw00k/tap/dbibackend

Installs DBI Backend.app into /Applications — a regular Mac app with Launch-at-Login support. The formula above installs the bare CLI binary instead.

Installed from the DMG directly? macOS blocks the first launch ("cannot check for malicious software") until the app is notarized. Cask installs clear this automatically; for a manual DMG install, run:

xattr -dr com.apple.quarantine /Applications/dbibackend.app

or use System Settings → Privacy & Security → Open Anyway.

Scoop (Windows)

scoop bucket add kyungw00k https://github.com/kyungw00k/scoop-bucket
scoop install dbibackend

Download

Download the latest binary from Releases.

After installing

Run dbibackend — the app starts and lives in your menu bar / system tray, then see Usage. No arguments needed.

Usage

Menu bar mode (default)

dbibackend [--debug]

The app lives in your system tray. Click the DBI icon to:

  1. Start — begin waiting for a Switch USB connection
  2. Add Directory — add folders containing NSP/NSZ/XCI files
  3. Stop — disconnect and stop the server
  4. On Switch, open DBI → Install title from USB
  5. Select and install titles from all configured directories

CLI mode

dbibackend --cli <titles_dir> [--debug]

Build from source

make build    # dist/dbibackend, version stamped from git tags
make test     # go test ./...

License

MIT

About

Install local titles into Nintendo switch via USB

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages