StoicGoose

StoicGoose is a work-in-progress Bandai WonderSwan and WonderSwan Color emulator. It is written in C# via Visual Studio Community 2022 under Windows 10 Pro 21H2, and uses .NET 6.0 along with the following NuGet packages:

OpenTK 4.8.0 (for OpenGL rendering, OpenAL sound, etc.)
OpenTK.WinForms 4.0.0-pre.6 (for WinForms OpenGL control)
OpenAL-Soft.Win 1.2.0 (for OpenAL Soft runtime)
Newtonsoft.Json 13.0.3 (for configuration, cheats and breakpoint storage)
GitInfo 2.3.0 (for versioning information)
ImGui.NET 1.89.7.1 (for debugger UI)
Iced 1.20.0 (for x86 disassembly)
Microsoft.CodeAnalysis.CSharp.Scripting 4.5.0 (for breakpoint support)
Serilog 3.0.1, Serilog.Sinks.File 5.0.0 and Serilog.Sinks.Console 4.1.0 (for error and general message logging)

Versions

Two flavors of StoicGoose are available:

StoicGoose is the Windows Forms-based interface, meant for playing games. This build supports shaders, XInput controllers, etc.
StoicGoose.GLWindow is the Dear ImGui-based interface, meant solely for debugging and disassembling games.

Requirements

.NET 6.0 Desktop Runtime
A GPU supporting OpenGL 4.0 (ex. Nvidia GeForce 400 series or later, Radeon HD 5000 series or later, Intel Ivy Bridge iGPUs or later) and appropriate drivers
Optionally, copies of the WonderSwan and WonderSwan Color bootstrap ROMs (supported but not required); correct MD5 hashes are as follows
- 54b915694731cc22e07d3fb8a00ee2db (WonderSwan)
- 880893bd5a7d53fff826bd76a83d566e (WonderSwan Color)
- d3eff34719a363e586e12b700501ed91 (SwanCrystal)

Building

Windows

Download Visual Studio Community 2022
Clone the StoicGoose repository
Build and run the emulator

Linux

This has only been tested through Ubuntu 20.04.3 LTS via Windows Subsystem for Linux (WSL) so far, not yet on a standalone Linux installation.
Please check Microsoft's instructions for installing .NET on Linux and ensure your distribution is supported.
The Windows Forms-based interface will not work on Linux, only the Dear ImGui-based debugger.

To clone the StoicGoose repository:

$ git clone https://github.com/xdanieldzd/StoicGoose.git

To create and run a Debug build:

$ cd StoicGoose/StoicGoose.GLWindow/
$ dotnet build
$ dotnet bin/Debug/net6.0/StoicGoose.GLWindow.dll

To create and run a Release build:

$ cd StoicGoose/StoicGoose.GLWindow/
$ dotnet build -c Release
$ dotnet bin/Release/net6.0/StoicGoose.GLWindow.dll

Screenshots

WonderSwan and WonderSwan Color Bootstraps, using Dot-Matrix and Dot-Matrix Color shaders:

Various WonderSwan games, using Dot-Matrix shader:

Various WonderSwan Color games, using Dot-Matrix Color shader:

Debugger UI showing various tool windows:

Acknowledgements & Attribution

The XML data files in StoicGoose.WinForms\Assets\No-Intro were created by the No-Intro project; see the DAT-o-MATIC website for official downloads.
The TTF file JF-Dot-K14-2004.ttf in StoicGoose.GLWindow\Assets contains the font "K14-2004" by Hiroshi Tachibana and Toshiyuki Imamura, used as public domain, available as part of the 自家製ドットフォントシリーズ from 自家製フォント工房.
The file WS-Icon.ico in StoicGoose.WinForms is derived from "WonderSwan-Black-Left.jpg" on Wikipedia, in revision from 25 May 2014 by Evan-Amos, used as public domain.
My personal thanks and gratitude to the late Near, who has always been encouraging and inspiring on my amateur emulator developer journey. They are sorely missed.