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.

Note: The Balatro Mod Manager is NOT compatible with the Xbox Gamepass version of Balatro

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: Flatpak (recommended), AUR, or Balatro.Mod.Manager_…_amd64.AppImage

Installing on macOS

The macOS build is signed ad-hoc (not notarized by Apple), so Gatekeeper blocks the first launch. After installing once, the app opens normally on every subsequent launch.

1. Mount the .dmg and drag Balatro Mod Manager into /Applications.

2. Try to open it. macOS will refuse with either "Apple cannot verify..." or "is damaged and can't be opened". Close the dialog.

3. Pick one of the following bypasses:

   Option A — System Settings (macOS 14 and newer, no Terminal):

   • Open System Settings → Privacy & Security.
   • Scroll to the Security section. You should see a line about Balatro Mod Manager being blocked, with an Open Anyway button. Click it and confirm.
   • If no button appears (macOS 15+ sometimes hides it for "damaged" bundles), use Option B.

   Option B — Terminal one-liner (works on every macOS version):

   xattr -dr com.apple.quarantine "/Applications/Balatro Mod Manager.app"
   

   Then double-click the app normally.

   Option C — Older macOS (13 and below): right-click the app → Open → confirm in the dialog.

Why this happens: shipping notarized builds requires an active Apple Developer Program membership ($99/year). The app is ad-hoc signed so it runs on Apple Silicon, but Apple's notarization service is what would silence Gatekeeper. The friction is one-time per install.

Arch Linux (AUR)

Install using your preferred AUR helper:

yay -S balatro-mod-manager-bin
# or
paru -S balatro-mod-manager-bin

Debian / Ubuntu

Download the .deb from the latest release and install:

sudo apt install ./Balatro.Mod.Manager_*_amd64.deb

Flatpak (Steam Deck/Linux)

You need flatpak-builder for this.

• Run from a local checkout:

  git clone https://github.com/skyline69/balatro-mod-manager.git
  cd balatro-mod-manager
  

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

  flatpak install org.gnome.Platform//50 org.gnome.Sdk//50 \
    org.freedesktop.Sdk.Extension.node20//25.08 \
    org.freedesktop.Sdk.Extension.rust-stable//25.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)
  • Arch Linux: sudo pacman -S go-task (package is named go-task to avoid conflicts)
  • Fedora: sudo dnf install go-task
  • Ubuntu/Debian: Install via the official script or Snap: sudo snap install task --classic
  • macOS: brew install go-task
  • Windows: choco install go-task or winget install Task.Task

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 (Flatpak)

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

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

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

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.