Documentation
Client-side paths, config, and install behaviour. Shop server API is on the Shop page.
Deep dives: Network & download · Install pipeline · Shop API
Supported formats
NSP/NSZ- Nintendo Submission Package (compressed)XCI/XCZ- cartridge image (compressed)
File extension is ignored for network installs - only content matters.
SD card layout
sdmc:/switch/CyberFoil/
├── cyberfoil.nro
├── config.json optional
├── shops/ shop profiles (*.json)
├── shop_icons/ cached shop icons
├── offline_db/ local title DB + icons
│ └── offline_db_manifest.json
├── bark.wav / success.wav optional sounds
└── offline_db_update.log update trace logconfig.json
Written by Settings. Path: sdmc:/switch/CyberFoil/config.json
| Key | Type | Description |
|---|---|---|
shopUrl | string | Active shop base URL |
shopUser / shopPass | string | HTTP Basic auth for shop |
httpUserAgentMode | string | default, chrome, safari, firefox, tinfoil, custom |
httpUserAgent | string | Custom UA when mode is custom |
shopHideInstalled | bool | Filter installed titles in shop |
shopHideInstalledSection | bool | Hide Installed section |
shopAllBaseOnly | bool | All section: bases only |
shopLegacyMode | bool | Tinfoil compatibility |
shopStartGridMode | bool | Shop opens in grid view |
lastNetUrl | string | Last URL used for net install |
offlineDbManifestUrl | string | Manifest for offline DB updates |
offlineDbAutoCheckOnStartup | bool | Check DB on launch when online |
autoUpdate | bool | Check for CyberFoil updates |
validateNCAs | bool | Verify NCA signatures before install |
ignoreReqVers | bool | Ignore minimum firmware in titles |
overClock | bool | Boost CPU during installs |
deletePrompt | bool | Ask to delete source files after install |
languageSetting | int | UI language index (99 = system) |
soundEnabled / oledMode | bool | UI preferences |
mtpExposeAlbum | bool | Show Album drive in MTP mode |
usbAck | bool | USB install warning acknowledged |
verboseInstallLogging | bool | Extra install diagnostics |
Network install (LAN)
Separate from the HTTP shop API. CyberFoil listens on TCP port 2000 while the net install screen is open.
- Launch Install over LAN or internet - your Switch IP is shown.
- On PC/phone, use NS-USBloader (Tinfoil mode) or similar: target that IP, send file list.
- Alternatively pick URL or Google Drive file ID from the menu.
Downloads use the configured User-Agent (cyberfoil by default), not the empty UA from legacy shop mode.
Offline database
Title names and icons under offline_db/ - used when shop/network metadata is unavailable.
Default manifest: CyberFoil-DB releases.
Supports packed or JSON layouts (titles.pack, icons.pack, index files, etc.).
Network & install (see also)
- Connection modes - LAN :2000, HTTP range, USB TUC0, URL types, Google Drive, JBOD
- Install pipeline - PFS0/HFS0, NCM placeholders, NCZ/ZSTD, NCA verify
- Shop API - catalog endpoints, save sync, Tinfoil legacy
Build & stack
- Binary:
cyberfoil.nro→ release zipswitch/CyberFoil/cyberfoil.nro - Version:
1.4.4· Author: luketanti · License: GPL-3.0 - UI: Plutonium
- MTP: libhaze · USB FS: libusbhsfs (FAT/NTFS/EXT)
- Lineage: fork of Awoo Installer (Huntereb), maintained as CyberFoil