How to Download and Install Pokémon Heart & Soul Safely

Pokémon Heart & Soul is a completed Game Boy Advance ROM hack that brings the Johto adventure into the Pokémon Emerald engine. It acts as both a remake of Pokémon Gold, Silver, and Crystal and a GBA-style demake of HeartGold and SoulSilver, combining the classic Johto storyline with Kanto, following Pokémon, modern quality-of-life improvements, challenge settings, newer mechanics, and additional postgame content.

The current Heart & Soul 2.0 branch was rebuilt on pokeemerald-expansion, making it substantially different under the hood from the older Heart & Soul 1.x releases. The official project describes 2.0 as a rebuilt version incorporating mechanics from Generations 3 through 9 while keeping the core Johto and Kanto experience intact. citeturn547400search5

As of September 2026, the latest official release is Pokémon Heart & Soul v2.0.4. The official GitHub release page marks 2.0.4 as the latest version and includes its patch, emulator recommendations, documentation, and patch notes. citeturn141798view0

What You Need Before Installing Pokémon Heart & Soul

Before installing Heart & Soul, you need:

• A legally obtained clean Pokémon Emerald ROM
• The official Heart & Soul v2.0.4 patch
• A UPS-compatible ROM patcher
• A compatible Game Boy Advance emulator
• A backup of any existing Heart & Soul save
• A fresh save if you are moving from Heart & Soul 1.x to 2.x

Heart & Soul is a GBA ROM hack, so the finished game normally uses the:

.gba

file extension.

The official developers recommend Rom Patcher JS for applying the patch. The current release uses Pokémon Emerald as the base ROM and distributes only the fan-made patch, not a complete Pokémon game. citeturn141798view0

Rom Professor does not provide or link to copyrighted Pokémon Emerald ROMs or unofficial pre-patched Heart & Soul ROMs.

What Base ROM Does Pokémon Heart & Soul Use?

Pokémon Heart & Soul v2.0.4 requires a clean:

Pokémon Emerald Version (U)

The official Heart & Soul release instructions explicitly tell players to provide their own legally obtained copy of Pokemon - Emerald Version (U). citeturn141798view0

The official Heart & Soul source repository also includes the expected SHA-1 checksum for the base ROM:

f3ae088181bf583e55daf962a92bb46f4f1d07b7 citeturn545051view0

Requirement	Pokémon Heart & Soul
Base game	Pokémon Emerald
Platform	Game Boy Advance
Region	USA / U
ROM condition	Clean and unmodified
Expected SHA-1	f3ae088181bf583e55daf962a92bb46f4f1d07b7
Patch format	UPS
Typical finished extension	.gba
Current version	v2.0.4

Do not try to patch:

• Pokémon FireRed
• Pokémon Gold or Silver
• Pokémon HeartGold or SoulSilver
• Pokémon Ruby or Sapphire
• Another Emerald ROM hack
• Heart & Soul 1.x
• An already-patched Heart & Soul ROM
• A randomized or otherwise modified Emerald ROM

Even though Heart & Soul recreates Johto, its actual base ROM is Pokémon Emerald.

Where to Get the Official Pokémon Heart & Soul Patch

Use the official Pokémon Heart & Soul GitHub release page.

Official Pokémon Heart & Soul latest release

The page currently redirects to:

Heart & Soul Release 2.0.4

and identifies it as the latest official release. citeturn141798view0

The developers distribute a UPS patch.

Do not use GitHub’s general Download ZIP button for ordinary installation. That downloads the project’s source code rather than the player patch.

Instead, scroll down to the Assets area of the v2.0.4 release and obtain the attached Heart & Soul patch.

You can also use the official player documentation:

Pokémon Heart & Soul documentation

Avoid websites offering something labeled:

Pokemon Heart and Soul v2.0.4.gba

or:

Heart and Soul Pre-Patched ROM

Those are complete ROM files containing copyrighted Pokémon Emerald data.

The proper installation method is:

