Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Curses library emulation for Python & Pygame
branch: master
Failed to load latest commit information.
docs Moving files around for pip release.
pygcurse Fixed putchars newline.
AUTHORS.txt More pip release set up.
CHANGES.txt More pip release set up.
LICENSE.txt More pip release set up. Correcting typos in manifest and setup file.
setup.cfg More pip release set up. .


Pygcurse (pronounced "pig curse") is a curses library emulator that runs on top of the Pygame framework. It provides an easy way to create text adventures, rougelikes, and console-style applications.

Unfortunately, the curses library that comes with the Python standard library does not work on Windows. The excellent Console module from effbot provides curses-like features, but it only runs on Windows and not Mac/Linux. By using Pygame, Pygcurse is able to run on all platforms.

Pygcurse provides several benefits over normal text-based stdio programs:

1) Color text and background.
2) The ability to move the cursor and print text anywhere in the console window.
3) The ability to make console apps that make use of the mouse.
4) The ability to have programs respond to individual key presses, instead of waiting for the user to type an entire string and press enter (as with input()/raw_input()).
5) Since the console window that Pygcurse uses is just a Pygame surface object, additional drawing and transformations can be applied to it. Multiple consoles can also be used in the same program.

Pygcurse requires Pygame to be installed. Pygame can be downloaded from

Pygcurse was developed by Al Sweigart (

The github repo contains several example programs.

Something went wrong with that request. Please try again.