Balatro Save Transfer

This pared-down version of balatro-mobile-maker focuses solely on moving save files between your Steam install of Balatro (Windows) and the unofficial Android build (com.unofficial.balatro). No APK/IPA building or patching remains—just save syncing.

note: this is a mirror repo because I already have a fork of the BMM repo and it seemed more fit to have the other one be an actual fork since Balatro Save Transfer is more of a standalone tool.

Requirements

• Windows host with Balatro installed (Steam save folder is read from %AppData%\Balatro).
• Android device with USB debugging enabled and the Android build of Balatro installed.
• platform-tools (ADB). The tool can download and extract them automatically.

Usage

1. Run balatro-transfer-tool (add --verbose for extra logging).
2. Choose a direction:
   • Steam -> Android: push your PC saves onto the device.
   • Android -> Steam: pull device saves back to the PC (you can auto-backup the current PC saves first).
3. When prompted, approve USB debugging on the device.

Notes

• The tool cleans up downloaded platform tools if you choose that option at runtime.
• If a transfer fails, rerun with --verbose to see full ADB output.

Features

• Wi-Fi ADB support with endpoint caching, plus USB flow.
• Device picker to avoid the "more than one device/emulator" ADB error.
• Direct pull of Android saves via run-as/exec-out (no temp folders or permission issues).
• Optional Steam save backups stored in the Balatro save folder by datetime.
• --verbose flag for troubleshooting; the tool no longer prompts for verbose mode.

Original README.md, not really necessary but keeping it just in case

The goal of this project is to allow Balatro fans to play Balatro on their mobile devices. This project provides a NON-PIRACY avenue for players to do so, by converting their Steam copy of Balatro to a mobile app. Balatro Mobile Maker also supports automatically transferring your saves back and forth between your Steam copy of the game and your mobile device (save transfer features only officially available on Windows and Android, for now).

Mods are not officially supported, but they will probably work if you transfer your saves from a modded system.

Keep in mind that Balatro Mobile Maker is still in beta! Please report any bugs you encounter in the issues section. If you encounter bugs with the latest release, try the previous release.

Quick Start Guide

Please review the Notes section before you begin.

• Download or compile balatro-mobile-maker.
• Run balatro-mobile-maker.
• Follow the prompts to apply optional patches. If you're unsure, always select "Y".

For Android:

• Copy the resulting balatro.apk to your Android device, or allow the program to automatically install using USB Debugging.
• Optionally, allow the program to automatically transfer your saves from your Steam copy of Balatro using USB Debugging.

For iOS:

• Sideload balatro.ipa using AltStore
• Optionally, copy your saves to your iOS device.

Optional Patches

• FPS Cap — Caps FPS to a desired number (or to the device's native refresh rate—recommended for battery performance)
• Landscape Orientation — Locks the game to landscape orientation (recommended, since portrait orientation does not behave very well)
• High DPI — Enables High DPI graphics mode in Love (recommended for iOS)
• CRT Shader Disable — Disables the CRT Shader (recommended for Pixel and some other devices)

Notes

• This script assumes that Balatro.exe or Game.love is located in the default Steam directory. If it is not, simply copy your Balatro.exe or Game.love to the same folder as balatro-mobile-maker
• This script will automatically download 7-Zip

For Android:

• This script will automatically download OpenJDK
• This script will automatically download APK Tool
• This script will automatically download uber-apk-signer
• This script will automatically download love-11.5-android-embed.apk
• This script will automatically download Balatro-APK-Patch
• This script can automatically download Android Developer Bridge (optional)

For iOS:

• This script will automatically download Balatro-IPA-Base

Recognition (in no particular order)

• Every contributor
• Developers of uber-apk-signer
• Developers of LA-VE
• Developers of 7-Zip
• Developers of APKTool
• Developers of Balatro

License

• 7-Zip is licensed under the GNU LGPL license.
• This project uses APKTool
• This project uses uber-apk-signer
• This project uses LA-VE
• This project uses OpenJDK