Wonderful Toolchain Wiki

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.

testing_emulator

asie (asie@undisclosed.example.com) — 2026-01-21T17:10:29+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

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.

porting_wwitch

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

Porting WonderWitch applications WonderWitch applications compiled using the official Qute SDK require a copy of FreyaOS (and FreyaBIOS) to run. Unfortunately, nowadays a loose WonderWitch cartridge required to run such programs can go for as much as $100 on the second-hand market, with the full SDK fetching prices above $200 - much more than the console itself. This makes not just creating, but even running WonderWitch applications inaccessible to most hobbyists.

index

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

wswan The wswan target provides support for targetting the Bandai WonderSwan console. In addition, experimental support is provided for targetting the WonderWitch environment via the wwitch target. * Platform overview * Known issues Currently supported languages include:

license

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

Licensing information The Wonderful toolchain consists of many tools and libraries, which are provided under a variety of FSF/OSI-compliant open source licenses. Everything listed under “Tools” applies only to the toolchain itself; the output of these tools is generally not copyrighted and may be used freely, unless otherwise specified.

contributing

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

Contributing Code You're more than welcome to contribute code at the project's Codeberg organization. However, do note that I treat Wonderful as a personal project. My time is spread thin, and I cannot possibly support every use-case, platform or scenario. For this reason, while I will try to respond swiftly, I reserve the right to reject contributions for reasons as arbitrary as

your_first_program

asie (asie@undisclosed.example.com) — 2025-12-31T15:32:15+00:00

Your first program In this chapter, you're going to learn the basics of compiling and testing a homebrew project targetting the WonderSwan. Creating a project First, set up a new project: $ mkdir first-program/ # (1)! $ wf-wswantool project new first-program/ # (2)!

faq - [Can I disable color output in command line tools?]

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

Frequently Asked Questions General How can I install the Wonderful Toolchain? See the getting started guide for more information. What is the Wonderful Toolchain? The Wonderful Toolchain is my personal research project - a space to experiment with development tooling approaches for

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