Network Transfer

Network Transfer

GoodbyeWindows supports direct LAN transfer between your Windows and Linux PCs without needing a USB drive.

How It Works

1. The Exporter (Windows) starts an HTTP server on port 12345
2. A random 4-digit PIN is generated for authentication
3. The Importer (Linux) connects using the IP address and PIN
4. Data transfers directly over your local network

Setup

On Windows (Exporter)

1. Select Network transfer as the export mode
2. The tool displays:
   • Your IP address
   • Port number (12345)
   • Authentication PIN
3. Keep the window open while transferring

On Linux (HelloLinux)

1. Select Network transfer as the source
2. Enter the IP address shown on the Windows PC
3. Enter the PIN
4. Click Connect

API Endpoints

The transfer server exposes the following REST API:

Endpoint	Method	Description
/api/ping	GET	Check if server is reachable
/api/auth	POST	Authenticate with PIN
/api/instance	GET	Get instance metadata
/api/mods	GET	List all mods
/api/gbw	GET	Download the .gbw metadata file
/api/mod/<name>/files	GET	Download mod files

Requirements

• Both PCs must be on the same local network (LAN/WiFi)
• Port 12345 must not be blocked by a firewall
• No internet connection required — everything stays local

Limitations

• Currently supports MO2 instances only — Vortex network transfer is not yet implemented
• Transfers one game instance at a time
• Large mod collections may take significant time depending on network speed

Troubleshooting

Problem	Solution
Connection refused	Check if both PCs are on the same network. Disable firewall temporarily.
Wrong PIN	Re-enter the PIN shown on the Windows PC. The PIN changes each time the server starts.
Slow transfer	Use a wired (Ethernet) connection instead of WiFi for best speed.
Server not found	Make sure the Exporter is still running on the Windows PC.