Sync

Wii connection

Set the Wii's LAN IP here — no restart needed. The Wii can be powered off; this is just where to look for the FTP server. Leave the IP blank to pause polling entirely.

Wii IP address or hostname FTP root path Max staging size (GB, 0 = unlimited) Wii USB capacity (GB, 0 = unknown)

New games are blocked once staging would exceed this — keeps games from filling a shared disk.

USB drive path on the Pi (optional — for local sync)

Set this to copy games to a USB drive plugged into the Pi instead of over WiFi — see the “Sync to a USB drive on the Pi” card below.

Save

FTP port is 21, polled every 20s. The FTP server exposes the USB drive at /usb in most setups — verify on the Wii.

Sync to a USB drive on the Pi (fast)

Wii-WiFi FTP is slow and can drop mid-transfer. Instead, plug the Wii's USB drive into the Pi and copy games to it directly at full USB speed, then move it back to the Wii. Same layout as FTP (wbfs/ for Wii, games/ for GameCube).

1. Mount the drive on the Pi host, then bind-mount it into this container — in your dockge/compose add under the service volumes: - /mnt/wii-usb:/wii-usb (host path : container path) and recreate the stack.
2. Set USB drive path on the Pi (in Wii connection above) to the container path, e.g. /wii-usb, and Save.
3. Pick the drive below (or type the path above) and click Sync to USB — progress shows in Status below. Then move the drive back to the Wii.
4. Recommended: set up automatic mount/unmount (see DEPLOY.md) so the app mounts the drive only while it has work to do and unmounts right after — unplugging a mounted drive risks filesystem corruption, and this removes that risk entirely.

Detected drives… Rescan

Auto-sync & import when this drive is connected (pushes staged games/saves, and adds the drive's own games to your Library so you can delete them)

Scan for duplicates Import drive games to library

“Import” lists the games already on the drive in your Library (flagged 💿 Drive only — on the drive, not staged here; only visible while that drive is connected). From there you can Delete from drive to free space, or 💾 Copy to Pi to bring a game's files onto the Pi and manage it like any other staged game (sync, cheats, patches).

Sync to USB now

First time? The host mount is a one-time setup — 📋 Copy AI setup prompt then paste it into ChatGPT/Claude to be walked through it.

SD card items (optional)

Homebrew apps and launcher bundles for the Wii's SD card — e.g. a Project+ build, the Homebrew Browser, or the cIOS / Priiloader installers. When enabled, wii-sync mirrors them to /sd on every sync, filling in whatever's missing (FTPii exposes SD and USB at once). Uploaded zips are auto-detected: an apps/<name> layout is kept as-is, a bare boot.dol folder is wrapped under apps/. This only copies files — the one-time cIOS / Priiloader NAND installs those apps perform can't be automated over FTP, and the SD card must be inserted.

Push SD items to the Wii on every sync Auto-configure USB Loader GX for Wiimmfi online play

Installed items

Upload app / bundle (zip / 7z / rar)

Search Open Shop Channel

Find homebrew (Homebrew Browser, d2x cIOS installer, Priiloader, …) and add it straight to the SD.

Search

WAD channels (install on the Wii)

Upload .wad files (Virtual Console / WiiWare / a USB Loader GX forwarder channel). They sync to the drive's /wad/ folder. WADs can't be USB-loaded — install them on the Wii with USB Loader GX's WAD installer or Wii Mod Lite (point its WAD path at the USB drive), then launch the channel from the Wii Menu.

Upload .wad

Memory-card saves

Upload memory-card saves — a raw memcard (.raw/.bin/.sav), or a .gci (e.g. 20XXTE), which the app converts into a Nintendont-ready memory card for you (no Dolphin needed), sized to match the card already on your drive. They sync to the drive's saves/ folder, and each sync keeps whichever copy is newer, so a save you played on the Wii isn't overwritten by an older upload (and vice-versa).

Card size for .gci conversion Auto — match your drive's card 59 blocks (4 Mbit — small) 123 blocks (8 Mbit) 251 blocks (16 Mbit — standard, most common) 507 blocks (32 Mbit) 1019 blocks (64 Mbit) 2043 blocks (128 Mbit — max, rarely used)

A real GameCube memory card is one of these six sizes — 251 blocks (16 Mbit) is the standard card and the safest default. "Auto" matches whatever card is already on your drive for this game, so Nintendont accepts the replacement.

Upload save

Status

When the FTP server appears, every staged game with no synced mark is pushed. Transfers run in the background and are slow (~0.5–1.5 MB/s over the Wii's WiFi), so a 1 GB game can take 15–40 minutes.

Sync now

“Sync now” runs even if detection hasn't fired — start the FTP server on the Wii first.