Wii Menu in HTML

Disclaimer: This project heavily utilizes Codex/ChatGPT.

A local browser reconstruction of the Wii System Menu. Console services are represented by local dummy behavior where needed.

License

The authored source and documentation are released under Creative Commons Zero v1.0 Universal. Nintendo software, artwork, fonts, trademarks, WADs, NAND data, and other third-party material are not included and remain under their own rights.

Run

Requirements: Node.js 20+ and Python 3.10+.

Provide your own System Menu WAD.

npm run prepare -- --wad /path/to/menu.wad
npm start

Open http://127.0.0.1:5173/. Generated files and private inputs stay in ignored .local/ and web/public/assets/ directories.

Channels

Open http://127.0.0.1:5173/channels.html to manage installed channels. Choose Compare NAND channels to scan another local NAND, view the installed and incoming icon and banner side by side, and select which titles to keep, replace, restore or install. Existing titles stay unchanged by default.

npm run prepare -- --wad /path/to/menu.wad --channel-wad /path/to/channel.wad
npm run prepare -- --rebuild --nand /path/to/nand
npm run channels -- list
npm run channels -- add --wad /path/to/channel.wad
npm run channels -- install /path/to/custom-channel-one /path/to/custom-channel-two
npm run channels -- overwrite /path/to/custom-channel-one /path/to/custom-channel-two
npm run channels -- remove CHANNEL_ID custom-channel-folder
npm run channels -- nand-plan /path/to/newer-nand
npm run channels -- nand-import /path/to/newer-nand --replace-channel 0001000148414241

Use --nand-keys /path/to/keys.bin when a raw BootMii dump needs a separate key file. nand-import also accepts repeatable --keep-channel ID selections and --nand-policy replace to replace every installed title found in that NAND. See NAND import for the full selection rules.

Custom channel packages can be created with:

npm run channels:custom -- init ~/MyChannel --id custom-my-channel --title "My Channel"
npm run channels:custom -- add ~/MyChannel
npm run format:json

format:json rewrites tracked JSON with compact numeric arrays and readable object layout. The shared formatter is also used by channel and state writers.

Configuration and controls

Edit config.json, then reload. It controls display ratio, audio, startup behavior, Wii Remote fixtures, SD-card fixtures, and channel layout.

Local tools and browser-owned loading screens start in Dark appearance. The appearance menu on each tool page can save Light or System instead. Original Wii Menu artwork retains its source colors.

• Point and click the menu. Tab and Enter expose keyboard-accessible controls.
• Home or H opens HOME. Escape or Backspace returns. M toggles mute.
• Hold the middle or right mouse button to move channels and Memo cards.

Prepared audio is the default. To rebuild it from the imported WAD:

npm run prepare -- --rebuild --background-source builtin

Dictionary

The prepared WAD exports local word lists. The first-party browser predictor uses them for suggestions without installing packages. Its suggestion order is not verified equivalent to the original Zi8 engine.

Checks

npm run check
npm test
npm run test:assets
npm run test:reference
npm run audit:privacy

The dependency and supply chain audit records the install policy, third-party dependency inventory and current dictionary fidelity limit.

Layout

• web/src/ — browser renderer and scene controllers
• web/tests/ — JavaScript tests
• tools/assets/ — WAD import and resource conversion
• tools/reference/ — optional capture and comparison tools
• docs/ — focused technical notes
• .local/ and web/public/assets/ — ignored local state and generated assets