Wonderful Toolchain Wiki

finish

asie (asie@undisclosed.example.com) — 2026-06-03T14:17:27+00:00

Post-getting started guide Updating It is recommended to perform an update after initial installation, as well as periodically to ensure the latest packages are installed. To update, run wf-pacman -Syu. If wf-pacman itself has been updated, you will need to run

windows

asie (asie@undisclosed.example.com) — 2026-06-03T14:16:17+00:00

Getting started - Windows (Manual) Return to the standard guide To install Wonderful on your computer, you will need: * a recent version of Windows - Windows 10 and above are supported, * a CPU architecture compatible with x86_64. Installation instructions Required files:

linux

asie (asie@undisclosed.example.com) — 2026-06-03T14:16:08+00:00

Getting started - Linux (Advanced) Return to the standard guide To install Wonderful on your computer, you will need: * a Linux distribution released sometime in the last decade (maybe a bit more), * a CPU architecture compatible with x86_64 or AArch64, * the following command-line tools provided by your distribution: bash, git, make.

getting_started

asie (asie@undisclosed.example.com) — 2026-06-03T14:13:11+00:00

Installation The following platforms are supported as of writing: * Windows 10 or above, * Linux with a recent kernel version (x86-64 and AArch64 architectures supported). Other platforms, such as macOS, are not currently supported. On such platforms, you may wish to set up a Linux container or virtual machine.

testing_emulator - recommend Mesen CE instead

asie (asie@undisclosed.example.com) — 2026-04-12T11:57:47+00:00

Testing homebrew using an emulator The cheap and convenient way! As homebrew produced by Wonderful requires a somewhat higher degree of accuracy than most emulators provide, please try to stick to emulators listed here. If you don't feel like reading the whole page, just download

optimization

asie (asie@undisclosed.example.com) — 2026-02-11T18:53:17+00:00

Optimizing programs This page serves as a loose list of advice for getting the most out of the WonderSwan. Optimizing C code Optimizing for code speed To optimize for speed, compile your code with -O2. Optimizing for code size To optimize for size, compile your code with

testing_hardware

asie (asie@undisclosed.example.com) — 2026-01-31T06:19:16+00:00

Testing homebrew using physical hardware Required hardware Game console To test homebrew, you're going to need at least one WonderSwan hardware unit. There are many options available, between the three official models and various hardware mods; this guide lists them in order from most to least preferred.

start

asie (asie@undisclosed.example.com) — 2026-01-12T20:08:25+00:00

Welcome to the Wonderful Toolchain Wiki! The Wonderful Toolchain is my (asie's) personal research project - a space to experiment with various approaches of providing development tooling for forgotten platforms, with a particular focus on retro handhelds. This wiki serves as a central documentation hub for the toolchain.

bugs - [Bug: Miscompilations involving far function pointers]

asie (asie@undisclosed.example.com) — 2026-01-10T20:50:29+00:00

Known issues gcc-ia16 * In general, if you run into a compiler error or miscompilation, try annotating the function with __attribute__((noinline, optimize("-O0"))) as a workaround. * gcc-ia16's handling of far pointers is considered experimental. Caveat emptor.

community

asie (asie@undisclosed.example.com) — 2026-01-10T20:48:15+00:00

Community (Talk with us!) There are three main community spaces made available to users of the toolchain. Spaces Forum For asking questions and longer-form discussion, a good place to start is the forum thread on NESdev. With enough activity, it might become a subforum!

wwitch

asie (asie@undisclosed.example.com) — 2026-01-08T15:57:54+00:00

Developing for WonderWitch The WonderWitch is an official homebrew development environment provided by Qute Corporation. As the official toolchain is proprietary, Wonderful provides its own toolchain for the platform, allowing use of both BIOS system calls and direct hardware access.

freya_monitor.png - created

asie (asie@undisclosed.example.com) — 2025-12-31T09:29:54+00:00

tumblr_opci1hbzld1rozdf0o1_1280.png - created

asie (asie@undisclosed.example.com) — 2025-08-30T15:12:19+00:00

favicon.ico - created

asie (asie@undisclosed.example.com) — 2025-05-04T07:38:07+00:00

mesen2.png - created

asie (asie@undisclosed.example.com) — 2024-09-19T17:33:59+00:00

logo.png - created

asie (asie@undisclosed.example.com) — 2023-06-10T19:57:21+00:00