Repository navigation
Releases
v1.6.0 - Continue Runs, Custom Challenges and More!
This release brings four new mods:
- Good Saac, 22 fixes for known bugs of the Flash games
- Continuum, to leave a run and carry on with it later.
- Challenge Lab, up to eight challenges of your own.
- Marksman, completion marks for each character.
Also: OpenGL ES and handheld support on PC / Linux (thanks to HellRok's RG CubeXX port), a fuller unlock in GenesisConsole, and a good batch of fixes.
As always, every mod is off until you turn it on, so the game plays exactly as before unless you choose otherwise.
NEW MOD! Good Saac 🐛
22 fixes for known bugs of the Flash games, each checked against the code of all three games (category Bug fixes). Each fix can be turned off on its own. Among them:
- The devil / angel room door after Mom now shows.
- With every item already owned, the game gives Breakfast instead of freezing.
- A new run no longer starts in the doorway you last came in by in the run before.
- Familiars' shots no longer go off from the other side of the room, far too fast or not at all when Robo-Baby is one of them (its laser left the wrong aim for the familiars that shoot after it).
And one improvement, as in Rebirth: no limit to the babies that follow you. Every baby item has its baby (the game has three at most, two in the original).
The full list is in MODS.
NEW MOD! Continuum 💾
Leave a run and carry on with it later, as Rebirth's "Continue" (category Gameplay):
- On the pause screen, choose "No" in "Are you sure you want me to die?" in a room with no enemies, and the run is kept.
- The next time you press Start, you're back in it, in front of the door you last came in by (in the middle of the room in a floor's first room, when no other room has been visited yet).
- A Challenge Lab run can be carried on.
NEW MOD! Challenge Lab 🧪
Up to 8 challenges of your own, on a second page of the challenge list (category Gameplay).
- Make them with the new
tools/challenge_lab_maker.html: character, items, trinket, curses (also the Curse of the Blind: no tears), treasure rooms, base stats and Eternal Edition's hard mode. - They're playable from the start and played apart from your save (your own hard mode setting is back as it was afterwards).
- Eight challenges of its own come with it, from fun (Kaboom!, Babysitter) to very hard (One Way Ticket).
- The hand cursor shows over its arrows and its challenges, as over the menus' other buttons.
NEW MOD! Marksman 🏆
Completion marks for each character, as in Rebirth (category HUD):
- On a new note of the character select: Mom, Mom's Heart, Isaac, Satan and ???, in red for Eternal Edition's hard mode.
- A boss's mark only shows once you have met that boss, so nothing is spoiled.
- During a challenge, the goal's mark is shown in the HUD band, top left.
🔧 Changes to other mods
- GenesisConsole:
unlocknow unlocks everything: all the challenges (also 10), the endings, the secrets (each once, in order) and the whole collection, The Gone's items too (for that session, as before). - The Gone: The Void Shard now lets the shots it dodges go right through you. With Black Mirror, the enemies now move and shoot as their kind does: half of them turned round (what came for you keeps away and the other way round), the others going for each other, also while you fly over a rock, where they used to stop.
- The Gone: the devil deals of a later run's devil room could all stay locked (pushed around like shop items) after a deal taken in an earlier run. (#39)
- StatOn: tears and range change as soon as the item is picked up (they used to wait for the next tear).
- Mods that change the same function of the game (The Gone and Good Saac) now work together.
🖥️ PC / Linux
These come from HellRok's port to the RG CubeXX handheld (github.com/HellRok/IsaacRecomp). Thank you!
render_heightinisaac.ininow works here too: the game draws at that height and scales the picture up (for slow computers;0= as before).- OpenGL ES computers and handhelds are supported: the program falls back to OpenGL ES 3 / 2 when desktop OpenGL is missing.
- Less memory is used on low-memory devices.
- The big border picture around the room is drawn faster and sharper.
⚙️ Fixes
- Ending 5's music no longer cuts out and starts again half way (a stretch of the animation had no sound in it: the music ran on and was pulled back). (#38)
- Eternal Edition: an item pedestal can no longer be pushed or dragged around the room after you take its item (it stays put, as in the Flash game).
- Android: a finger whose lift never reached the touch controls (with the console open, or during a multi-finger gesture) no longer leaves Isaac walking or shooting by himself. The joysticks follow the fingers the system says are on the screen, every frame, and any move / shoot key no finger holds is let go.
- The downloads now come with the
modsfolder (every mod and the Challenge Lab list) and an emptysavesfolder, next to the program (Switch: inswitch/isaac/).
📦 Downloads
| Platform | File | What's inside |
|---|---|---|
| Windows (64-bit) | IsaacRecomp_Win64.zip |
IsaacRecomp.exe, SDL2.dll, mods/, saves/, tools/ |
| Linux (64-bit) | IsaacRecomp_Linux64.tar.gz |
isaac, mods/, saves/, tools/ (needs SDL2) |
| Nintendo Switch | IsaacRecomp_Switch.zip |
switch/isaac/ with isaac.nro, mods/ and saves/ |
| Source code | IsaacRecomp_source.zip |
See Building from source in the README |
The game's own Isaac.exe from Steam is needed: no game data is included.
The tools/ folder has the mod manager, the GenesisConsole wiki, the save converter and the new Challenge Lab maker (open them in any web browser, offline).
Full details in README.txt (PC / Android) and README_SWITCH.txt (Switch).
🙏 Thanks
- HellRok, for the RG CubeXX port (github.com/HellRok/IsaacRecomp), where the OpenGL ES, low-memory and
render_heightchanges come from.
v1.5.0 - Modding, New Character and More!
Mods are here. 8 optional mods, all off by default, so the game plays exactly the same unless you turn them on.
🧩 How mods work
- They live in the new
modsfolder (Android:IsaacRecomp/mods/, Switch:sd:/switch/isaac/mods/). - Turn them on and off in
mods/mods.txt(on = 1), or usetools/mod_manager.htmlin any browser. It's offline: change the options, save, then drop the file intomods. - Bundled mods update themselves on new releases and keep your settings.
🎮 The mods
| Mod | What it does |
|---|---|
| 📊 StatOn | Shows your stats and your devil/angel room chance on screen, like Repentance |
| 🧪 GenesisConsole | A debug console: give items, spawn anything, warp, god mode. |
| 🖥️ WideSaac | Widescreen support. Hyper Zoom makes the room fill the screen; press M / L3 for the map |
| 💊 PillLog | Once you've taken a pill, its effect shows on every pill of that colour |
| 📖 Itemnomicon | Walk up to an item, trinket or card to see what it does before you take it |
| ⏱️ BaseTime | Speedrun timers, plus your best time on the main menu |
| 👻 The Gone | A new character like The Lost: no hearts, dies in one hit, 4 unlockables of his own |
| 🌈 RainbowVision | Colour-blind filters (deuteranopia, protanopia, tritanopia) |
Console commands are listed in
tools/genesis_wiki.html.
To unlock The Gone, clear 3 floors in a row without getting hit or picking up a heart.
⚙️ Fixes & improvements
- Less input lag and smoother motion on 60/120 Hz screens
- Faster rendering, especially on Switch
- Boss music no longer restarts after bosses that split (Duke of Flies, etc.)
- Escape or Back now closes the pause menu
- Better controller navigation on the character select screen
- You can no longer start locked characters by accident
- Minor visual bug fixes and lower memory use
📦 Downloads
| Platform | File | Install |
|---|---|---|
| Windows | IsaacRecomp_Win64.zip |
Extract, put Isaac.exe next to IsaacRecomp.exe |
| Linux | IsaacRecomp_Linux64.tar.gz |
Extract, put Isaac.exe next to isaac, run ./isaac |
| Android | IsaacRecomp.apk |
Install, then copy Isaac.exe to IsaacRecomp/ in internal storage |
| Switch | IsaacRecomp_Switch.zip |
Copy switch/ to the SD card, put Isaac.exe in sd:/switch/isaac/, launch in app mode (hold R) |
| Source | IsaacRecomp_source.zip |
See the README |
Updating from 1.4.x: replace the program files. Your saves and isaac.ini still work. On PC, also copy the new mods and tools folders.
Full details in README.txt / README_SWITCH.txt.
v1.4.0 - The Definitive Edition
This release is about one thing: making sure the recomp plays exactly like the original Flash game. Every enemy,
boss, item, pill, card and trinket of the three versions was checked against the original, frame by frame. The few
differences found are fixed, and the Switch version feels more responsive in busy rooms.
🔬 Checked against the original, frame by frame
The original game was run side by side with the recomp in Ruffle (an
independent Flash emulator), with the same input, the same random numbers and the same clock. Every enemy, tear,
pickup and Isaac himself were compared on every frame: position, speed, knockback, animation, health.
- Enemies: all of them (72 in the original, 90 in Wrath of the Lamb, 90 in Eternal Edition), alone, in real rooms
of every floor, and shot until they die. - Bosses: every boss room of every floor, with its variants (74 + 138 + 138 rooms), fought until the boss dies.
- Items: all of them (132 + 198 + 198), picked up and used in fights, with their active items.
- Pills, cards, runes and trinkets: all of them, pills with several random seeds.
- The high-resolution version itself: the original 800×600 game and the recomp's high-resolution one play
exactly the same.
Fixed along the way:
- Mom's Knife slowly drifted away from where it is in the original (rotations and sizes are now kept exactly as
the game sets them). - When a boss died, the poops in the room broke in a different order than in the original.
- The Hourglass works as in the original again: slowed enemies fire twice per attack and the Widow spawns twice
the spiders. Version 1.3.0 had "fixed" this, but that is how the original game plays. - Random runs: the numbers the game shuffles at the start of each floor vary as much as in the original.
- Switch and Android: the game's calculations now give exactly the same results as on PC.
⚡ Less input lag in busy rooms (most noticeable on Switch)
On Switch the controls could feel slightly heavier after the first floor, in rooms with many enemies. The image is
now never shown more than 6 ms behind the game on Switch, the same as on the first floor, and freeing memory no
longer delays the next image. Both can be changed in isaac.ini (max_margin, gc_after_tick); they are added to
your existing isaac.ini automatically, with an explanation.
🔊 Sound
- The game no longer waits for the sound mixer, which helps in busy rooms, especially on Switch.
- The music is no longer the first sound to be cut when too many sounds play at once.
- The chest and Satan sounds in the endings play at their original, lower volume.
- Switch mixes at the console's own 48 kHz.
📁 Switch and Android: same folders as on PC
- Switch: your saves,
preload*.txtandperformance.txtnow go insd:/switch/isaac/saves/, and the save
converter comes insd:/switch/isaac/tools/, as on PC. - Android: the same files now go in
IsaacRecomp/saves/(in the internal storage). - The first time 1.4.0 starts, the saves already there (
sd:/switch/isaac/,IsaacRecomp/) are copied into
saves/automatically. The old files are left where they were: you can delete them once you've checked your
progress is there.
🖼️ Small touches
- The program has the same icon as the Switch and Android versions (Windows: the
.exeand its window; Linux: the
window). - The save converter (
tools/save_converter.html) shows the current save folders.
📦 Downloads
| Platform | File | How to install |
|---|---|---|
| Windows (64-bit) | IsaacRecomp_Win64.zip |
Extract, put Isaac.exe next to IsaacRecomp.exe, run it |
| Linux (64-bit) | IsaacRecomp_Linux64.tar.gz |
Extract, put Isaac.exe next to isaac, run ./isaac |
| Android | IsaacRecomp.apk |
Install it, create the IsaacRecomp folder at the root of the internal storage, copy Isaac.exe into it |
| Nintendo Switch | IsaacRecomp_Switch.zip |
Copy switch/ to the SD card, put Isaac.exe in sd:/switch/isaac/, launch in application mode (hold R) |
| Source code | IsaacRecomp_source.zip |
See Building from source in the README |
Updating from 1.3.x: replace the program files. Your saves and isaac.ini keep working. On Switch, copy the new
switch/ folder over the old one (it now includes saves/ and tools/): your saves are copied into saves/ the
first time the game starts. On Android, just install the new APK: the saves are copied into IsaacRecomp/saves/
the same way.
Full details in README.txt (PC / Android) and README_SWITCH.txt (Switch).
v1.3.1 - Some Fixes and Improved Game Controller Support
A small update with fixes for what you reported after 1.3.0. Thanks for all the feedback!
💾 Saves now live next to the game (Windows / Linux)
- Your progress is now saved in a
savesfolder next toIsaacRecomp.exe/isaac(beside thetools
folder), so it is easy to find, back up or move with the game. - The first time 1.3.1 starts, the saves from the old location (
%APPDATA%\IsaacRecomp\WrathOfTheLamb\on Windows,
~/.local/share/IsaacRecomp/WrathOfTheLamb/on Linux) are copied over automatically. The old files are left
where they were. - Fixed: (#15) on Windows set up in some other languages, the game couldn't read or write its save if a folder name had
accents, Cyrillic or other non-English letters (for example the Windows user name). Any folder name works now.
🎮 Controller menus
- The selected option is pastel pink, with the same tone on every screen. Only Start in the main menu
keeps the deep red. - Collection: the D-pad / stick now moves to the item right next to the selected one, in the direction you press
(it used to jump around the grid). The first item is selected when the collection opens. - "Are you sure you want me to die?" (Exit Game, in the main menu and in the pause screen): the note can now be
answered with the controller. No is selected first, and the options behind the note can't be selected anymore. - Smoother movement: each press goes to the next option in that direction, with no skipped options (for
example Fullscreen → Music → Controls, Back → Rebind Controls). - B / ◯ goes back one screen, like the Back buttons: Controls → Options → main menu. It used to close every
window at once. - The selection no longer flickers or slides away while the screen moves (returning to the main menu, entering
Stats). - The collected items in the pause screen are no longer selectable, since they do nothing.
🔊 Sound with a controller (PC)
- Starting the game with a DualSense / DualShock 4 / Xbox controller already connected no longer sends the sound to
the controller (Windows makes it the default output). The game plays through your speakers or headphones.
📱 Touch controls
- Original game and Wrath of the Lamb: tapping the bomb counter places a bomb again. It only worked in Eternal
Edition.
📦 Downloads
| Platform | File | How to install |
|---|---|---|
| Windows (64-bit) | IsaacRecomp_Win64.zip |
Extract, put Isaac.exe next to IsaacRecomp.exe, run it |
| Linux (64-bit) | IsaacRecomp_Linux64.tar.gz |
Extract, put Isaac.exe next to isaac, run ./isaac |
| Android | IsaacRecomp.apk |
Install it, create the IsaacRecomp folder at the root of the internal storage, copy Isaac.exe into it |
| Nintendo Switch | IsaacRecomp_Switch.zip |
Copy switch/ to the SD card, put Isaac.exe in sd:/switch/isaac/, launch in application mode (hold R) |
| Source code | IsaacRecomp_source.zip |
See Building from source in the README |
Updating from 1.3.0: replace the program files. On PC your saves are copied to the new saves folder by
themselves. Your isaac.ini keeps working. On Android and Switch nothing moves: saves stay in the IsaacRecomp
folder and in sd:/switch/isaac/.
Full details in README.txt (PC / Android) and README_SWITCH.txt (Switch).
v1.3.0 - The (Re)Binding of Isaac: Rebind Controls + Save Converter + Tons of Fixes!
Full controller menus, control rebinding, a save converter for your Flash progress, and a long list of fixes
from your first reports. Thank you to everyone who played 1.2.0 and wrote in!
⌨️ Control rebinding
- New Rebind Controls entry in Options → Controls (from the main menu or the pause screen).
- It shows the controls of the device you are playing with, and you can switch device inside it:
- Keyboard: every action (move, shoot, bomb, active item, card/pill, pause).
- Controller: every action, plus which stick moves. PlayStation and Switch button names.
- Touch: which side moves, joystick size and joystick type (type 1: fixed base, type 2: the base
follows your finger).
- Press the new key or button and it swaps places with whatever had it. Reset to defaults restores the original
layout. Everything is saved inisaac.ini.
🎮 Menu with controllers revamp!
- The selected option is written in red (with the game's own rollover art), on PC, Android and Switch, in the
three versions of the game. - D-pad / left stick choose the nearest option in that direction, A / ✕ presses it, B / ◯ goes back
(and closes the pause screen). - Works everywhere: challenges list, collection items (D-PAD bugged for now), options, credits... Every screen opens on its first option.
💾 Save converter (Flash ⇄ IsaacRecomp)
tools/save_converter.htmlin every package: open it in any browser (offline, nothing is uploaded).- Converts the Flash game's
so.solto IsaacRecomp and back, for the original game, Wrath of the Lamb and Eternal
Edition. Stats, items, secrets, bosses, unlock order, hard mode and the lefty/AZERTY options carry over. - Based on the converter made by g333nza (#6). Thanks!
🐛 Fixes
- Mouse: the pointer turns into a hand over anything clickable, like in the original.
- Hearts: with more than 12 hearts, -LIFE- now switches to its smaller 24/48-heart layout like the original,
instead of the first hearts staying big and overlapping (#8). - Tears no longer appear for an instant below Isaac's head before jumping up to it (#7).
- Stuck shooting: holding the stick or D-pad into the boss "VS" screen or a pause could leave Isaac shooting by
himself. Keyboard, touch and every part of the controller no longer interfere with each other. - The Hourglass: slowed bosses no longer fire twice per attack, and the Widow no longer spawns twice the spiders.
- Boss fights on touch: a finger kept on the joystick through the boss intro keeps moving Isaac (he used to
stand still until you lifted it). - Credits: Credits → Credits plays the credits again instead of returning to the menu at once.
- PC audio with controllers: connecting a DualSense / DualShock 4 / Xbox controller no longer makes the game's
sound disappear (Windows moved it to the controller). The game keeps its speakers and still follows you when you
switch to other speakers or headphones. It's not perfect. If the game starts with a controller connected, there may be
no sound. If that's the case for you, until a fix is released, connect the controller after starting the game. - Android fixes:
- choppy "motor-like" sound on some phones and tablets (most of every block of sound was dropped);
- changing the audio output (headphones, Bluetooth) could crash and restart the game;
- the bomb counter, active item, card/pill and pause button are much easier to tap on wide or small screens.
📦 Downloads
| Platform | File | How to install |
|---|---|---|
| Windows (64-bit) | IsaacRecomp_Win64.zip |
Extract, put Isaac.exe next to IsaacRecomp.exe, run it |
| Linux (64-bit) | IsaacRecomp_Linux64.tar.gz |
Extract, put Isaac.exe next to isaac, run ./isaac |
| Android | IsaacRecomp.apk |
Install it, create the IsaacRecomp folder at the root of the internal storage, copy Isaac.exe into it |
| Nintendo Switch | IsaacRecomp_Switch.zip |
Copy switch/ to the SD card, put Isaac.exe in sd:/switch/isaac/, launch in application mode (hold R) |
| Source code | IsaacRecomp_source.zip |
See Building from source in the README |
Updating from 1.2.0: replace the program files. Your saves and isaac.ini keep working (new options take their
defaults). On Android, if the update refuses to install over the previous version, uninstall it first: saves and
settings are kept in the IsaacRecomp folder.
Full details in README.txt (PC / Android) and README_SWITCH.txt (Switch).
v1.2.0 - Android Has Joined the Family! Quality-of-Life Improvements to the Joysticks + Expanded Switch Capabilities
Android arrives, plus analog movement on every stick and touch controls on Switch.
📱 New: Android version
- Native APK for 64-bit ARM phones and tablets with Android 7.0 or newer (OpenGL ES 3.0).
- Touch controls: semi-transparent joysticks appear where you put your finger: left half to move, right half
to shoot. Tap the bomb counter, the active item and the card/pill to use them, and use the pause button next
to -LIFE- (or the back button/gesture). - Bluetooth / USB controllers work as on PC and can be mixed with touch.
- Automatic resolution: renders at 720 lines and steps down to 600 / 540 / 480 if the device can't keep 60 fps
(or setrender_heightyourself). Runs at the screen's refresh rate, 90 / 120 Hz included. - Low-latency audio (AAudio) mixed at the device's own rate. The run is paused and saved when you leave the app.
- The game, settings, saves and logs live in the
IsaacRecompfolder at the root of the internal storage.
🕹️ Analog movement (all platforms)
- With an analog stick (controller, Switch, touch joystick), Isaac's speed now follows how far you push it,
like in Rebirth. The dead zone is followed by 40 % speed, rising to full speed at ¾ of the stick's travel. - Top speed is never higher than the original. Keyboard and D-pad are unchanged.
- New
isaac.inioptionjoystick_acceleration(on by default;0restores the original all-or-nothing movement).
🎮 Nintendo Switch
- The touch screen now works during play in handheld mode: the same joysticks, HUD taps and pause button
next to -LIFE- as on Android (the button is hidden when docked).touch_controls = 0turns them off. - The left stick is now analog (see above).
- The Homebrew Menu now shows the author and version 1.2.0.
💻 PC
- Controllers in menus: menus and the pause screen can be used with the controller alone (A confirms, B goes
back, D-pad / left stick choose). Start / Back pause. - New
isaac.inioptionperformance = 1: the performance overlay (F3) is on from startup.
🔊 Audio (all platforms)
- Sound is mixed directly at the output device's sample rate with cubic interpolation, instead of being resampled
twice. Cleaner high frequencies.
📦 Downloads
| Platform | File | How to install |
|---|---|---|
| Windows (64-bit) | IsaacRecomp_Win64.zip |
Extract, put Isaac.exe next to IsaacRecomp.exe, run it |
| Linux (64-bit) | IsaacRecomp_Linux64.tar.gz |
Extract, put Isaac.exe next to isaac, run ./isaac |
| Android | IsaacRecomp.apk |
Install it, create the IsaacRecomp folder at the root of the internal storage, copy Isaac.exe into it |
| Nintendo Switch | IsaacRecomp_Switch.zip |
Copy switch/ to the SD card, put Isaac.exe in sd:/switch/isaac/, launch in application mode (hold R) |
| Source code | IsaacRecomp_source.zip |
See Building from source in the README |
Saves are compatible with v1.1.0 and can be copied between PC, Android and Switch. On PC and Switch, just replace
the program files; your isaac.ini keeps working, and new options take their default values.
Full details are in README.txt (PC / Android) and README_SWITCH.txt (Switch).
v1.1.0 - Perfomance and Gameplay Fixes and Improvements
Bug-fix and performance update over v1.0.0. All versions of the recomp were affected.
Fixes
- Blood/creep puddles dealt "random" damage. The floor check was done at the wrong spot (1.5×–2.25× away from the player), so puddles far away could hurt you and the one under you sometimes didn't. Now it matches what you see.
- Slowdown in long sessions (and crashes on Switch after 20–30 min). Every sound left an invisible object behind; thousands piled up over time.
- Hitches after ~30 min of play. The game now produces ~60% less memory garbage, and cleaning it up can no longer make a game tick miss its deadline.
- Eternal Edition: the hard-mode mark no longer appears on the HUD when hard mode is off.
- The learned preload list no longer grows without limit, and preloading never fills more than ~60% of the texture atlas.
- Sound durations now use each sound's real sample rate.
Improvements
- Lower input latency: the controller/keyboard is read continuously while waiting for the display, so presses don't wait for the next frame (
low_latency = 1, on by default). - New experimental option
interp_leadinisaac.ini(0–0.5) to draw the image slightly ahead. Visual only; the game logic is not affected.
Downloads
IsaacRecomp_Win64.zip— WindowsIsaacRecomp_Linux64.tar.gz— LinuxIsaacRecomp_Switch.zip— Nintendo Switch (homebrew)
Full Changelog: v1.0.1...v1.1.0
v1.0.1 - Fixed a Critical Bug and Improved Input Lag
Thank you very much for early feedback! The changes will be reflected in the source code shortly. Quick summary:
- Fixed a critical bug related to the game's sound system, which was accumulating objects and keeping them in memory, causing crashes during long sessions.
- Eternal edition: the pentagram symbol on the HUD now only appears in “HARD MODE.”
- Input lag has been slightly improved.
v1.0.0 - First Public Release
First official build of the project! I'm really happy with the final result. Give it a try and let me know what you think. Remember that you need the official game for this to work