search

andrewbenington / OpenHome

Application for importing and transferring Pokémon between save files
https://andrewbenington.github.io/OpenHome/
GNU General Public License v3.0
20 stars 1 forks source link
electron emulation pokemon reactjs save-files

readme

OpenHome uses Electron, React, and Vite.

OpenHome

OpenHome is an open source, cross-platform tool for moving Pokémon between games losslessly, much like Pokémon Home on the Nintendo Switch. Unlike Pokémon Home, OpenHome also allows for moving Pokémon to past generations from future ones. When a Pokémon is moved into a save file, its data from other games is saved locally, so nothing is lost when transferring to past generations. For example, you can move your Kalos Champion Sceptile from Pokémon X to Pokémon Ruby, earn it the Artist Ribbon, and it will have both the Kalos Champion and Artist ribbons when moved back to Pokémon X.

Visit the GitHub Pages site for easy download links and more information.

Screenshots

Screenshot 2024-01-14 at 1 47 47 PM Screenshot 2024-01-14 at 1 23 54 PM Screenshot 2024-01-14 at 1 53 02 PM Screenshot 2024-01-14 at 1 53 55 PM Screenshot 2024-01-14 at 1 24 18 PM Screenshot 2024-01-14 at 1 24 39 PM Screenshot 2024-01-14 at 1 25 22 PM

Downloading and Installing

For quick access to downloads, visit the downloads page.

On Windows and macOS, you can also download an installer from that location, but the app will not be signed. Your operating system will give you warnings about running or even downloading the app. If you (understandably) have concerns about that, jump to the Building App Locally section.

macOS

On macOS visit the downloads page, and download the latest release using one of the buttons at the top of th page. If you don't know whether you have an Intel or an Apple Silicon Mac, go to  > About This Mac and check whether your Chip is Apple or Intel.

Follow the instructions to move the application to your Applications folder if you'd like. If you run the app by double clicking, it will give you a security error. To bypass this, do the following:

macOS Sequoia

macOS Sequoia makes it painstaking to run an app not signed with an Apple certificate (which requires an expensive yearly subscription). Assuming you installed the app in your root Applications folder, you can get around this by running the following in Terminal:

xattr -cr /Applications/OpenHome.app

After you do this you should be able to run the app as normal.

Older Versions of macOS

You will only get a security error if you try and open the app by double clicking. You can get around this if you ctrl + click the app, select "Open", and the click "Open" again. You should be able to open it by double clicking after you do this.

Windows

On Windows visit the downloads page and download the app using one of the buttons at the top of the page. Unless you're using a laptop with a Snapdragon chip, you will probably want to download the x86_64 version. The Universal download will work anywhere, but it is twice as big.

If you're using Edge, go to the Privacy settings and turn off Windows Defender SmartScreen. Once the file is downloaded, make sure to turn it back on.

Linux

You can download an rpm, deb, or AppImage file from the downloads page depending on your architecture and distribution.

Building App Locally

If you don't want to bypass your security restrictions to download the app, you can instead download the source code and build the app locally. Follow these instructions:

For Windows

For macOS

Moving Between Saves

This video is from an old version; The concept is the same but I'm too lazy to remake it.

Demo Video

The extra Champion Ribbon in Emerald, 0hp in Blue, and HeartGold/SoulSilver save misidentification are all bugs that have been fixed in the latest version.

Current Support

Development is ongoing. While OpenHome does its best to convert Pokemon between formats losslessly, there are sometimes mistakes. It's always a good idea to back up your save files. If you come across a bug, create an issue to bring it to my attention.

All PKM formats from Generations I-IX are currently supported, including from Pokémon Colosseum and Pokémon XD. All game save files from Generations I-VII are supported, except for Pokémon Lets Go Pikachu/Eevee and the Japanese versions of Pokémon Red/Green/Blue/Yellow. Support for Switch game save files will come at some point in the future.

Supported PKM import formats

Supported save file formats

Alterations to transferred Pokémon

When moving Pokémon to an older game, some compromises have to be made. OpenHome will try its best to preserve aspects of a Pokémon such as its nature, ability, gender, and shininess, all of which are usually possible minus some specific cases in the GameBoy games. These compromises will be reverted when moving back to a future game.

For example, a Pokémon originating in Generation VI being moved into a Generation III game will have its personality value altered to preserve its nature, ability (if possible), gender, and shininess.

A Pokémon transferred into Generation I or II will have it's Original Trainer's ID changed to a "tracking number" of sorts due to the lack of a Personality Value in those games.

Credits

This application would not have been possible without the research done at https://projectpokemon.org/, the work done by the PKHeX developers, and the sprites archived by https://pokemondb.net/ and https://www.bulbagarden.net/.