Par Infinite Minesweeper

About

Minesweeper is a logic puzzle game genre, usually played on personal computers, in which players clear a grid of tiles without detonating hidden mines. Par Infinite Minesweeper is a terminal (TUI) Minesweeper game in Python and Textual, played on an infinite board made of 8x8 sub-grids. It has local and online high scores, auto-saving, and a server mode that serves the game in a browser.

How it differs from the original

The board is infinite and split into sub-grids that unlock as neighbouring cells are uncovered, and the score is the total number of mines in solved sub-grids. The first click is always safe.

Getting started

Install it with uv as a tool from PyPI or GitHub (Python 3.11-3.13), then run pim; pim --server serves it in a browser on localhost. Left-click uncovers, F or right-click flags, and dragging pans the board.

Known issues & limitations

• platform: Internet leaderboard login and server mode require port 1999 on the host; if another pim process is mid-login or port 1999 is in use, the auth listener will fail.
• platform: Remote browser clients reaching the game through server mode cannot complete the OAuth flow for leaderboard login, as the callback targets the server's loopback interface.
• performance: Flood-fill for very large empty board regions can stall the frame due to iterative BFS with depth cap.

Status & roadmap

• Additional game modes are planned; the data model already supports them.

Additional notes

Leaderboard

The internet leaderboard needs a social login through a temporary listener on port 1999, and only a hashed email is stored on the server.