Clean Pokémon Emerald ROM + official Heart & Soul patch = Pokémon Heart & Soul

How to Patch Pokémon Heart & Soul

The developers specifically recommend Rom Patcher JS, so that is the method we will use here. citeturn141798view0

Step 1: Prepare a Clean Pokémon Emerald ROM

Locate your legally obtained backup of:

Pokémon Emerald Version (U)

The file will usually look something like:

Pokemon Emerald.gba

Make sure it is clean and unmodified.

If you want to verify the exact ROM, calculate its SHA-1 checksum.

The expected checksum is:

f3ae088181bf583e55daf962a92bb46f4f1d07b7 citeturn545051view0

If your checksum does not match, use another legally obtained backup of the correct Pokémon Emerald version.

Keep this clean ROM untouched. You may need it again when installing future patches.

Step 2: Download the Heart & Soul v2.0.4 Patch

Open the official Heart & Soul latest release page:

Heart & Soul v2.0.4 release

Scroll to the release assets and download the Heart & Soul .ups patch.

Do not download the entire GitHub source repository just to play the game.

Step 3: Open Rom Patcher JS

The official Heart & Soul instructions recommend Rom Patcher JS. citeturn141798view0

Open Rom Patcher JS

You should see two main file fields:

ROM file

and:

Patch file

Step 4: Select Your Pokémon Emerald ROM

Under:

ROM file

select:

Pokemon Emerald.gba

This should be your clean US Pokémon Emerald ROM.

Do not select your old Heart & Soul ROM here.

Step 5: Select the Heart & Soul Patch

Under:

Patch file

choose the Heart & Soul UPS patch downloaded from the official v2.0.4 release.

Your patcher should now effectively show:

ROM: Pokémon Emerald Version (U)

Patch: Heart & Soul v2.0.4

The official instructions say you should see a green checkmark when the files are compatible. citeturn141798view0

Step 6: Apply the Patch

Select:

Apply Patch

Rom Patcher JS will create a new .gba file.

Save it somewhere easy to find.

For example:

Pokemon Heart and Soul v2.0.4.gba

Do not overwrite your clean Pokémon Emerald ROM.

Step 7: Open Heart & Soul in Your Emulator

Launch your GBA emulator and open:

Pokemon Heart and Soul v2.0.4.gba

If everything worked, Heart & Soul should start instead of ordinary Pokémon Emerald.

How to Play Pokémon Heart & Soul on Windows

The official developers recommend:

mGBA

for Windows and Mac. citeturn141798view0

To play on Windows:

1. Install mGBA.
2. Launch mGBA.
3. Select File.
4. Choose Load ROM or Open ROM.
5. Locate your patched Heart & Soul .gba file.
6. Open it.
7. Configure your keyboard or controller if necessary.
8. Start playing.

mGBA should be your first troubleshooting emulator if Heart & Soul behaves strangely elsewhere.

How to Play Pokémon Heart & Soul on Mac

Use mGBA on macOS as well.

The developers specifically list mGBA for both PC and Mac. citeturn141798view0

To play:

1. Install mGBA.
2. Launch it.
3. Open your patched Heart & Soul .gba file.
4. Configure your controls.
5. Start your game.

You should not need unusual advanced emulator settings.

How to Play Pokémon Heart & Soul on Android

The official Heart & Soul v2.0.4 release recommends several Android emulators:

• Pizza Boy
• Lemuroid
• RetroArch with the mGBA core citeturn141798view0

The developers also give an unusually strong warning:

My Boy is outdated and will not work correctly with Heart & Soul 2.x. citeturn141798view0

For Android, I would start with:

Pizza Boy

or:

RetroArch with the mGBA core

To play:

1. Patch Heart & Soul using your clean Emerald ROM.
2. Save the resulting .gba file on your phone.
3. Install Pizza Boy, Lemuroid, or RetroArch.
4. If using RetroArch, select the mGBA core.
5. Browse to your Heart & Soul .gba.
6. Open the game.

