About this project
This fork adapts the HeartGold/SoulSilver decompilation for one-screen SoulSilver: battle commands, moves, bag and party move onto one display, with state exposed for a widescreen/controller frontend. The current single-screen setup is tested only with SoulSilver USA, despite HeartGold in the repository name.
Source: Official project README — editorial review ↗ · Checked Oct 22, 2026
Compatibility
Supply your own SoulSilver USA .nds, mwccarm 2.0/sp2p2 and the compatible Nitro SDK, including tools/templates and library sources. The repository and setup releases do not distribute these proprietary prerequisites. Windows/Linux are setup/build hosts, not proof that the resulting DS ROM is a standalone PC game.
Source: Official project README — editorial review ↗ · Checked Oct 22, 2026
Documented support and independently tested compatibility are different. AllRecomps has not run these games.
Development progress
Release v0.1.4 adds Build + Android app / --android: it builds an arm64 APK from the locally built ROM, using a pinned public ssrecomp commit with this project’s frontend overlaid. It requires CMake and Ninja and downloads the Android NDK on first use. This is a hybrid path through ssrecomp, not a claim that all DS hardware is native code.
Source: Official single-screen installation guide ↗ · Checked Oct 22, 2026
The latest non-prerelease GitHub release observed is v0.1.4. A release does not establish stability, complete gameplay or tested platform support.
Source: GitHub latest release (automatic) ↗ · Checked Oct 22, 2026
Known limitations
The ordinary output is SoulSilver-single-screen.nds. Building that ROM is distinct from recompiling it into a host application. Matching retail HeartGold/SoulSilver build claims and source-coverage charts do not establish full gameplay or device compatibility for the modified single-screen version. macOS helpers inherited from upstream are explicitly untested for this fork.
Source: Official single-screen installation guide ↗ · Checked Oct 22, 2026
Getting started
Download the official Windows/Linux setup or run pokeheartgold_setup.py. Provide compiler folder/ZIP, SDK tools and library sources, and your SoulSilver USA ROM. The setup places the prerequisites, extracts data locally and builds the modified ROM. Linux also requires make, Python, pkg-config, arm-none-eabi-gcc and Wine.
Source: Official project README — editorial review ↗ · Checked Oct 22, 2026
Choose Build + Android app only when you want the optional Android output, and keep the APK private because it contains your game data. Save import accepts .sav or DeSmuME .dsv; the setup places it beside the built ROM and keeps an existing file as .bak.
Source: Official single-screen installation guide ↗ · Checked Oct 22, 2026
Some projects require files from your own copy of the original game. Follow the official instructions.
