Balatro Mod Manager is a standalone tool designed for managing mods in Balatro, simplifying the process of discovering, downloading, and installing mods for the game. Built with Rust and Svelte, it offers a seamless experience across Windows and macOS platforms.
Key Features:
Mod Management Simplified: Easily browse, download, and install mods directly through the interface.
Cross-Platform Support: Available on both Windows and macOS with standalone installers that require no external dependencies.
Security Assurance: Releases are code-signed using SignPath to ensure authenticity and protect against tampering.
Command-Line Automation: Automate installation via PowerShell or Bash scripts for quick setup.
Open Source Transparency: Built with transparency, the tool allows users to compile it from source.
Audience & Benefit: Ideal for gamers and modders seeking a secure, efficient way to enhance their Balatro experience. It saves time by streamlining mod management and ensures peace of mind through verified security measures. The tool can be installed via winget for easy setup.
README
The Balatro Mod Manager by Skyline.
Balatro Mod Manager is a standalone tool made for Balatro that makes finding, downloading, and installing mods easy.
flatpak install --user balatro-mod-manager.flatpak
flatpak run io.balatro.ModManager
AppImage/Deb/RPM still land in target/release/bundle/ during the Flatpak build if you need them.
Alternatively, if you would prefer to build Balatro Mod Manager yourself instead of downloading the prebuilt installer, Balatro Mod Manager can be compiled from source using the instructions below.
The script now prefers the latest GitHub Release Flatpak if available, and falls back to a local build if not.
Launch after install:
flatpak run io.balatro.ModManager
Linux builds use Flatpak, so you’ll need flatpak and flatpak-builder installed.
On Linux the manager currently supports the Steam version of Balatro only.
Manual Installation
Clone the repository & install bun's dependencies:
git clone https://github.com/skyline69/balatro-mod-manager.git
cd balatro-mod-manager && bun install --allow-scripts
Run the task based on your OS
For Windows:
task release-windows
For macOS:
task release-macos
For Linux:
task release-linux
Running the Project
Development Mode
To start the project in development mode, use the provided taskfile:
Run the debug target:
task debug
> Linux/Wayland: on Wayland sessions the app now prefers X11 (XWayland) to avoid compositor protocol errors. Set BMM_ALLOW_WAYLAND=1 before running if you want to keep native Wayland.
Production Mode
To build the project for production:
Build the release target (release-windows for Windows, release-macos for macOS):
task release-windows # or task release-macos
The built application will be located in the src-tauri/target/release directory and the installer paths will be shown at the end of the build process.
Cleaning the Build
To clean the build files, use the provided taskfile:
Run the clean target:
task clean
> Font by Daniel Linssen
Contributing
Would like to contribute by adding a mod that you couldn't find on the manager?
Feel free to check the Balatro Mod Index repo and look at the README to know how to process.
Code Signing
Balatro Mod Manager releases are code-signed using SignPath to ensure authenticity and security. This helps verify that the downloaded software hasn't been tampered with and comes from a trusted source.
