SoulSilver Recomp est un portage natif de Pokémon SoulSilver pour macOS, distribué en binaire dans ses releases.
Architecture
Mac OS X - macOS
Apple Silicon
64-bit
Original game
Pokémon SoulSilver Nintendo DS
Download and links
- Download Pokémon SoulSilver
- Source code 142 GitHub stars
- License : GPL-3.0
Version history
0.4.2
Downloads: the same setup programs as before; update from the setup window and run the setup again to rebuild the game (your save is kept). Android players: press Build for Android again and install the new app over the old one.
- The widescreen 3D picture takes about half the processor time it did. It is drawn several pixels at a time (SIMD: AVX2 or SSE on PCs, NEON on phones), and its working memory now stays in the processor's cache. On PCs it also uses fewer threads (about one per core), which leaves more room for the game itself. The picture is the same, apart from the odd pixel along the edge of a polygon.
- The widescreen battle view looks for the stats window in one pass instead of four.
0.4.1
Downloads: the same setup programs as before; update from the setup window and run the setup again to rebuild the game (your save is kept). Android players: press Build for Android again and install the new app over the old one.
- Android: controllers such as the Backbone One work. SDL's own USB drivers took over some pads (the Backbone One, PlayStation pads) from Android's input, and lost them when they could not open them themselves. All controllers now come through Android, which knows them.
- Android: the app says when there is a new version. At start it asks GitHub for the newest release; when that is newer, a message at the top of the screen says to build the app again on the PC (the app holds your own game, so it cannot download itself). It is the only thing the app uses the internet for.
- Lower world detail for slower devices. WORLD DETAIL in the pause menu now also offers 384, 288 and 192 (the DS's own sharpness) as well as 540 to 1440; fewer lines draw faster. Left and right go down and up through the choices.
- FPS counter. FPS COUNTER in the pause menu shows the frames shown per second in the top right corner.
0.4.0
Full changelog
Downloads: the setup programs for Linux (x86_64 and arm64), Windows and now macOS (Apple Silicon and Intel; the Mac app is unsigned, so open it with right-click → Open the first time). Use the setup window's update button or download the new one, then run the setup again to rebuild the game (your save is kept).
- The bag shows just the bag. The item description box from the other screen is no longer drawn below it.
- A tidier Pokémon summary. The Pokémon's name, item and markings sit in their own column and the information from both screens is shown side by side, each in a rounded card with its contents centred, and no borders cut off.
- Menus stay on one layout. Opening the bag, party, Pokégear and the other menus from the start menu no longer shows the top screen and then both screens before the menu's own view, and closing them no longer falls back to the plain bottom screen while they fade out. The view now follows each menu from the moment the game starts loading it until it has closed (the game's start and end functions of each menu are watched as well as its main one).
- Faster again: about 30% in the overworld and 20% in battles (measured headless on a 6-core desktop; slower machines such as the Steam Deck and phones gain the most). The bottom screen and anything that does not move are no longer redrawn every frame, the CPUs switch less often, waits for the game card and the touch screen are skipped, and more instructions are recompiled. Nothing else changes: in testing, pictures, sound and memory came out the same, apart from a one-line difference in a few frames of battle transitions.
run.shwritesgame.lognext to it, as the setup window's Play button does.- The log lists every controller SDL sees (name, USB IDs, whether its layout is known), the SDL version, and the Steam and container settings that can hide a controller, for reports like #8.
0.3.0
Full changelog
Downloads: the same three setup programs; use these instead of the earlier ones and run the setup again to rebuild the game (your save is kept). From this version on, the setup window can update itself. This release also contains the controller fixes of the v0.2.6 prerelease (#8).
Faster
- The recompiled game code is about 6–9% faster than melonDS's interpreter
(before it was about 16% slower). The common instructions are now plain C++
instead of calls into the interpreter, and memory accesses and jumps take a
shorter path. Every instruction was checked against the interpreter
(
--lockstep) over 16,000 frames of booting, walking and battling.
Fixed
- White strips beside the screen as a battle opens. The widescreen view showed the half of the opening's background, and the 3D pieces, that the game keeps off the screen; a row the screen shows in one colour is now that colour beside it.
- The trainer's legs over the black bar as he slides out after throwing the Poké Ball: beside the screen he is now behind the message box, as on the screen.
- Fades at the start and end of a battle reached the sides of the view a frame before the screen, so the picture faded unevenly. The sides now use the palettes and brightness the screen was drawn with.
- The stats after a level up were cut in two, the top half moved to the right with the wild Pokémon's side. Windows like it now stay where the game puts them.
Added
-
Logs for bug reports. Started from the setup window, the game's messages now go to
game.log(new each time) and a build's output tobuild.log; Open logs folder opens the folder with both. On Androidlog.txtmoved toAndroid/data/io.github.clickingmaster.ssrecomp/files, where a file manager or a PC can reach it. The renderer in use is now always in the log. -
Updates from the setup window. At start it checks for a newer release (shown next to the version number); Update downloads the setup program for your system, checks it against the release's
SHA256SUMS.txt, puts it in place of the old one and restarts. Then press Build once to update the game; the save and settings are kept. (This version still has to be downloaded by hand.) -
Issue forms on GitHub ask for the version, system and log.
-
Portable mode (#10): with a file
portable.txtnext to the setup program, everything is kept in a folderssrecomp-databeside it instead of%LOCALAPPDATA%(Windows) or~/.local/share(Linux). The ROM's location is remembered relative to that folder, so it still works on another PC or drive letter.
Which file: Windows: ssrecomp-setup-windows-x86_64.exe. Linux PC / Steam Deck: ssrecomp-setup-linux-x86_64. Linux on ARM: ssrecomp-setup-linux-aarch64.AppImage. Mac (Apple Silicon, M1 and later): ssrecomp-setup-macos-arm64.zip; Mac (Intel): ssrecomp-setup-macos-x86_64.zip (the macOS port is by @DarthMDev, #7). The Mac app is not signed: unzip it, then right-click it and choose Open the first time (or allow it under System Settings → Privacy & Security). It does not update itself yet; download a newer one by hand. SHA256SUMS.txt has their checksums. The Android version is built by the setup program from your ROM (Build for Android).
0.2.6
Full changelog
This is a prerelease: it fixes controllers not working (#8) but has not been tried on Windows with a controller yet. If yours works now, or still doesn't, please say so in #8.
Downloads: the same three setup programs; use these instead of the earlier ones and run the setup again to rebuild the game.
Fixed
- Controllers not working (#8). Only the first controller found was used; on Windows that is often a virtual or idle device (from Steam, DS4Windows, vJoy, a racing wheel...), and then nothing pressed on any controller worked. Every connected controller now works at once.
- Generic USB pads that SDL does not know the layout of were ignored. They are now read with the usual layout: the first buttons as A, B, X, Y, then L, R, Select, Start, with the D-pad and the left stick. A device whose stick rests at one end (some keyboards and mice report themselves as joysticks) has its stick ignored, so the player does not walk on their own.
- The controller now also works while the game window is not focused, as when it was started from the setup window.
Tested
- On Linux with a real Xbox Series controller and virtual ones (an Xbox 360 pad, a generic USB pad, one with a stuck stick). Compiled for Windows, not yet tried with a controller there.
0.2.5
Downloads: the same three setup programs; use these instead of the earlier ones and run the setup again to rebuild the game (and the APK, on Android).
New
- Battles fill the wide screen instead of having stretched sides. The battle scene is drawn wider than the DS screen: the background and the platforms continue past its edges, the HP boxes move out to the sides of the view, and the wild Pokémon slides over to the right as your own Pokémon is on the left. The trainer throwing the Poké Ball walks all the way off screen.
- Move effects stay with the Pokémon they belong to, and the message box is left where it is.
Fixed
- The battle strip vanished for a moment between choosing FIGHT and the moves appearing, showing the message box under it.
Known limitations
- Tried on 16:9 only; wider phone screens (20:9) are untested in battles.
- A move effect crossing the gap between the two Pokémon can look stretched there for a moment.
0.2.4
Downloads: the same three setup programs; use these instead of the earlier ones and run the setup again to rebuild the game (and the APK, on Android).
Fixed
- Washed-out colours on Windows (#5): the game asked SDL for its OpenGL ES renderer, which on Windows (seen with AMD graphics) can convert every pixel as if it were linear light, so the whole picture looked pale. Windows now uses SDL's default, Direct3D.
- The game was always at night. The DS clock started at midnight on 1 January 2000 on every launch, so the overworld always had night lighting. It now follows your computer's clock, as on a real DS, including after loading a quick save. On an existing save the in-game clock jumps forward to today, like a DS that was switched off for a while.
0.2.3
Full changelog
Downloads: the same three setup programs; use these instead of the earlier ones. There is no APK to download: the Android version contains the game's code, so it is built from your own ROM on your PC, like the PC version.
New
- Build for Android in the setup program (
--androidwithout a window). It downloads Google's Android NDK and SDL2 (once, checked against their published checksums), compiles the game for 64-bit ARM Android 7.0+, and makes a signed APK to copy to the phone or handheld and install. No Java or Android Studio is needed: the APK is packed and signed bytools/android/apk.py. - On Android: full screen in landscape; on-screen buttons (D-pad, A/B/X/Y,
L/R, Start, Select, Menu), hidden while a controller is being used and back at
a touch; fingers on the picture touch the game's touch screen, several at
once; Back opens the pause menu; the save is written when the app goes to the
background; messages and frame timings go to
log.txtin the app's storage. - Tested in Google's Android emulator (Android 14): installs, updates over
itself, loads a save, plays with the on-screen buttons and touch, pause menu.
Not yet tried on a real phone or handheld: reports welcome, with
log.txtif something is wrong.
0.2.2
Full changelog
Downloads: the same three setup programs as before; use these instead of the earlier ones. Already built? Start the new setup program and press Build once: only the changed files are recompiled and your save is kept.
Fixed
- Windows: progress was not saved (#2). Only the first save ever reached
soulsilver.sav; later ones were left insoulsilver.sav.tmp, because Windows does not let a file be renamed over an existing one. Saves now replace the file. If you lost progress this way, see the note below. - Windows: the build stopped with "junk at end of line" in
rc_images.S(#3). The generated assembly ended with a Linux-only line. - Windows: "Could not find a package configuration file provided by SDL2" (#3). The setup program now uses MSYS2's CMake ahead of any other copy on the PATH, tells CMake where MSYS2's libraries are, and says when SDL2, libpng or zlib are missing.
- Screen jumping around while saving (#1). During "Saving a lot of data…" the layout fell back to the X menu's (the save card beside the overworld) and the picture flipped between widescreen and 4:3, because the game hardly runs anything else while it writes. The save screen now stays as it is until the save is written.
- Clearer install instructions in the setup program (#4): it says to open a terminal, has a button to copy the commands, and on SteamOS (Steam Deck) gives the container steps, as there programs cannot be installed directly.
Getting back lost progress on Windows (#2)
Close the game, open %LOCALAPPDATA%\ssrecomp, rename soulsilver.sav to
soulsilver.sav.old, then rename soulsilver.sav.tmp to soulsilver.sav. The
.tmp file holds your latest save.
Tested
- The whole game cross-compiled for Windows with MinGW and run under Wine: identical to the Linux build frame for frame, and saving in the game replaces the save file. Still not tried on a real Windows PC.
0.2.1
Added executables for windows, linux, and arm64 linux (appimage)
0.2.0
Added a gui to make it simpler to setup
0.1.0
Full changelog
The first public version. Playable from the start of a new game through the early routes, towns and gyms; the rest of the game has not been played through with it yet.
No ready-made download. A built program would contain the game's code, so
releases are source only: run ./setup.sh with your own copy of Pokémon
SoulSilver (US) as described in the README.
What's in it
- Static recompilation of the game's ARM9 code from pret/pokeheartgold's
build output, running on the melonDS core. Checked against melonDS's
interpreter instruction by instruction (
--lockstep). - One screen, no switching. Each situation has its own layout that takes the useful parts of both DS screens: the overworld with dialogue, the X menu beside the overworld, the bag, party, Pokédex, Pokégear, PC, shops, the intro and the starter choice.
- Widescreen overworld: the 3D world is drawn across the whole 16:9 view at a higher resolution (540–1440 lines, "WORLD DETAIL" in the pause menu); trees and buildings at the sides are drawn instead of popping in.
- Battles across the whole screen, with the touch-screen buttons as a strip along the bottom: FIGHT / BAG / POKéMON / RUN and the four moves, chosen with left and right, A to pick, B to go back.
- 60 fps: in-between frames for the 3D scene, which the game updates 30 times a second.
- Controller first: everything is reachable with buttons; a pause menu (Guide button or Esc) holds the settings, save states and fast forward.
- Runs well: about 9 ms of a 16.7 ms frame at 2560×1440 on a 6-core desktop CPU; the picture is composed on the graphics card.
setup.shinstalls what is missing, builds the game with the decompilation, checks it against the retail ROM's SHA-1 and compiles everything in one step.
Known limitations
- Linux only so far (tested on Ubuntu 24.04 in a container on Bazzite). Windows, macOS and Android builds do not exist yet.
- Only Pokémon SoulSilver (US). HeartGold and other regions are not supported.
- Later parts of the game, and some screens (radio, contests, the Pokéathlon, wireless features), have not been checked and may show a generic two-screen layout.
- The widescreen picture has no edge-marking outlines; battles, menus and the intro stay 4:3 apart from the battle sides.
- The recompiled code is not yet faster than melonDS's own interpreter; making it so is future work.
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.