Avoid My Boy for Heart & Soul 2.x

This is worth emphasizing.

My Boy is normally popular for Pokémon ROM hacks, but the Heart & Soul developers specifically state that it is outdated and will not work for the current release. citeturn141798view0

If Heart & Soul crashes or behaves incorrectly in My Boy, do not repatch the ROM first.

Change emulators.

How to Play Pokémon Heart & Soul on iPhone or iPad

The Heart & Soul developers currently recommend:

• Delta
• RetroArch with the mGBA core
• Ignited

for iPhone and iPad. citeturn141798view0

To play:

1. Patch Heart & Soul using Rom Patcher JS.
2. Save the finished .gba file.
3. Transfer or save the ROM into the Files app.
4. Open Delta, RetroArch, or Ignited.
5. Import Heart & Soul.
6. Launch the game.

If using RetroArch, choose the mGBA core.

Delta is specifically listed as compatible by the developers for the current 2.x release. citeturn141798view0

Best Emulator Settings for Pokémon Heart & Soul

Heart & Soul generally does not require a complicated emulator configuration.

The biggest concern is using an emulator supported by the project.

Platform	Recommended Emulator
Windows	mGBA
macOS	mGBA
Android	Pizza Boy, Lemuroid, or RetroArch + mGBA
iPhone/iPad	Delta, RetroArch + mGBA, or Ignited
Linux handheld	RetroArch + mGBA
My Boy	Not recommended / incompatible

These recommendations come directly from the v2.0.4 release instructions. citeturn141798view0

Save Type

Leave save detection on:

Automatic/default

Modern GBA emulators such as mGBA should handle the required save format automatically.

RTC and Time

Heart & Soul includes day and night mechanics and time-based encounters, so keep normal time functionality enabled in your emulator.

Version 2.0.4 also adjusted the game’s time-of-day ranges, including setting night to begin at 7 PM. citeturn141798view0

Fast-Forward

Fast-forward is generally fine for:

• Grinding
• Travel
• Egg hatching
• Repeated trainer battles

If a complicated scripted event behaves strangely, retry it at normal speed.

In-Game Saves

Use the game’s normal save function regularly.

Do not rely exclusively on save states, especially when updating the ROM.

How to Update Pokémon Heart & Soul Without Losing Your Save

Heart & Soul has an important dividing line:

Heart & Soul 1.x saves cannot be used with Heart & Soul 2.x.

The official repository explicitly warns that saves created before 2.0 are not compatible moving forward. citeturn547400search5

Updating From Heart & Soul 1.x to 2.x

You need to start a new save.

That includes saves from releases such as:

• v1.0
• v1.1
• v1.2
• v1.2.1

Heart & Soul 2.0 was rebuilt on pokeemerald-expansion, meaning the underlying game systems and save structure changed substantially. citeturn547400search5

You can keep your old 1.x ROM and save backed up if you want to return to them later, but do not import that save into 2.0.4.

Updating Between Heart & Soul 2.x Versions

If you are already playing Heart & Soul 2.0.x, the normal process is much easier.

Before updating:

1. Make a normal in-game save.
2. Close your emulator.
3. Back up your .sav file.
4. Back up your old .gba file.
5. Download the newest official Heart & Soul patch.
6. Patch a fresh clean Pokémon Emerald ROM.
7. Give the new ROM the same filename as the old ROM, or rename the save to match.
8. Put the new ROM and existing save in the emulator’s proper directory.
9. Launch the updated ROM.
10. Confirm your save loads before deleting your backups.

The current 2.0.4 documentation states that 2.0.0 saves can continue into the current 2.0.x release, while pre-2.0 saves cannot. citeturn547400search0

Make the ROM and Save Names Match

For many emulators:

Pokemon Heart and Soul.gba

should use:

Pokemon Heart and Soul.sav

If your new ROM is named:

Heart and Soul v2.0.4.gba

but your save is:

