{"id":57564,"url":"https://github.com/WonderfulToolchain/awesome-wsdev","name":"awesome-wsdev","description":"A curated list of WonderSwan development resources.","projects_count":94,"last_synced_at":"2026-08-04T06:00:25.204Z","repository":{"id":39945095,"uuid":"507285371","full_name":"WonderfulToolchain/awesome-wsdev","owner":"WonderfulToolchain","description":"A curated list of WonderSwan development resources.","archived":false,"fork":false,"pushed_at":"2026-04-20T15:17:09.000Z","size":24,"stargazers_count":90,"open_issues_count":0,"forks_count":4,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-07-16T01:04:13.819Z","etag":null,"topics":["8086","awesome","awesome-list","documentation","gamedev","list","wonderswan","wonderwitch"],"latest_commit_sha":null,"homepage":"","language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WonderfulToolchain.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"asiekierka","liberapay":"asie","patreon":"asie"}},"created_at":"2022-06-25T10:54:06.000Z","updated_at":"2026-06-20T21:23:39.000Z","dependencies_parsed_at":"2023-01-30T19:16:08.425Z","dependency_job_id":"3a369414-7d49-4bde-9572-0e01098fa03e","html_url":"https://github.com/WonderfulToolchain/awesome-wsdev","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/WonderfulToolchain/awesome-wsdev","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WonderfulToolchain%2Fawesome-wsdev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WonderfulToolchain%2Fawesome-wsdev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WonderfulToolchain%2Fawesome-wsdev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WonderfulToolchain%2Fawesome-wsdev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WonderfulToolchain","download_url":"https://codeload.github.com/WonderfulToolchain/awesome-wsdev/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WonderfulToolchain%2Fawesome-wsdev/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36263568,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-08-04T02:00:06.901Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"created_at":"2024-04-08T00:00:22.141Z","updated_at":"2026-08-04T06:00:25.205Z","primary_language":null,"list_of_lists":false,"displayable":true,"categories":["Emulators","Documentation","Accuracy test ROMs","Software development","Source code","WonderWitch","Hardware development","Historical","Introduction","Test ROMs","Open source hardware"],"sub_categories":["Console","WonderSwan hardware","Datasheets","Peripherals","Other documentation","Libraries","Tools","Boilerplate","Games","Other programs","Miscellaneous","WW documentation","WW open-source homebrew","Cartridges","Other hardware development","Demos","Screen capture","Peripheral emulators","Getting started","WW tools","Open source WW programs"],"readme":"# Awesome WonderSwan Development\n\nA curated list of awesome WonderSwan/WonderSwan Color development resources and tools. Inspired by the [awesome](https://github.com/sindresorhus/awesome) list.\n\n## Contents\n\n- [Introduction](#introduction)\n  - [Getting started](#getting-started)\n- [Documentation](#documentation)\n  - [Datasheets](#datasheets)\n  - [Other documentation](#other-documentation)\n- [Emulators](#emulators)\n  - [Peripheral emulators](#peripheral-emulators)\n  - [Test ROMs](#test-roms)\n- [Software development](#software-development)\n  - [Libraries](#libraries)\n    - [Music drivers](#music-drivers)\n  - [Tools](#tools)\n    - [Graphics utilities](#graphics-utilities)\n- [Source code](#source-code)\n  - [Boilerplate](#boilerplate)\n  - [Demos](#demos)\n  - [Games](#games)\n  - [Other programs](#other-programs)\n  - [Miscellaneous](#miscellaneous)\n- [WonderWitch](#wonderwitch)\n  - [WW tools](#ww-tools)\n  - [WW documentation](#ww-documentation)\n  - [Open source WW programs](#open-source-ww-programs)\n- [Open source hardware](#open-source-hardware)\n  - [Cartridges](#cartridges)\n  - [Peripherals](#peripherals)\n  - [Screen capture](#screen-capture)\n  - [Other hardware development](#other-hardware-development)\n- [Historical](#historical)\n\n## Introduction\n\nThe Bandai WonderSwan is a handheld game console released and supported by Bandai from 1999 to 2003 in Japan,\nwith later follow-ups in the form of the 2000 WonderSwan Color and 2002 SwanCrystal. It is the last piece of\nhardware with design input from the legendary Gunpei Yokoi, as well as [Asuka Langley's handheld of choice](https://img.asie.pl/t9zJ.jpg).\n\nWhile this list focuses on \"bare metal\" WonderSwan development (cartridge ROM as output), note that there exists\nan official homebrew SDK for the console called the [WonderWitch](http://wonderwitch.qute.co.jp/) created by Qute Corporation,\nwhich requires different targetting (custom .fx file format, FreyaBIOS hardware abstraction layer, FreyaOS libraries,\nmore restrictive IRAM/SRAM layout). Tools and examples for the WonderWitch are present in their own section; however,\nmany other entries (such as hardware documentation or graphics converters) are applicable to both environments.\n\n### Getting started\n\nFor native WonderSwan development, I personally recommend the following sources:\n\n * [Wonderful Toolchain Wiki](https://wonderful.asie.pl/wiki/doku.php?id=wswan:index) - documentation for the open-source WonderSwan/WonderWitch homebrew toolchain,\n * [WSdev Wiki](https://ws.nesdev.org/wiki/Main_Page) - hardware documentation.\n\nFor native WonderSwan and WonderWitch development alike, you may find a serial port adapter useful. The [ConsoleMods Wiki](https://consolemods.org/wiki/WonderSwan:RS-232_Serial_Cable_Mod)\nprovides a list of both purchaseable adapters and DIY building projects.\n\n## Documentation\n\n * **[WSdev Wiki](https://ws.nesdev.org/wiki/Main_Page)** - the most recent and actively developed documentation source, hosted by nesdev.org.\n * [STSWS](http://perfectkiosk.net/stsws.html) - contains some information not yet on the WSdev wiki.\n * [WSMan](http://daifukkat.su/docs/wsman/) - older documentation source.\n\n### Datasheets\n\n#### NEC V30MZ CPU\n\nThe NEC V30MZ is an 80186-compatible CPU for low-power platforms with an efficient pipeline design. It should not be confused with the\nNEC V20/V30 line of CPUs, which provide additional opcodes and features on top of the 8086 architecture.\n\nFor a variety of reasons, NEC's documentation (and some WonderSwan documentation) uses unique NEC opcode names, while other sources\nand assemblers typically use Intel opcode names. A translation map between the two is available [as part of STSWS](http://perfectkiosk.net/stsws.html#cpu_8086_translation_map).\n\n * [NEC V30MZ Preliminary User's Manual](https://www.renesas.com/us/en/document/lbr/v30mztm-hardware-preliminary)\n\n#### Other\n\n  * [Seiko S-3511A](http://perfectkiosk.net/S-3511A.pdf) - cartridge RTC.\n  * [Fujitsu MBM29DL400TC](https://github.com/up-n-atom/WonderWitch/blob/main/Datasheets/MBM29DL400BC-12PFTN_to_MBM29DL400TC-90PFTN.pdf) - WonderWitch NOR flash.\n\n### Other documentation\n\n * [Everything You Never Wanted to Know about the WonderSwan RTC](https://forums.nesdev.org/viewtopic.php?t=21513)\n * [Retail cartridges](https://github.com/RSDuck/nileswan/blob/main/docs/retail_cartridges.md) - cartridge logic analyzer and requirement documentation.\n * [splashbuilder readme](https://github.com/Godzil/splashbuilder/blob/master/README.md) - WonderSwan Color custom boot splash format.\n * [.WSR file format documentation](archive/in_wsr.txt) (Japanese) - popular WonderSwan standalone/emulated music file format.\n\n## Emulators\n\n * **[Mesen 2](https://github.com/SourMesen/Mesen2/)** (GPL-3.0) - high accuracy, extensive built-in debugger and profiler, recommended for development.\n * [ares](https://ares-emu.net/) (ISC) - high accuracy.\n * [Mednafen](https://mednafen.github.io/) (GPL-2.0) - serial port emulation, built-in debugger.\n   * [BizHawk](https://tasvideos.org/Bizhawk) - WonderSwan core based on Mednafen, features Lua scripting and rewind/movie support.\n   * [wf-mednafen](https://codeberg.org/WonderfulToolchain/wf-mednafen/releases/) - fork of Mednafen with emulation fixes and debugger UI/UX improvements, based on mednafenPceDev's work.\n   * [WonderDroid Ultra](https://f-droid.org/packages/com.atelieryl.wonderdroid/) - fork of Mednafen, Android port.\n * [NitroSwan](https://github.com/FluBBaOfWard/NitroSwan) - WonderSwan emulator for Nintendo DS/DSi, user friendly WonderWitch support.\n   * [SwanGBA](https://github.com/FluBBaOfWard/SwanGBA/) - GBA version of the above, does not run at full speed.\n * [StoicGoose](https://github.com/xdanieldzd/StoicGoose) (MIT) - C# WonderSwan emulator.\n * [Oswan](sourceforge.jp/projects/oswan/devel) (GPL-2.0) - legacy WonderSwan emulator with a built-in debugger.\n\n### Peripheral emulators\n\nThese emulators are currently only supported by Mednafen by editing its `wswan.excomm` configuration option.\n\n * [WonderFence](https://bitbucket.org/trap15/wonderfence/src/master/) (MIT) - MobileWonderGate internet adapter emulator.\n\n## Test ROMs\n\n * [WSCPUTest](https://github.com/FluBBaOfWard/WSCPUTest) - V30MZ CPU behaviour\n * [WSHWTest](https://github.com/FluBBaOfWard/WSHWTest) - SoC interrupt/PPU timer handling\n * [WSTimingTest](https://github.com/FluBBaOfWard/WSTimingTest) - V30MZ CPU timing\n * [ws-test-suite](https://github.com/asiekierka/ws-test-suite) (MIT) - assorted hardware tests and testing tools\n * [rtctest](https://forums.nesdev.org/viewtopic.php?t=21513) - \"2003 mapper + S-3511\" RTC protocol and behaviour\n * [Robert Peip's test ROMs](https://github.com/MiSTer-devel/WonderSwan_MiSTer/tree/main/testroms) - sprite priority/window testing tool\n * [KarnakTest](https://github.com/FluBBaOfWard/KarnakTest) - PCv2 KARNAK timer/ADPCM mapper testing\n\n## Software development\n\n * **[Wonderful](https://wonderful.asie.pl/)** - gcc-ia16 based C/ASM toolchain for WonderSwan and WonderWitch.\n * [owswan](https://github.com/jounikor/owswan) - OpenWatcom-based WonderSwan toolchain. \n * [Kyoui](https://asie.pl/files/kyoui_2004_11_02.zip) - (mirror) tools for compiling WonderSwan binaries using OpenWatcom.\n * [WSLink](https://bitbucket.org/trap15/wonder/src/master/) (MIT) - NASM linker outputting WonderSwan and WonderWitch compatible binaries.\n\n### Libraries\n\n * [libws](https://codeberg.org/WonderfulToolchain/target-wswan-syslibs/tree/main/libws) (zlib) - hardware abstraction functions\n * [libwsx](https://codeberg.org/WonderfulToolchain/target-wswan-syslibs/tree/main/libwsx) (zlib) - decompressors and other useful functions\n * [LZSS decompression routine](archive/orion-lzss-decompression-routine.asm) (public domain)\n\n#### Music drivers\n\n * [Cygnals](github.com/joffb/cygnals) (MIT) - partially Furnace compatible audio driver.\n * [WonderSwan Total Sound Driver](https://github.com/Shaw02/WTD)\n \n### Tools\n\n * [Dekadence WonderSwan Tools](https://github.com/superjohan/wonderswan-tools) (MIT) - assorted Python scripts.\n * [splashbuilder](https://github.com/Godzil/splashbuilder) (BSD-3-Clause) - toolchain for creating custom WonderSwan Color boot splashes.\n\n#### Graphics utilities\n\n * **[SuperFamiconv](https://github.com/Optiroc/SuperFamiconv)** (MIT) - tile/map converter with flexible palette/optimization options and mostly-complete WS/WSC support.\n * [bmp2swan](http://onorisoft.free.fr/retro.htm?ws/ws.htm) - simple bitmap converter.\n\n## Source code\n\n### Boilerplate\n\n * [wonder/template](https://bitbucket.org/trap15/wonder/src/master/samples/template/) - NASM-based template.\n\n### Demos\n\n * [#wonderwitch IRC channel promo](https://github.com/tslanina/Retro-WonderSwanColor-Promo) (MIT)\n * [Bad Apple!! for WSwan](https://github.com/asiekierka/bad-apple-for-wswan) (MIT)\n * [HBlank Cylinder Effect](https://github.com/joffb/wsc-witch-cylinder)\n\n### Games\n\n * [Inufuto's games](http://inufuto.web.fc2.com/8bit/) - written using a custom C-like toolchain.\n * [SwanDriving](http://sebastianmihai.com/swan-driving.html) ([Mono](http://sebastianmihai.com/swan-driving-bw.html)) - tech demo written with NASM.\n * [WonderSnake](https://github.com/tslanina/Retro-WonderSwanColor-Wondersnake) (GPL-3.0) - Snake game written with Borland TASM.\n\n### Other programs\n\n * [144p Test Suite for WS](https://github.com/asiekierka/240p-test-ws) (GPL-3.0) - 240p Test Suite-inspired user-side testing tool\n * [BootFriend](https://wonderful.asie.pl/ws/bootfriend) (GPL-3.0) - WonderSwan custom \"firmware\"/splash screen patch - XMODEM software load to RAM and more!\n * [CartFriend](https://github.com/WonderfulToolchain/ws-cartfriend) (GPL-3.0) - WonderSwan cartridge menu/launcher\n * [Chips1](https://github.com/asiekierka/chips1) (MIT) - CHIP-8/SuperCHIP emulator.\n * [ELKS](https://github.com/ghaerr/elks) (GPL-2.0 + others) - Embedded Linux Kernel Subset kernel/operating system.\n * [ieepview](https://github.com/asiekierka/ws-ieepview) (MIT) - internal EEPROM viewer/editor.\n * [ws-backup-tool](https://github.com/asiekierka/ws-backup-tool) (GPL-3.0) - cartridge backup/restore/flash tool and IPL dumper for BootFriend.\n * [wsmonitor](https://bitbucket.org/trap15/wsmonitor/) (MIT) - 80186 debug monitor.\n\n### Miscellaneous\n\n * [vgmswan](https://github.com/asiekierka/vgmswan) (MIT/zlib) - .VGM playback and conversion tools.\n\n## WonderWitch\n\n * [AthenaOS](https://github.com/OpenWitch/AthenaOS) - FreyaBIOS/FreyaOS re-implementation project.\n * [ow-libs](https://github.com/OpenWitch/ow-libs) - WonderWitch standard library re-implementation project.\n * [wonderwitchvc15](https://github.com/autumn009/wonderwitchvc15) - example of using Visual C++ 1.5 for compiling WonderWitch binaries.\n\n### WW tools\n\n * [exe2fbin](https://github.com/OpenWitch/exe2fbin) (PD) - reconstruction of the official exe2fbin binary.\n * [MiracleMage](https://github.com/Godzil/MiracleMage) (GPL-2.0) - high-level WonderWitch emulator, only supports \"mono\" software, does not require a WonderWitch ROM.\n * [romwitch](https://bitbucket.org/trap15/romwitch/) (GPL-2.0) - utility to inject executables into \"static\" WonderWitch software ROMs.\n\n### WW documentation\n\n * [Don Walizer Jr's tutorials](https://www.donwalizerjr.com/tags/wonderswan) ([source code](https://github.com/dwalizer/wonderwitch)).\n * [Wonder Witch Technical Manual](http://shaw.la.coocan.jp/wwtm/)\n * [WSdev Wiki](https://ws.nesdev.org/wiki/Main_Page) - also contains a WonderWitch section.\n * [wonder/doc/freya](https://bitbucket.org/trap15/wonder/src/master/doc/freya/)\n\n### Open source WW programs\n\nThis section only lists programs whose source code is explicitly listed under open source licenses.\n\n#### Games\n\n * [FallingTower mini](http://www.fenix.ne.jp/~cdrtk/soft/wwjump.html) (BSD-2-Clause)\n * [Nametry](https://www.asahi-net.or.jp/~cs8k-cyu/ww/nametry.html) (BSD-2-Clause)\n * [Noiz](https://www.asahi-net.or.jp/~cs8k-cyu/ww/noiz.html) (GPL-2.0-or-later)\n * [PutiPati](https://www.asahi-net.or.jp/~cs8k-cyu/ww/putipati.html) (BSD-2-Clause)\n * [Soari-san](http://www.fenix.ne.jp/~cdrtk/soft/soari.html) (BSD-2-Clause)\n * [SpeedMac](https://kozos.jp/ww/) (BSD-2-Clause)\n * [yoppa](https://github.com/WonderfulToolchain/yoppa/tree/original) (BSD-3-Clause)\n\n#### Applications\n\n * [dumpipl](https://github.com/up-n-atom/wwsoft/tree/master/dumpipl) (MIT) - WS/WSC initial program loader dumping tool (as \"Soft\" image).\n * [vgmwitch](https://bitbucket.org/trap15/vgmwitch) (MIT) - SN76489 music player.\n * [WWTerm](https://github.com/WonderfulToolchain/WWTerm/tree/original) (GPL-2.0) - terminal emulator.\n * [米七note](http://www.fenix.ne.jp/~cdrtk/soft/ksnote.html) (BSD-2-Clause)\n\n#### Libraries\n\n * [HummingCat](https://github.com/molety/HummingCat/) (MIT) - work-in-progress sound driver.\n\n## Open source hardware\n\n### Cartridges\n\n * [Bandai2003](https://github.com/up-n-atom/Bandai2003) (MIT) - Verilog \"2003\" mapper implementation.\n * [mbc-unlock](https://bitbucket.org/trap15/mbc-unlock) (CC0) - VHDL boot handshake implementation.\n * [nileswan](https://github.com/RSDuck/nileswan/) (GPLv3) - open-source flash cartridge.\n\n### Peripherals\n\n * [ExtFriend](https://github.com/WonderfulToolchain/ws-extfriend) (GPL-3.0) - WonderSwan EXT\u003c-\u003eUSB adapter with digital audio capture.\n * [wsheadphone](https://github.com/zwenergy/wsheadphone) (CC-BY-NC-SA-4.0) - headphone DAC adapter.\n * [WS-LinkC](https://github.com/zwenergy/WS-LinkC) (CC-BY-NC-SA-4.0) - cheap, DIY-friendly link cable alternative.\n * [WSMtool](https://github.com/zwenergy/WSMtool) (CC-BY-NC-SA-4.0) - multitool adapter for the WonderSwan; headphone, serial and link cable adapter in one. \n\n### Screen capture\n\n * [nisetro_wsc](https://github.com/splash5/nisetro_wsc) (MIT) - FPGA-based screen capture solution.\n * [swancolorHD](https://github.com/zwenergy/swancolorHD) (GPL-3.0) - FPGA-based screen capture solution.\n   * [swantroller](https://github.com/zwenergy/swantroller) (GPL-3.0) - WonderSwan Color-based controller PCB for the swancolorHD.\n\n### Other hardware development\n\n * [USB WonderSwan Cartridge Utility](https://github.com/up-n-atom/WonderSwanCartTap) (MIT) - cartridge dumper and programmer.\n * [WonderSwan for MiSTer](https://github.com/MiSTer-devel/WonderSwan_MiSTer) (GPL-2.0)\n\n## Historical\n\nThese are links to files and sources which are noteworthy from a historical perspective, but have been superseded.\n\n * [WSTech 2.4](https://github.com/OpenEmu/Mednafen-Core/blob/master/mednafen/wswan/wstech24.txt) - outdated document, incorrect in places.\n","projects_url":"https://awesome.ecosyste.ms/api/v1/lists/wonderfultoolchain%2Fawesome-wsdev/projects"}