Skip to main content

A game of maze.

Project description

A game of maze.

Idea of the game is to find a path through the maze to a location marked by 'X'.


Python 3.5 with curses. Developed and tested with Cygwin and Mac OS X.
Does not work with Python2 or Windows without Cygwin.


Install latest version: **pip install mazingame**.


You will start at some location in the bottom of the maze. 'X' is somewhere
nearer the top of the maze.
Move using cursor keys or 'w','a','s','d'.
Quit pressing 'q' or Ctrl-C.

When, or if, you reach 'X', the ending score is saved to SQLite database.
The default highscore file location is $HOME/.mazingame_highscores.sqlite.
Use environment variable MAZINGAME_HIGHSCORE_FILE to set another file.

Command line options include:
-f, --fullscreen Use terminal to show entire maze. But only if terminal size is larger than the maze.
--showpath Show shortest path. Remember: this is cheating.
--showmaze Show entire maze. Remember: this is cheating.
-hs, --highscores Show high scores.

And a few more.

Note: database in high score file may change from version to version, if you
get SQLite error when saving high scores, delete your high score file.


This hobby project was inspired by the book "Mazes for Programmers" by Jamis Buck

Python translations of the maze code is in mazepy-project (

See for some background about MazinGame.

Project details

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page