{"id":13691114,"url":"https://github.com/FluBBaOfWard/NitroSwan","last_synced_at":"2025-05-02T15:31:14.785Z","repository":{"id":49585766,"uuid":"418228488","full_name":"FluBBaOfWard/NitroSwan","owner":"FluBBaOfWard","description":"Bandai WonderSwan (Color/Crystal) \u0026 Benesse PocketChallenge V2 emulator for the Nintendo DS(i)/3DS.","archived":false,"fork":false,"pushed_at":"2025-04-25T14:44:23.000Z","size":709,"stargazers_count":50,"open_issues_count":13,"forks_count":3,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-25T15:43:06.206Z","etag":null,"topics":["bandai-wonderswan","emulator","nintendo-ds","wonderswan"],"latest_commit_sha":null,"homepage":"","language":"C","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/FluBBaOfWard.png","metadata":{"files":{"readme":"README.md","changelog":"History.txt","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}},"created_at":"2021-10-17T19:00:08.000Z","updated_at":"2025-04-25T14:44:26.000Z","dependencies_parsed_at":"2023-02-16T23:05:19.533Z","dependency_job_id":"617c7d37-392a-4595-a43d-00d27cf81cba","html_url":"https://github.com/FluBBaOfWard/NitroSwan","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FluBBaOfWard%2FNitroSwan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FluBBaOfWard%2FNitroSwan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FluBBaOfWard%2FNitroSwan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FluBBaOfWard%2FNitroSwan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FluBBaOfWard","download_url":"https://codeload.github.com/FluBBaOfWard/NitroSwan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252062783,"owners_count":21688597,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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"}},"keywords":["bandai-wonderswan","emulator","nintendo-ds","wonderswan"],"created_at":"2024-08-02T17:00:40.462Z","updated_at":"2025-05-02T15:31:14.775Z","avatar_url":"https://github.com/FluBBaOfWard.png","language":"C","funding_links":[],"categories":["Handheld game console emulators","Emulators","Bandai WonderSwan/WonderSwan Color/SwanCrystal/WonderWitch"],"sub_categories":["Bandai WonderSwan/WonderSwan Color/SwanCrystal/WonderWitch","Console","Atari Lynx"],"readme":"# NitroSwan V0.7.2\n\n\u003cimg align=\"right\" width=\"220\" src=\"./logo.png\" alt=\"The WonderSwan logo\" /\u003e\n\nThis is a Bandai WonderSwan (Color/Crystal) \u0026 Benesse PocketChallenge V2\n emulator for the Nintendo DS(i)/3DS.\n\n## How to use\n\n1. Create a folder named \"nitroswan\" in either the root of your flash card or\n in the data folder. This is where settings and save files end up.\n2. Now put game/bios files into a folder where you have (WonderSwan) roms, max\n 768 files per folder, filenames must not be longer than 127 chars. You can use\n zip-files (as long as they use the deflate compression). CAUTION! Games that\n require SLOT-2 RAM can not be used with zip-files!\n3. Depending on your flashcart you might have to DLDI patch the emulator.\n\nThe save files should be compatible with most other WonderSwan emulators.\n\nWhen the emulator starts, you can either press L+R or tap on the screen to open\n up the menu. Now you can use the cross or touchscreen to navigate the menus, A\n or double tap to select an option, B or the top of the screen to go back a\n step.\n\nTo select between the tabs use R \u0026 L or the touchscreen.\n\nHold Start while starting a game to enter the boot rom settings, the internal\n EEPROM is saved when saving settings.\n\nSince the DS/DS Lite only has 4MB of RAM you will need a SLOT-2/GBA cart with\n RAM to play games larger than 2MB.\n\n## Menu\n\n### File\n\n* Load Game: Select a game to load.\n* Load State: Load a previously saved state of the currently running game.\n* Save State: Save a state of the currently running game.\n* Load NVRAM: Load non volatile ram (EEPROM/SRAM) for the currently running game.\n* Save NVRAM: Save non volatile ram (EEPROM/SRAM) for the currently running game.\n* Load Patch: Apply an IPS patch to the currectly loaded rom.\n* Save Settings: Save the current settings (and internal EEPROM).\n* Reset Game: Reset the currently running game.\n\n### Options\n\n* Controller:\n  * Autofire: Select if you want autofire.\n  * Swap A/B: Swap which NDS button is mapped to which WS button.\n  * Alternate layout: See Controls.\n* Display:\n  * Gamma: Lets you change the gamma (\"brightness\").\n  * Contrast: Lets you change the contrast.\n  * B\u0026W Palette: Here you can select the palette for B \u0026 W games.\n  * Border: Choose what to show outside the WS screen.\n* Machine:\n  * Machine: Select the emulated machine.\n  * Select WS Bios: Load a real WS Bios.\n  * Select WS Color Bios: Load a real WS Color Bios.\n  * Select WS Crystal Bios: Load a real WS Crystal Bios.\n  * Import Internal EEPROM: Load a special internal EEPROM.\n  * Clear Internal EEPROM: Reset internal EEPROM.\n  * Headphones: Select whether heaphones are connected or not.\n  * Cpu speed hacks: Allow speed hacks.\n* Settings:\n  * Speed: Switch between speed modes.\n    * Normal: Game runs at its normal speed.\n    * 200%: Game can run up to double speed.\n    * Max: Games can run up to 4 times normal speed.\n    * 50%: Game runs at half speed.\n  * Allow Refresh Change: Allow the Wonderswan to change NDS refresh rate.\n  * Autoload State: Toggle Savestate autoloading. Automagically load the savestate associated with the selected game.\n  * Autoload NVRAM: Toggle EEPROM/SRAM autoloading. Automagically load the EEPROM/SRAM associated with the selected game.\n  * Autosave Settings: This will save settings when leaving menu if any changes are made.\n  * Autopause Game: Toggle if the game should pause when opening the menu.\n  * Powersave 2nd Screen: If graphics/light should be turned off for the GUI screen when menu is not active.\n  * Emulator on Bottom: Select if top or bottom screen should be used for emulator, when menu is active emulator screen is allways on top.\n  * Autosleep: Doesn't work.\n* WonderWitch: Tools for interacting with a WonderWitch.\n  * See WonderWitch.md for more information.\n* Debug:\n  * Debug Output: Show FPS and logged text.\n  * Disable Foreground: Turn on/off foreground rendering.\n  * Disable Background: Turn on/off background rendering.\n  * Disable Sprites: Turn on/off sprite rendering.\n  * Disable Windows: Turn on/off window effects.\n  * Step Frame: Emulate one frame.\n\n### About\n\nSome info about the emulator and game...\n\n## Controls\n\n### WonderSwan\n\n```text\nStart is mapped to WS Start.\nSelect is mapped to WS Sound.\nIn horizontal games the d-pad is mapped to WS X1-X4. A \u0026 B buttons are mapped to WS A \u0026 B.\nHolding L or R maps the dpad to WS Y1-Y4.\n\nIn vertical games the d-pad is mapped to WS Y1-Y4. A, B, X \u0026 Y are mapped to WS X1-X4.\n\nIn alternate layout it is the same as normal horizontal, except L, R, X \u0026 Y are\nmapped to WS Y1-Y4. To open the menu use L+Select.\n```\n\n### Pocket Challenge V2\n\n```text\nDpad is mapped to up, down, left \u0026 right.\nL is mapped to Escape.\nR \u0026 X is mapped to Voice/View.\nA is mapped to Clear.\nB is mapped to Circle.\nY is mapped to Pass.\n```\n\n## Games\n\nThere are 3 games that I know of that has serious problems.\n\n* Beatmania: Game is too large even for the DSi. Can be used with a 16MB SLOT-2 card or on 3DS.\n* Chou Denki Card Game: You need to initialize NVRAM, this is the last item on the first page (初期化).\n* Mahjong Touryuumon, speed too fast.\n\nThere are a couple of games that have visual glitches.\n\n* Dicing Knight. shadows are in front of player.\n* Digimon - Anode Tamer \u0026 Cathode Tamer, missing background gradient in battles.\n* Final Fantasy, sprites show in dialog windows.\n* Final Lap 2000, incorrect road colors.\n* Final Lap Special - GT \u0026 Formula Machine, incorrect road colors.\n* From TV Animation One Piece - Grand Battle Swan Colosseum, incorrect sky color.\n* Makaimura, first boss sprites are glitchy, gargoyles in intro should not show up on the right.\n* Neon Genesis Evangelion - Shito Ikusei, sprites overlap avatar images.\n* Rockman \u0026 Forte - Mirai Kara no Chousensha, no background fade in intro.\n* Romancing Sa-Ga, sprites overlap text boxes.\n* Sorobang, needs all 1024 tiles in 4color mode.\n* WonderSwan Color BIOS, needs all 1024 tiles in 4color mode.\n\n## Accuracy\n\nI've made a few test programs for the WonderSwan to be able to really make sure\n it is as accurate as possible.\n\n* [WSCPUTest](https://github.com/FluBBaOfWard/WSCpuTest) - Tests functions of the NEC V30MZ CPU instructions.\n* [WSTimingTest](https://github.com/FluBBaOfWard/WSTimingTest) - Tests timing of the NEC V30MZ CPU instruction.\n* [WSHWTest](https://github.com/FluBBaOfWard/WSHWTest) - Tests other HW of the WS SOC.\n\nOther test programs I have used to get better accuracy.\n\n* [WS-Test-Suite](https://github.com/asiekierka/ws-test-suite) - Lots of small tests.\n* [RTC Test](https://forums.nesdev.org/viewtopic.php?t=21513) Test the RTC in certain cartridges.\n\n## Credits\n\n```text\nHuge thanks to Loopy for the incredible PocketNES, without it this emu would probably never have been made.\nThanks to:\nasie for info and inspiration. https://ws.nesdev.org/wiki/WSdev_Wiki\nEd Mandy (Flavor) for WonderSwan info \u0026 flashcart. https://www.flashmasta.com\nKoyote for WonderSwan info.\nAlex Marshall (trap15) for WonderSwan info. http://daifukkat.su/docs/wsman/\nGuy Perfect for WonderSwan info http://perfectkiosk.net/stsws.html\nGodzil for the boot rom stubs. https://github.com/Godzil/NewOswan\nlidnariq for RTC info.\nplasturion for some BnW palettes.\nDwedit for help and inspiration with a lot of things. https://www.dwedit.org\n```\n\nFredrik Ahlström\n\n\u003chttps://bsky.app/profile/therealflubba.bsky.social\u003e\n\n\u003chttps://www.github.com/FluBBaOfWard\u003e\n\nX/Twitter @TheRealFluBBa\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFluBBaOfWard%2FNitroSwan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFluBBaOfWard%2FNitroSwan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFluBBaOfWard%2FNitroSwan/lists"}