Heart and Soul v2.0.2.sav

your emulator may treat the new ROM as a completely different game.

Rename one of the files so their names match before the extension.

Common Pokémon Heart & Soul Installation Problems

The Patch Won’t Apply

First confirm that your base ROM is:

Pokémon Emerald Version (U)

The expected SHA-1 is:

f3ae088181bf583e55daf962a92bb46f4f1d07b7 citeturn545051view0

If the patcher rejects your ROM, common causes include:

• Wrong Pokémon Emerald region
• Wrong ROM revision
• Previously modified ROM
• Another Emerald ROM hack
• Old Heart & Soul ROM
• Corrupted ROM backup

Start again with a clean compatible Emerald ROM.

I Downloaded the GitHub ZIP but Can’t Find the Game

You probably downloaded the source code rather than the release patch.

Go to the official:

Releases

section and open the latest Heart & Soul Release 2.0.4 page. citeturn141798view0

Then download the patch from its Assets area.

Ordinary players do not need to compile the GitHub source themselves.

The Game Opens as Regular Pokémon Emerald

You probably opened your clean base ROM instead of your patched ROM.

For example, your folder may contain:

Pokemon Emerald.gba

and:

Pokemon Heart and Soul v2.0.4.gba

Open the second file.

Heart & Soul Crashes on Android

If you are using My Boy, change emulators.

The developers explicitly warn that My Boy is outdated and will not work properly with the current release. citeturn141798view0

Try:

• Pizza Boy
• Lemuroid
• RetroArch with mGBA

My Heart & Soul 1.2 Save Doesn’t Work in 2.0.4

That is expected.

Heart & Soul 2.0 was rebuilt using pokeemerald-expansion, and the official project specifically states:

Pre-2.0 saves are not compatible. citeturn547400search5

You need to start a new game.

My 2.0.x Save Isn’t Showing Up

Check the filenames.

For example:

Heart and Soul.gba

and:

Heart and Soul.sav

should match.

Also check your emulator’s save directory. Some emulators store .sav files in a dedicated folder rather than next to the ROM.

My Save State Doesn’t Work After Updating

Use your normal in-game save instead.

A save state contains a snapshot of the exact previous ROM and emulator memory state. After changing the ROM version, that state may no longer be compatible.

Use the game’s normal .sav file when moving between versions.

I Can’t Trade With an Official Pokémon Emerald Game

That is expected with Heart & Soul 2.x.

The official project states that Heart & Soul 2.0’s multiplayer is not compatible with official Pokémon games, Heart & Soul 1.x, Modern Emerald, or unrelated pokeemerald-expansion hacks. citeturn798578view0

Heart & Soul 2.x does support trading and link battles with another compatible Heart & Soul 2.x game. citeturn141798view0

The Game Corner Freezes

Make sure you are using the newest version.

The Heart & Soul developers specifically fixed a Game Corner crash in the 2.0.2 update. citeturn141798view0

If you are still playing v2.0.0 or v2.0.1, update to v2.0.4.

I Get a Blue Screen in Sinjoh

Update to v2.0.4.

The official v2.0.4 patch notes specifically list a fix for a blue-screen issue in the Sinjoh Lab. citeturn141798view0

Heart & Soul Still Has Bugs After I Patched Correctly

First make sure you are using:

v2.0.4

and one of the supported emulators.

The current release includes fixes for numerous issues involving rematches, Nuzlocke rules, the GS Ball, the Battle Tent, BP shops, Goldenrod Underground, randomizers, animations, collisions, and other systems. citeturn141798view0

If the issue remains while using mGBA or another officially recommended emulator, check the official documentation or Heart & Soul Discord.

How to Verify Pokémon Heart & Soul Installed Correctly

Heart & Soul is very easy to distinguish from ordinary Pokémon Emerald.

The game should take you into a Johto adventure, not vanilla Hoenn.

Heart & Soul 2.0 includes major systems such as:

