Reference App Utility

Every HaulNX release ships appUtility-<version>.html — a single self-contained HTML file (no install, no server, works offline) you open in any browser on your computer. It's the comfortable way to build and maintain collections, and it also drives updating the app over Wi-Fi. Both devices just need to be on the same network; the console shows the address to enter, nothing leaves your LAN, and no third-party service is involved.

Building collections

• Edit collections — build dl_sources.json visually: console groups, repos, the supported-console list. Import an existing file or start fresh, then export. See Configuration for what the file holds.
• Quick test — paste any archive.org item id or URL to preview its file list before committing it to a collection.
• Export credentials — write your archive.org S3 keys to a credentials.json for the SD card.

Typing item ids on the Switch's on-screen keyboard gets old after the second one, so building the collection here with a real keyboard and sending it across is the recommended path once you're adding more than a couple.

Switch transfer — collections

A round trip over the LAN while the console's Import collection screen is open (Settings → Manage data → Import collection):

• Get from Switch pulls the collection the console is currently running into the editor.
• Send pushes it back; you confirm the import on the Switch.

So the loop is fetch → edit → send, with no SD card swapping. A live progress line shows the transfer on both ends.

Switch transfer — app updates (.nro)

Push a HaulNX build to the console while Settings → Check for updates → Over Wi-Fi is open. The utility validates the file is a real NRO before sending and shows send progress; you confirm the install (and restart) on the Switch. The same version as installed is accepted, so this is also how you test a new build without a USB cable.

Updating the app

Open Settings → Check for updates and pick where the update comes from:

• From GitHub — HaulNX checks the GitHub releases on a background thread, so the UI stays responsive and shows an attempt counter ((1/3)) while transient errors are retried; B dismisses. If a newer version is found it downloads the new .nro with a live progress indicator.
• Over Wi-Fi (push a build) — the console shows an address on your network. Open it in a browser and drop a HaulNX .nro on the page, or push one from the App Utility as above.

Either way the received build is validated (real-NRO check), you confirm the install — the dialog shows the incoming build's version next to the installed one — and it's staged with a copy-then-rename (keeping a .previous backup), so an interrupted install can't corrupt the app. Finish with Restart now (the app relaunches straight into the new build) or Later (the Settings chip flips to Restart to update and the swap happens on the next launch).