Skip to content



Readme Basic information about pygame: what it is, who is involved, and where to find it.

Install Steps needed to compile pygame on several platforms. Also help on finding and installing prebuilt binaries for your system.

File Path Function Arguments How pygame handles file system paths.

Pygame Logos The logos of Pygame in different resolutions.

LGPL License This is the license pygame is distributed under. It provides for pygame to be distributed with open source and commercial software. Generally, if pygame is not changed, it can be used with any type of program.


Introduction to Pygame An introduction to the basics of pygame. This is written for users of Python and appeared in volume two of the Py magazine.

Import and Initialize The beginning steps on importing and initializing pygame. The pygame package is made of several modules. Some modules are not included on all platforms.

How do I move an Image? A basic tutorial that covers the concepts behind 2D computer animation. Information about drawing and clearing objects to make them appear animated.

Chimp Tutorial, Line by Line The pygame examples include a simple program with an interactive fist and a chimpanzee. This was inspired by the annoying flash banner of the early 2000s. This tutorial examines every line of code used in the example.

Sprite Module Introduction Pygame includes a higher level sprite module to help organize games. The sprite module includes several classes that help manage details found in almost all games types. The Sprite classes are a bit more advanced than the regular pygame modules, and need more understanding to be properly used.

Surfarray Introduction Pygame used the NumPy python module to allow efficient per pixel effects on images. Using the surface arrays is an advanced feature that allows custom effects and filters. This also examines some of the simple effects from the pygame example,

Camera Module Introduction Pygame, as of 1.9, has a camera module that allows you to capture images, watch live streams, and do some basic computer vision. This tutorial covers those use cases.

Newbie Guide A list of thirteen helpful tips for people to get comfortable using pygame.

Making Games Tutorial A large tutorial that covers the bigger topics needed to create an entire game.

Display Modes Getting a display surface for the screen.

한국어 튜토리얼 (Korean Tutorial) 빨간블록 검은블록

Tutorial de Pygame - Ejemplo del Chimpancé, Línea Por Línea Los ejemplos de pygame incluyen un sencillo programa con un puño interactivo y un chimpancé. Está inspirado en el molesto banner de flash de principios de la década de 2000. Este tutorial examina cada línea de código utilizada en el ejemplo.


Index A list of all functions, classes, and methods in the pygame package.

pygame.BufferProxy An array protocol view of surface pixels

pygame.Color Color representation.

pygame.cursors Loading and compiling cursor images.

pygame.display Configure the display surface.

pygame.draw Drawing simple shapes like lines and ellipses to surfaces.

pygame.event Manage the incoming events from various input devices and the windowing platform.

pygame.examples Various programs demonstrating the use of individual pygame modules.

pygame.font Loading and rendering TrueType fonts.

pygame.freetype Enhanced pygame module for loading and rendering font faces.

pygame.gfxdraw Anti-aliasing draw functions.

pygame.image Loading, saving, and transferring of surfaces.

pygame.joystick Manage the joystick devices.

pygame.key Manage the keyboard device.

pygame.locals Pygame constants.

pygame.mixer Load and play sounds

pygame.mouse Manage the mouse device and display. Play streaming music tracks.

pygame Top level functions to manage pygame.

pygame.PixelArray Manipulate image pixel data.

pygame.Rect Flexible container for a rectangle.

pygame.scrap Native clipboard access.

pygame.sndarray Manipulate sound sample data.

pygame.sprite Higher level objects to represent game images.

pygame.Surface Objects for images and the screen.

pygame.surfarray Manipulate image pixel data.

pygame.tests Test pygame.

pygame.time Manage timing and framerate.

pygame.transform Resize and move images.

pygame C API The C api shared amongst pygame extension modules.

Search Page Search pygame documents by keyword.