Skip to content


The Swan Book serves as a guide for writing homebrew for the Bandai WonderSwan and WonderSwan Color.

Neither this guide nor this toolchain is in any way affiliated with or endorsed by Bandai, Koto Laboratory or Qute Corporation.

While this guide focuses on using the Wonderful toolchain, some of its parts are applicable for general development for the platform.

The guide assumes a basic familiarity with the C programming language.

Toolchain overview

The Wonderful toolchain for WonderSwan is based on gcc-ia16, a fork of GCC 6.3.0 targetting 8086-class CPUs, which includes the console's NEC V30MZ.

The C programming language is well-supported up to C11, albeit with some caveats.


  • All code provided in The Swan Book is licensed under the CC0 license. This means you're allowed to make use of it without restriction in your own projects.
  • The remainder of The Swan Book's contents (text, images, etc.) are licensed under the terms of the Creative Commons Attribution-ShareAlike 4.0 International license.