• Johto’s main story
• Kanto postgame
• Following Pokémon
• Day and night encounters
• Pokégear
• Radio stations
• Trainer rematches
• Voltorb Flip
• 92 HGSS-style TMs
• Modern abilities
• Gen 7 learnset option
• Randomizer settings
• Nuzlocke settings
• Challenge modes
• Link trading and battling
• Expanded postgame content
• Battle Frontier content citeturn141798view0turn547400search5

If you start in Littleroot Town and everything looks exactly like vanilla Pokémon Emerald, you opened your base ROM instead of Heart & Soul.

For the current installation, verify that you are running:

Pokémon Heart & Soul v2.0.4

The official documentation currently identifies itself as documentation for version 2.0.4. citeturn547400search3

Pokémon Heart & Soul Installation FAQ

What is the latest version of Pokémon Heart & Soul?

As of September 2026, the latest official release is:

Pokémon Heart & Soul v2.0.4

The official GitHub releases/latest page currently directs to the v2.0.4 release. citeturn141798view0

Is Pokémon Heart & Soul complete?

Yes.

The developers describe Heart & Soul as a fully completed and playtested Johto ROM hack. citeturn547400search5

It includes Johto’s main story and a Kanto postgame along with significant extra content.

Is Heart & Soul based on Pokémon HeartGold and SoulSilver?

Story-wise, it pulls heavily from GSC and HGSS.

Technically, however, it is a Pokémon Emerald GBA hack.

Heart & Soul 2.x is built on Pokémon Emerald through pokeemerald and pokeemerald-expansion. citeturn547400search5

What Pokémon Emerald ROM does Heart & Soul use?

Use a clean:

Pokémon Emerald Version (U)

with SHA-1:

f3ae088181bf583e55daf962a92bb46f4f1d07b7 citeturn545051view0

What patch format does Heart & Soul use?

Heart & Soul 2.0 uses a:

UPS patch

The official release directs players to use Rom Patcher JS. citeturn141798view0

What is the best emulator for Pokémon Heart & Soul?

For Windows and Mac:

mGBA

For Android:

Pizza Boy, Lemuroid, or RetroArch with mGBA

For iPhone/iPad:

Delta, RetroArch with mGBA, or Ignited

These are the project’s official recommendations for the current release. citeturn141798view0

Does Heart & Soul work with My Boy?

The developers say no for the current 2.x version.

Their release page explicitly warns that My Boy is outdated and will not work correctly. citeturn141798view0

Can I play Pokémon Heart & Soul on Android?

Yes.

Use Pizza Boy, Lemuroid, or RetroArch with the mGBA core.

Can I play Pokémon Heart & Soul on iPhone?

Yes.

The developers list Delta, RetroArch with mGBA, and Ignited as supported iOS options. citeturn141798view0

Can I use my Heart & Soul 1.x save in 2.0.4?

No.

The developers explicitly state that saves from before 2.0 are not compatible with Heart & Soul 2.x. citeturn547400search5

You must start a new game.

Can I update from Heart & Soul 2.0 to 2.0.4 without restarting?

Yes.

Current 2.0.x save files can continue into v2.0.4. Back up your save, patch a fresh Emerald ROM, and make sure the .gba and .sav filenames match. citeturn547400search0

Can Heart & Soul trade with other games?

Heart & Soul 2.x supports link trading and battles with compatible Heart & Soul games.

It is not compatible with official Pokémon games, Heart & Soul 1.x, Modern Emerald, or unrelated pokeemerald-expansion projects. citeturn798578view0

Where can I download Pokémon Heart & Soul?

Use the official Heart & Soul GitHub release.

Download the official Heart & Soul patch

Download the patch, not an unofficial pre-patched Pokémon Emerald ROM.

You provide your own legally obtained Pokémon Emerald Version (U) ROM and apply the Heart & Soul patch yourself.

Rom Professor does not host, distribute, or link to copyrighted Pokémon ROM files or unofficial pre-patched ROMs.