Phase Distorter
Phase Distorter is a native PC port of EarthBound and Mother 2 for Windows and Linux that supports widescreen and controller input.
- Type: PC port
- Game: EarthBound
- Runs on Windows, Linux and macOS
- By TheRunaway5
- Latest release 0.5, 2026-10-19
- Source: https://github.com/TheRunaway5/Phase-Distorter
README
Phase Distorter
An EarthBound / Mother 2 PC port, written in C++20.
Phase Distorter brings EarthBound (US, English) and Mother 2 (Japanese) to a native desktop application for Linux, Windows, and MacOS. It includes keyboard and controller input, audio, persistent saves, a Settings window, and widescreen presentation with offscreen actor preloading.
Version 0.5 is a development release. The default gameplay path runs each
game's compiled program. An experimental --native-session N route continues
a battery-save slot using the native engine; full native integration remains
in progress. Both paths use assets imported from the player's own supported ROM.
ROMs and extracted gameplay asset packs are not included. You must supply your
own copy before playing. The launcher and window icons derive from the provided
Saturn artwork.
v0.5 patch notes · Screenshots · Installation · ROM setup · Controls · Building · Saves · Troubleshooting
Screenshots
Expanded scenery and original pixel art at 16:9, 21:9 and 32:9, with the optional CRT filter switched off and on. Each pair captures the same gameplay frame. Click an image to see it at full resolution and compare the crisp pixels with CRT softness, scanlines and the aperture grille.
Widescreen · 16:9
Threed's streets, signs and streetlights in a wider view.
| CRT off | CRT on |
|---|---|
![]() | ![]() |
Ultrawide · 21:9
Twoson's shops, riverside scenery and NPCs across an expanded town view.
| CRT off | CRT on |
|---|---|
![]() | ![]() |
Super ultrawide · 32:9
A sanctuary cave panorama, including the sparkling boss encounter marker.
CRT off
CRT on
Installation
Downloaded a release ZIP?
- Download the Windows, Linux, or universal macOS ZIP.
- Use Extract All or your archive manager to extract the entire application folder. Do not run the application from inside the ZIP. Keep its files together.
- On Windows, open
Phase Distorter.exeand keepSDL2.dllbeside it. On Linux, openPhase Distorterand keeplib/beside it. The supplied Linux build needs glibc 2.36 or newer and desktop OpenGL. On macOS 11 or newer, drag Phase Distorter.app to Applications. It includes Apple silicon and Intel code plus SDL2, and uses the macOS OpenGL framework. The app is ad-hoc signed, without Developer ID signing or notarization; the first launch may require Privacy & Security → Open Anyway. - If ROM setup appears, import your own supported EarthBound or Mother 2 ROM. A previous import in your external user-data directory can skip this step; no ROM or imported asset pack is included in the download.
- During play, use Settings (F1) → Assets to switch games or manage their default caches. Save in-game before switching. Fullscreen (F11) and the other display settings are available from the gameplay bar.
- Use the game's normal save mechanism and exit normally. Saves live outside
the extracted folder. Back up your
.srmfiles before updating, then extract the next release into a fresh folder; see save locations.
Platform archives are stored only in releases/:
| Package | Contents |
|---|---|
releases/Phase-Distorter-0.5-windows-x86_64.zip | Native Windows application, SDL2 runtime, optional shortcut setup, instructions and licenses |
releases/Phase-Distorter-0.5-linux-x86_64.zip | Native Linux application with private C++ support, SDL2 runtime, optional menu setup, instructions and licenses |
releases/Phase-Distorter-0.5-macos-universal.zip | Universal macOS app for Apple silicon and Intel with SDL2, instructions and licenses |
Each ZIP contains one fresh application folder:
Phase-Distorter-0.5-windows-x86_64/ or
Phase-Distorter-0.5-linux-x86_64/. Extract the entire ZIP and open the native
application inside that folder. These runnable packages
contain the required application files but no ROMs, imported gameplay asset
packs, saves, or source/build trees. Supply your own supported ROM on first
launch. Each ZIP includes README.txt, a file manifest and checksums;
releases/SHA256SUMS records the archive hashes, including retained older versions.
For the repository-style executable layout, download the
combined v0.5 launcher ZIP
and extract its versioned application folder.
It includes all three platforms, launch.sh / launch.bat, runtimes and shortcut
setup; macOS users open the included Phase Distorter.app. The canonical launchers/ folder also contains the v0.5 binaries.
Each v0.5 bundle includes VERSION and PATCH-NOTES.md.
Running from the source repository
Download this repository as a ZIP and extract it, or clone it if you also want
the full source snapshot. Keep the directory structure intact. The supplied
native applications live in launchers/linux/bin/eb_cpp and
launchers/windows/bin/eb_cpp.exe. Open the appropriate executable directly,
or use ./launch.sh on Linux or launch.bat on Windows; those scripts prefer a
local build when one exists. Windows keeps SDL2.dll in the same bin/ folder;
Linux libraries and their notices live in launchers/linux/lib/.
The root install-linux.sh and install-shortcuts.vbs scripts also support this
layout. The platform instructions and play commands below refer to an extracted
release ZIP, where the executable is named Phase Distorter or
Phase Distorter.exe. Source-build commands start from the repository folder
containing this README.
Windows (x86-64)
- Put the extracted folder somewhere convenient, such as
C:\Games\PhaseDistorter. - Double-click
Phase Distorter.exe. - Complete the ROM import described below.
Keep the supplied SDL2.dll beside Phase Distorter.exe in the top-level
folder. To select a game explicitly, use --game earthbound for English or
--game mother2 for Japanese; for example, from Command Prompt:
"Phase Distorter.exe" --game mother2
You can create a desktop shortcut directly to the executable. Optional
install-shortcuts.vbs setup can also be double-clicked to create Desktop
and Start Menu shortcuts with the Saturn icon; those shortcuts target the
native executable. Keep the project folder in place, or rerun setup after
moving it. The supplied Windows executable has been tested under Wine;
native Windows testing remains outstanding.
Linux (x86-64)
The supplied binary requires glibc 2.36 or newer, desktop OpenGL support,
and your system's desktop graphics/window/audio libraries. SDL2 2.32.10 is
supplied in lib/; keep that directory beside the executable. C++ support
is linked privately into the application, allowing graphics drivers to load
their own system runtime. Graphics drivers and glibc remain system components.
This baseline also covers glibc 2.37 hosts; physical Steam Deck acceptance
remains unverified. Use the Linux source build for older systems.
Open Phase Distorter directly from your file manager. If extraction removed
its executable permission, enable that permission in the file's properties or
run the following in a terminal:
chmod +x "Phase Distorter"
"./Phase Distorter"
Use --game earthbound for English or --game mother2 for Japanese, such as
"./Phase Distorter" --game mother2. Install the appropriate OpenGL graphics
driver and missing system desktop libraries through your distribution's package
manager if needed.
To add Phase Distorter with its Saturn icon to your application menu, run:
chmod +x install-linux.sh
./install-linux.sh
This optional setup installs a per-user menu entry that runs the native executable directly, with English/Japanese actions and the icon. It does not require administrator access. Keep the project folder in place or rerun the installer after moving it. Both platforms also use the icon on the game window and Windows embeds it in the executable.
The application remembers the last game selected. The supplied native executables run the release snapshot. Source builds are separate; run their executable or install the build as described below.
Optional developer launch scripts
The existing launch*.sh and launch*.bat files remain available as developer
shortcuts. They prefer a local executable in build/cpp/ when present, otherwise
they use the supplied platform package. The launch-earthbound and
launch-mother2 variants select English and Japanese respectively, while the
general variant restores the last selected game. Paths are relative to each
script, and command-line arguments are forwarded to the executable.
install-shortcuts.bat remains an optional command-line wrapper for Windows
shortcut setup. None of these scripts is required to play.
First launch and ROM setup
- Open
Phase Distorteron Linux orPhase Distorter.exeon Windows. - In the setup window, browse for your own ROM, drag it into the window, or enter its path.
- Select Import. Phase Distorter validates the file, extracts the required assets to your user-data directory, and starts the game.
Import each game separately to play both. The Japanese version uses Mother 2's original program, text, fonts, and assets. The two games have separate asset packs and saves. After a successful import, later launches use the local pack; the original ROM file is no longer needed at startup. Importing does not alter the ROM or executable.
Only these retail images are supported. Each is 3,145,728 bytes without a
copier header; a .smc image with an additional 512-byte header is also accepted.
Hashes below refer to the image without that header.
| Game | Language | SHA-256 |
|---|---|---|
| EarthBound (US) | English | a8fe2226728002786d68c27ddddf0b90a894db52e4dfe268fdf72a68cae5f02e |
| Mother 2 (Japan) | Japanese | 1f8cfd13177d86b0eb2c8adcf9e1a4f0ec8966fa1583072b65a1b1c0e7961a5d |
Modified ROMs, translation patches, prototypes, and other revisions are not supported by this release. ROM download links and game assets are not provided.
Import is also available from the command line. For example, on Linux:
"./Phase Distorter" --import-rom "/path/to/your/mother2.sfc" --import-only
"./Phase Distorter" --game mother2
Or from Windows Command Prompt:
start /wait "" "Phase Distorter.exe" --import-rom "C:\path\to\your\mother2.sfc" --import-only
"Phase Distorter.exe" --game mother2
The Windows import command uses start /wait so the GUI application finishes
importing before Command Prompt proceeds to the next command.
Use --assets "/path/to/game.ebpak" to choose a different asset-pack location
when importing or playing. An explicitly selected game must match the ROM or
pack supplied. Invalid imports leave an existing valid pack intact.
Controls and display
| Action | Keyboard | Controller position |
|---|---|---|
| Move | Arrow keys | D-pad / left stick |
| SNES B / A | Z / X | Bottom / right face button |
| SNES Y / X | A / S | Left / top face button |
| SNES L / R | Q / W | Left / right shoulder |
| Start / Select | Enter / Right Shift | Start / Back |
| Settings window | F1 | — |
| Fullscreen | F11 | — |
| Close Settings / quit | Escape | — |
Controller defaults follow button position. On the SNES Nintendo Switch Online
controller, A, B, X, Y, L, R, Select, Start and the D-pad match their SNES buttons.
Open Settings (F1) → Controller to see the connected controller and live
button inputs, remap any SNES button, adjust the left-stick deadzone, or restore
defaults. Changes apply immediately and are saved beside the display preferences
in a .controllers file; --no-config disables saving both sets of preferences.
Closing the window also exits the game. Once a game is loaded, the top bar offers
Settings (F1) and Fullscreen (F11). In windowed mode the picture fits below
the bar. In fullscreen the bar hides until the pointer reaches the top edge, then
overlays the picture without resizing it. Settings opens a floating window; while it is open, keyboard and
controller input is captured by the window and the game continues running. The
initial ROM import view appears before gameplay and does not show this bar.
In Settings' Display tab, enable widescreen and choose the original aspect, 4:3, 16:10, 16:9, 21:9, the window's aspect, or a custom ratio. Preferences persist between desktop sessions. The Diagnostics tab shows frame, CPU, sound, and timing information.
For Steam Deck's 1280×800 display, enable
Widescreen and select 16:10 (Steam Deck). To start in fullscreen with
this ratio, use --aspect 16:10 --fullscreen as the Steam launch options, or run:
"./Phase Distorter" --aspect 16:10 --fullscreen
The expanded game view fills the 16:10 screen. Fixed intro artwork keeps its authored aspect ratio, then returns to the selected view.
The optional Variable refresh rate (VRR) checkbox uses native-rate pacing
with vsync, capped below the monitor maximum. Enable VRR in your monitor and
graphics settings first; the checkbox controls application pacing. It defaults
to off and is saved between sessions. --vrr / --no-vrr override it.
Fixed-refresh 60/120/240 Hz displays use a stable 60 Hz cadence with matching
playback audio. Expensive overworld entity updates also receive extra CPU
capacity. Overworld sprite images use host-managed storage, with nearby NPC
and enemy artwork prepared for wide views. --original-timing restores the
original CPU budget, scene timing and sprite storage for comparisons.
See timing behavior and verification.
F1 → Debug provides infinite health and PSI/PP at 999/999, noclip, and an Enemies ignore you switch that prevents overworld pursuit and contact battles. Player does max damage uses the damage routine's 65,535 maximum for successful player attacks while preserving immunity and zero-damage rules. Story battles still work. The searchable teleport picker includes all 385 named map areas, including interiors, dungeons and endgame locations, plus every scripted warp and door landing: 1,472 choices in total. Select a destination and press Teleport now; the screen fades fully to black before loading the area, then fades back in. Check Ness, Paula, Jeff and Poo as desired and press Apply party; keep at least one playable member. Guest companions stay with the party. Teleports and party changes wait until free movement is available, so close dialogue or finish the current battle. These are debug actions and can affect saved progress; entering an area does not complete its story events. Cheat switches reset when restarting or switching games. See debug tool details.
F1 → Debug → Save state snapshots saves the current moment under a name. Select a snapshot to load it or delete it with confirmation; Refresh snapshots rereads the list. The list shows names, creation dates and frame numbers and survives restarts. Loading also restores its cheat switches. Snapshots are kept separately for EarthBound and Mother 2 and require matching game content.
Widescreen renders additional scenery while preserving the original game camera, movement and collision. NPC, enemy and prop artwork is prepared around the selected view independently of gameplay activation. Active actor graphics remain available past the original screen edges; gameplay keeps its original activation region and appearance conditions. PSI effects, including Rockin, fill the wider canvas while targeted effects stay aligned with their enemy. Battle backgrounds stay wide throughout the exit fade, and Lumine Hall's scrolling wall text adapts to the wider picture. Forest borders and the void around caves and rooms extend naturally without forcing the display camera away from the player. Short road tunnels, including those to Threed and Fourside, and the desert traffic strip retain camera boundaries; constrained areas narrower than the selected view use side borders. Command boxes, the carried-money counter and gameplay windows authored at the left inset follow the wider view's left edge, keeping their original size. Dialogue and the party HUD retain their authored positions in the centered native view.
Fixed intro artwork, including The War Against Giygas!, uses a centered 4:3 view instead of repeating into the margins. The selected wider view returns after that scene. Static and palette flashes retain the same card dimensions and receive temporal smoothing when the photosensitivity filter is enabled. The Mother 2 logo screen extends its background into the widescreen margins while keeping the original logo and copyright centered; the artwork itself is not stretched or repeated.
Pass command-line display options directly to the executable:
"./Phase Distorter" --game mother2 --debug --aspect 16:9
"./Phase Distorter" --aspect window
"./Phase Distorter" --no-config --no-widescreen
In Windows Command Prompt, use "Phase Distorter.exe" with the same options.
--help lists all options, including frame limits, screenshots, audio capture,
and deterministic input playback.
For a repeatable windowed input run, combine --input-script FILE with
--replay-only. Physical game buttons are then ignored while window controls
and Settings still work. --buttons MASK supplies the initial held state;
script entries replace it at their hardware-frame boundaries. Without
--replay-only, physical game buttons combine with scripted or held buttons.
Imported assets and switching games
Open Settings → Assets to see the default EarthBound and Mother 2 asset
caches. Clear cached assets asks for confirmation, then removes only that
game's default earthbound.ebpak or mother2.ebpak. The current game continues
using assets already loaded in memory. Your original ROM, battery saves,
preferences, custom asset-pack paths, and the other game's cache stay intact.
Only regular cache files are cleared; directories and symbolic links are
rejected. Selecting the cleared game with its default cache opens ROM setup
again.
Switch game also asks for confirmation and restarts into the chosen game. Use the game's normal save mechanism first. With normal save persistence enabled, the current battery RAM is written before restarting. The selected game loads its own default cache, or opens ROM setup if it has not been imported. Fullscreen and display preferences carry across the switch.
Intentional selection from this menu uses the chosen game's default cache even if the applic





