Skip to main content

Simple python minesweeper game using pygame

Project description


A python minesweeper game using pygame


  • Python 3.6 or greater
  • pygame


pip3 install nachomines


git clone
cd nachomines
python3 install

Launching the game

The script installs the "nachomines" python module, a "nachomines" console script, and a .desktop file on linux machines.

To launch on Windows or Linux, run:

python3 -m nachomines

or if you cloned the repository, run:


On linux, an application by the name "NachoMines" should be found in the "Games" section of your application menu

Gameplay and Controls

  • Press <Esc> or <Q> to exit

Main Menu

  • The "Grid Subdivisions" drop-down menu selects the size of the game board
  • The "Mine Density" drop-down menu controls the chance in percentage of a square containing a mine.
  • The "Theme" drop-down menu decides if you want a light, dark, or nacho theme during gameplay.


Hover over the blocks using the cursor. Right-click to flag a block. Left-click to show an empty square and the empty squares near it.

Win by flagging all of the mines.


The success sound was a modified version of a sound by kagateni on


Uses the MIT License. See the LICENSE file for further detail.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nachomines-1.0.4.tar.gz (2.8 MB view hashes)

Uploaded source

Built Distribution

nachomines-1.0.4-py3-none-any.whl (2.8 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page