Editing WonderSwan emulators

{{for|other emulators that run on WonderSwan hardware|Emulators on WonderSwan}} 
{{Infobox console
|title=WonderSwan (Color) / WonderWitch / Pocket Challenge V2
|logo=WonderSwan-Black-Left.png
|image=WonderSwan-Color-Blue-Left.png
|image2=WonderSwanCrystal.png
|image3=SwanCrystal-Wine-Left.png
|imagecaption='''Top:''' The WonderSwan.<br/>'''Middle:''' The WonderSwan Color.<br/>'''Bottom 2:''' The SwanCrystal<small>(Blue Violet & Red Wine).</small>
|developer=[https://www.koto.co.jp/english/history.html Koto], [[Bandai]], Qute, Benesse
|type=[[:Category:Handheld consoles|Handheld game console]], SDK
|generation=[[:Category:Fifth-generation video game consoles|5th generation]]
|release=1999 (WonderSwan)<br>2000 (WonderSwan Color)<br>2002 (Swan Crystal)<br>2001 (WonderWitch)<br>2002 (Swan Crystal, Pocket Challenge V2)
|discontinued=2003 (WonderSwan, WonderWitch)<br>2006 (Pocket Challenge V2)
|predecessor=[[Design Master Denshi Mangajuku]] (Design Master電子漫画塾), Pocket Challenge W
|successor=WonderSwan Color, Pocket Challenge Kanji Keisan Perfect Quest (Pocket Challenge漢字計算Perfect Quest), Pocket Challenge DX
|emulated={{✓}}
}}

The '''WonderSwan''', '''WonderSwan Color''' and '''SwanCrystal''' are the fifth-generation handheld game consoles produced by [[wikipedia:Bandai|Bandai]] in 1999, 2000 and 2002, respectively. It is the brainchild of Game Boy/Color creator, [[wikipedia:Gunpei_Yokoi|Gunpei Yokoi]]. There were three versions eventually released: A black-and-white version, a color version, and a  '''Crystal''' version with an improved screen.

'''WonderWitch''' is a software development kit by Qute for WonderSwan handheld consoles.

The '''Pocket Challenge V2''' is a handheld learning console compatible with the WonderSwan. It was sold on Shinkenzemi (進研ゼミ).

==Emulators==
<div style="overflow-x:auto">
{|class="wikitable" style="text-align:center;width:100%"
!scope="col"|Name
!scope="col"|Platform(s)
!scope="col"|Latest Version
!scope="col"|PCV2
!scope="col"|[[Netplay|<abbr title="Should not be confused with link-cable emulation.">Netplay</abbr>]]
!scope="col"|[[#Accessories|<abbr title="Wonderswan's EXT port for Accesories, for more information about accessories go to Accessories section">Serial<br/>Port</abbr>]]
!scope="col"|[[libretro]]
!scope="col"|[https://retroachievements.org/gameList.php?c=53 Retro<br/>Achievements]
!scope="col"|<abbr title="Free/Libre and Open-Source Software">FLOSS</abbr>
!scope="col"|Active
!scope="col"|[[Recommended emulators|Recommended]]
|-
! colspan="11"|PC / x86
|-
|[[ares]]
|align=left|{{Icon|Windows|Linux|macOS}}
|[https://nightly.link/ares-emulator/ares/workflows/build/master <abbr title="Latest development build version">git Artifacts</abbr>]<br/>[https://github.com/ares-emulator/ares/releases {{aresVer}}]
|{{✓}}
|{{✗}}
|{{✗}}[https://github.com/ares-emulator/ares/issues/961 *]
|{{✗}}
|{{✗}}
|{{✓}}
|{{✓}}
|{{✓}}
|-
|[[Mednafen]]<br/><small>[https://docs.libretro.com/library/beetle_cygne/ mednafen_wswan_libretro]</small>
|align=left|{{Icon|Windows|Linux|macOS|FreeBSD}}
|[{{MednafenURL|releases}} {{MednafenVer}}]<br/>[https://buildbot.libretro.com/nightly/ libretro core]
|{{✗}}
|{{✓}}
|{{✗}}
|{{✓}}
|{{~}}<ref group=N name=lrRA>Only with RetroArch version.</ref>
|{{✓}}
|{{✓}}
|{{✓}}
|-
|[[BizHawk]]
|align=left|{{Icon|Windows|Linux}}
|[https://gitlab.com/TASVideos/BizHawk/-/pipelines Dev builds]<br/>[http://tasvideos.org/BizHawk/ReleaseHistory.html {{BizHawkVer}}]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✓}}
|{{✓}}
|{{✓}}
|-
|[[StoicGoose]]
|align=left|{{Icon|Windows}}
|[https://github.com/xdanieldzd/StoicGoose/releases git]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✓}}
|{{~}}
|-
|[http://wwgp.qute.co.jp/2002/entry/00039/wwl/wwl07/Tools/MMage033/doc/README.htm MiracleMage]
|align=left|{{Icon|Windows}}
|[http://wwgp.qute.co.jp/2002/entry/00039/wwl/wwl07/Tools/MMage033 0.33][https://www.zophar.net/ws/miraclemage.html English Patch][https://trac.godzil.net/Godzil/MiracleMage][https://github.com/Godzil/MiracleMage]
|{{✗}}
|{{✗}}
|{{~}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✗}}
|{{~}}
|-
|[[higan]] (火眼)<br/>byuu (謬/view)
|align=left|{{Icon|Windows|Linux|macOS|FreeBSD}}
|[https://github.com/higan-emu/higan/releases {{higanVer}}]
|{{✓}}
|{{✗}}
|{{✗}}
|{{~}}<abbr title="You need to build higan libretro core yourself, there is no build available on RetroArch repository anymore. See 'forums.libretro.com/t/compiling-libretro-higan/16126' thread for compiling higan libretro core.">*</abbr>
|{{✗}}
|{{✓}}
|{{✗}}
|{{✗}}<ref group=N>Superseded by [[ares]]</ref>
|-
|[[MAME]]
|align=left|{{Icon|Windows|Linux|macOS|FreeBSD}}
|[http://www.mamedev.org/release.html {{MAMEVer}}]
|{{~}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✗}}
|{{✓}}
|{{✓}}
|{{✗}}
|-
|[[Cygne]]
|align=left|{{Icon|Windows}}
|[http://cygne.emuunlim.com 2.1a]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✗}}
|{{✗}}
|-
|[http://sourceforge.jp/projects/oswan/devel Oswan]
|align=left|{{Icon|Windows}}
|[http://sourceforge.jp/projects/oswan/releases/p5046 1.7.3]
|{{✗}}
|{{✗}}
|{{~}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✗}}
|{{✗}}
|-
|[http://wsonline.emuunlim.com/ WonderScott]
|align=left|{{Icon|Windows|Web}}
|[https://www.zophar.net/ws/wonderscott.html 0.54b]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|-
|[https://www.zophar.net/ws/wscamp.html WSCamp]
|align=left|{{Icon|Windows}}
|[https://emulationrealm.net/downloads/file/237-wscamp 0.21]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|-
|[https://web.archive.org/web/20141105014113/http://www.xe-emulator.com Xe]
|align=left|{{Icon|Windows|Linux}}
|[https://web.archive.org/web/20141022230129/http://www.xe-emulator.com/index.php?m=download 2.16.2]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✗}}
|{{✗}}
|-
! colspan="11"|Mobile / ARM
|-
|<small>[https://docs.libretro.com/library/beetle_cygne/ mednafen_wswan_libretro]</small>
|align=left|{{Icon|Android|Linux}}
|[https://buildbot.libretro.com/nightly/ libretro core]
|{{✗}}
|{{✓}}
|{{✗}}
|{{✓}}
|{{~}}<ref group=N name=lrRA></ref>
|{{✓}}
|{{✓}}
|{{✓}}
|-
|[[WonderDroid X|WonderDroid Ultra]]
|align=left|{{Icon|Android}}
|[https://play.google.com/store/apps/details?id=com.atelieryl.wonderdroid 5.3] [https://github.com/williehwc/wonderdroid-x git]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✓}}
|{{~}}
|-
|[[WonderDroid X]]
|align=left|{{Icon|Android}}
|[https://play.google.com/store/apps/details?id=com.willna.wonderdroid&hl=en_IN&gl=US 1.0.15] <small>($)</small>
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✓}}
|{{~}}
|-
|Swan.emu
|align=left|{{Icon|Android}}
|[https://play.google.com/store/apps/details?id=com.explusalpha.SwanEmu {{.emuVer}}][https://github.com/Rakashazi/emu-ex-plus-alpha git]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✓}}
|{{~}}
|-
! colspan="11"|Console
|-
|<small>[https://docs.libretro.com/library/beetle_cygne/ mednafen_wswan_libretro]</small>
|align=left|{{Icon|PS3}}<br/>{{Icon|PS4}}<br/>{{Icon||Vita|NGC|Wii}}<br/>{{Icon|WiiU|XboxOne}}<br/>{{Icon|XboxSXS}}
|[https://www.retroarch.com/?page=platforms libretro core]
|{{✗}}
|{{✓}}
|{{✗}}
|{{✓}}
|{{~}}<ref group=N name=lrRA></ref>
|{{✓}}
|{{✓}}
|{{✓}}
|-
|NitroSwan
|align=left|{{Icon|NDS}}
|[https://github.com/FluBBaOfWard/NitroSwan/releases git]
|{{~}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✓}}
|{{✓}}
|-
|e[mulator] for PSP <br/><small>(core based on Oswan)</small>
|align=left|{{Icon|PSP}}
|[https://archive.org/details/emulator_082f.7z 0.82f]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✗}}
|{{✓}}
|-
|[http://wiibrew.org/wiki/WiiMednafen WiiMednafen]
|align=left|{{Icon|Wii}}
|[https://github.com/raz0red/wii-mednafen git]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✓}}
|{{✓}}
|-
|[http://dev-e.sakura.ne.jp eSwan]
|align=left|{{Icon|PSP}}
|[https://archive.org/details/eSwan009.7z 0.09]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{~}}
|-
|SwanEmu
|align=left|{{Icon|GCWZero}}
|[https://github.com/gameblabla/SwanEmu git]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✗}}
|{{~}}
|-
|DualSwan
|align=left|{{Icon|NDS}}
|[https://dlhb.gamebrew.org/dshomebrew/dualswan.7z 1.2.1]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{~}}
|-
|PocketWS
|align=left|{{Icon|Gizmondo}}
|[https://app.box.com/s/puzizv5n9bmk6t1awfkmv3ldqh8lpkf7 0.02b]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{~}}
|-
|Wonderstation
|align=left|{{Icon|PS2}}
|[https://www.thetechgame.com/Downloads/id=207041/wonderstation-oswan-ps2-01.html 0.1]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{~}}
|-
|Oswan
|align=left|{{Icon|Saturn}}<br/>{{Icon|Nspire}}
|[https://www.ticalc.org/archives/files/fileinfo/464/46494.html Gameblabla's]<br/>[http://vberthelot.free.fr/Atlas/RB_AllStars_060323.rar 06/03/23]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✓}}
|{{✗}}
|{{~}}
|-
|OswanDC
|align=left|{{Icon|DC}}
|[https://emulationrealm.net/downloads/file/1096-oswan-dc 0.15]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|-
|SwanAdvance
|align=left|{{Icon|GBA}}
|[https://www.zophar.net/consoles/gameboy/ws/swanadvance.html 0.1]
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|{{✗}}
|}
</div>
<references group=N />

===Comparisons===
;[[ares]]:The WonderSwan core in ares [https://old.reddit.com/r/emulation/comments/r4wrbn/ares_v126_released_multisystem_emulator/hmlf0vo/ implements many features of the BIOS not implemented in other emulators] and [https://github.com/ares-emulator/ares/issues/908 cycle-accurate] [https://old.reddit.com/r/emulation/comments/zwq9fu/ares_crossplatform_open_source_multisystem/j1z2jeo/ (with pixel accuracy option)]. [https://old.reddit.com/r/emulation/comments/11ltlvu/ares_multisystem_emulator_v132_has_been_released/ v132 version] of [[ares]] brings the WonderSwan core has once again received a significant amount of improvements, making it even more accurate than ever before; while most of these changes do not impact commercial games, [[ares]] is rapidly becoming more viable emulator for WonderSwan homebrew development, this is leaps and bounds better than any other emulators as of March 2023.
;WSCamp:A WonderSwan and WS Color emulator written by Toshi.  This was the first WonderSwan emulator to feature sound as well as gamepad support, and it has a very high compatibility rate and excellent speed. It was the most accurate WonderSwan emulator at the time in the early 2000's, beating out [[Cygne]] and Oswan.
;[[Cygne]]:The first WonderSwan emulator created on the Windows platform, written by DOX and released under the GNU General Public License. It had undergone massive improvements over its original DOS beta form in the early 2000's, including better timing and fixes to the SRAM. Cygne has a high compatibility rate, but lacks in speed and does not offer any sound support. Cygne supports both the original WonderSwan and the WonderSwan Color. However, it was abandoned in 2002.
;MiracleMage:The only WonderWitch emu known as of now, this emulates the home development kit system for the Japanese WonderSwan Color. This patch for the Japanese version translates it into English.
;Oswan:Oswan is a WonderSwan/WS Color emulator based on the Cygne source code and authored by David Raingeard. Improvements upon the original Cygne source include the additional of sound support and many speed improvements. Oswan also features the ability to apply several video filters as well as color schemes to add color to WonderSwan Classic titles. It has been abandoned but two variants of it were released in 2007 and 2010.
;WonderScott:The second WonderSwan/WSC emulator, this WonderSwan emulator written in JavaScript was authored by Julien Frelat (Gollum) and released by the same team that made Boycott Advance. An online web format of WonderScott was also available at its official website, but is probably permanently inaccessible. It was somehow abandoned after its last version, v0.54b, was uploaded near the end of 2001 with poor compatibility.

==Debugging==
;[[Mednafen]]:This multi-system emulator is said to have great debugging and cheat engine features but, unfortunately, has a [https://www.reddit.com/r/emulation/comments/3llkck/comment/cv78kj7 CRC check function] similar to default MAME. A CRC check analyses a game ROM file for any change to its data and size, so a fan-translator or ROMhacker would have to edit filenames every time for every change, which is incredibly tedious. This is likely the reason why there have not been many hack and fan-translation patches being provided publicly for any game on several systems that are covered by Mednafen such as Wonderswan (this page's topic), Neo Geo and PC Engine/PCE CD. These systems don't tend to have many good alternative emulators, let alone ones with good quality debuggers.
;[[MAME]]:This well-known emulator of thousands of systems also has a normal CRC check algorithm to insure that the ROM file(s) of any supported game or clone, depending on the database/ROMset for a MAME version, match the data integrity and size of the same game/variant in the records. However, this does make it rather prickly for an aspiring ROMhacker. The MAME developers partly wanted this to reduce the nasty incidences of some sellers pawning circuit boards that were actually stuffed with user-made ROMhacks. There are a few ways around that - note that MAME developers still support genuine fan-translators, even for arcade games. 
::1) Try using the HBMAME or MAMEUIFX frontend, which may support loading modified ROMs.
::2) If you don't zip the set and instead make a folder with the zipname inside your rompath with properly-named loose files inside there, MAME will fuss up, but it will run the game even though the CRCs don't match.
::3) With the new GEnie build system, it's pretty easy to build a one-game-off version of MAME that builds in seconds on pretty much any worthwhile PC.
:::''make SUBTARGET=rom_name DRIVERS=src/mame/drivers/whatever.c REGENIE=1''
;Oswan:A very good, worked and unused emulator. But it has a (poorly working) debugger, so making a hack patch on a WS game can be a lot smoother process with this software's tool than Mednafen's.

==Features & pages on recommended/available WonderSwan/WS Color emulators==
* [http://www.racketboy.com/retro/bandai-wonderswan-101-a-beginners-guide BANDAI WONDERSWAN 101: A BEGINNER’S GUIDE] (July 6th, 2007 by racketboy; updated June 19th, 2018. Old feature covering early WonderSwan emulation. Oswan and WSCamp were the recommended emulators according to the article. Both are too old by now and not recommended.)
* [https://en.wikibooks.org/wiki/PSP/Emulation_List#Bandai_WonderSwan Wikibooks.org] (PSP/Emulation List. 5 old emulators and ports for the PSP.)
* [http://www.vtemulation.net/emulators/windows/ws.php VTEmulation.net] (Old list of 3 old, early 2000's recommended emulators. Site no longer maintained.)
* [http://www.old-computers.com/MUSEUM/emulator.asp?c=1175&st=2 Old-Computers.com] (List of 5 old, early 2000's emulators. For reference only.)
* [https://www.zophar.net/ws.html Zophar's Domain] (List of downloads for 5 old, early 2000's emulators.)

==Accessories==
{|class="wikitable" style="text-align:center; vertical-align:middle;"
|-style="font-weight:bold;"
!Name
!ares
!StoicGoose
!MiracleMage
!Oswan
|-
|Communication cable
|{{✗}}
|?
|?
|?
|-
|Headphone connector
|{{✗}}
|?
|?
|?
|-
|Digimon Connector
|{{✗}}
|?
|?
|?
|-
|Wonder coin
|{{✗}}
|?
|?
|?
|-
|WonderWave
|{{✗}}
|?
|?
|?
|-
|WonderGate
|{{✗}}
|?
|?
|?
|-
|WonderBorg
|{{✗}}
|?
|?
|?
|-
|WonderWitch
|{{✗}}
|?
|{{~}}
|{{✓}}
|-✓
|Icons
|{{✗}}
|{{~}}
|?
|?
|}
[https://www.youtube.com/watch?v=ZsSlzI0q2SI How to run Wonderwitch homebrew .fx files in Oswan (Wonderswan) (Tutorial)] 
For more information about WonderSwan accessories [https://wonderswan.fandom.com/wiki/Accessory_port use this link].

<references group=N />

==Also See==
* [[Emulators on WonderSwan]]

[[Category:Consoles]]
[[Category:Handheld consoles]]
[[Category:Fifth-generation video game consoles]]
[[Category:Bandai consoles]]
[[Category:WonderSwan emulators|*]]