The Balatro Mod Manager by Skyline.

Balatro Mod Manager is a standalone tool made for Balatro that makes finding, downloading, and installing mods easy.

Balatro Mod Manager is available for Windows, macOS, and Linux. The installer is standalone and does not require any external libraries.

Download the Balatro Mod Manager installer here.

Scroll down to find ▸Assets and download the right version of the installer for your system.

• Windows: Balatro.Mod.Manager_…_x64-setup.exe or Balatro.Mod.Manager_…_x64_en-US.msi
• macOS: Balatro.Mod.Manager_…_universal.dmg
• Linux: Balatro.Mod.Manager_…_amd64.AppImage (mark as executable if needed)

Flatpak (Steam Deck/Linux)

• Install runtimes once (GNOME 47 + toolchain extensions):

  flatpak install org.gnome.Platform//47 org.gnome.Sdk//47 \
    org.freedesktop.Sdk.Extension.node20//24.08 \
    org.freedesktop.Sdk.Extension.rust-stable//24.08

• Build + bundle from this repo:

  flatpak-builder --force-clean --repo=repo build-dir packaging/flatpak/io.balatro.ModManager.json
  flatpak build-bundle repo balatro-mod-manager.flatpak io.balatro.ModManager master

• Install/run (on the Deck or any Flatpak host):

  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.

Build Prerequisites

• Rust (for the backend)
• Bun (for the frontend)
• Tauri CLI
• Task (for running task commands)

Automatic Installation

For Windows

open Powershell & run this command:

iwr https://raw.githubusercontent.com/skyline69/balatro-mod-manager/main/scripts/install.ps1 -useb | iex

For macOS

run this command:

curl -sL https://raw.githubusercontent.com/skyline69/balatro-mod-manager/main/scripts/install.sh | bash

For Linux

From a local checkout (respects your current branch/changes):

./scripts/linux-install.sh

If you want to install from the latest GitHub main without cloning manually, pass --clone:

curl -sL https://raw.githubusercontent.com/skyline69/balatro-mod-manager/main/scripts/linux-install.sh | bash -s -- --clone

Linux builds use a Podman container to ensure GTK/WebKit/SSL dependencies are present. Please install Podman before running the script. On Linux the manager currently supports the Steam version of Balatro only.

Manual Installation

1. 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

2. 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:

1. 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:

1. 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:

1. 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.