Better Minesweeper Docs
Getting Started

Installation

No installer needed. Just download, extract, and play.

Windows

  1. Download the latest release from itch.io or the Steam page.
  2. Extract the zip file to any folder.
  3. Run BetterMinesweeper.exe.

No installation or admin rights required. The game runs directly from wherever you extract it.

Linux

  1. Download and extract the Linux build.
  2. Make the launch script executable: chmod +x run_linux.sh
  3. Run ./run_linux.sh from a terminal.

Requires a desktop environment with display server access (X11 or Wayland). Qt dependencies are bundled with the application.

Where Your Data Is Stored

Your settings, hotkeys, stats, and replays are stored separately from the game files in your system's application data directory:

  • Windows: %APPDATA%\BetterMinesweeper\
  • Linux: ~/.config/BetterMinesweeper/

This means you can move, update, or reinstall the game without losing any of your personal data. Settings, replays, hotkey bindings, and all-time stats persist across versions automatically.

Updating

Replace the game folder (or just the exe) with the new version. Your settings and stats are stored in AppData and will be picked up automatically. The settings system handles migration from older versions.

First Launch

On first launch the game opens an Expert board (30×16, 99 mines) with the stats window visible. You can switch difficulty immediately using the keyboard shortcuts 1 (Beginner), 2 (Intermediate), or 3 (Expert), or through the Game menu.

Tip: Press Tab to open the Options dialog and configure gameplay, display, and input settings to your preference.