Wonderful Toolchain Wiki

getting_started

asie (asie@undisclosed.example.com) — 2026-06-13T16:37:50+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), * macOS 26 or above (Apple Silicon hardware only). Other platforms, such as FreeBSD, are not currently supported. On such platforms, you may wish to set up a Linux container or virtual machine.

macos

asie (asie@undisclosed.example.com) — 2026-06-13T10:44:46+00:00

Getting started - macOS (Advanced) Return to the standard guide To install Wonderful on your computer, you will need: * an Apple Silicon (M1 or above)-powered Mac device, * the most recent version of macOS, * the following command-line tools provided by your distribution: bash, git, make.

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.

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.

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