Skip to main content

a 2D framework for games and multimedia

Project description

A framework for building 2D games, demos, and other graphical/interactive applications.
Draws using OpenGL, which is hardware accelerated.
It provides some conventions and classes to help you structure a “scene based application”.
A cocos2d application consists of several scenes, and a workflow connecting the different scenes.
It provides you with a “director” (a singleton) which handles that workflow between scenes.
Each scene is composed of an arbitrary number of layers;
layers take care of drawing to the screen (using the pyglet and OpenGL APIs), handling events and in general contain all of the game/application logic.

cocos2d simplifies the game development in these areas:

  • Defining a workflow for your game
  • Creating special effects in layers
  • Creating transitions between scenes
  • Managing sprites
  • Basic menus
  • and much more!



  • python 2.6, python 2.5 or python 2.4 with ctypes and elementtree
  • pyglet 1.1.4 or newer (
  • Linux, Windows or Mac OS/X


  • To execute some effects you will need a video card with the:
    GL_EXT_framebuffer_object extension.


Being a pure python package the usual options are available; you can look at the INSTALL file for details

Learning cocos2d

  • go to the online tuturials / documentation page:

    you will find:

    . the Programming Guide . the API Reference . some tutorial videos

    The tutorials are included in the source package or can be download from:

  • Lot of miniprograms that demostrates the available objects and posible actions. There are a great starting point while learning and experimenting with cocos: you find a sample with the object that interest you exercising the features that you need, read the code, run, modify and re-run to experiment.

    Also, handy to know what is available in cocos: run all the tests and by looking at the code you know what to look at in the docs.

    You can find them at the test directory in the source distribution. After unpacking, to run the tests you can do

    $ cd test $ python test_*.py

  • more complex sample programs

    You can find it in the samples directory in the source distribution, and the most complex in subdrectories there, including a presentation done with Cocos himself.

    After unpacking, to run the samples you can do

    $ cd samples $ python

Do you have any doubt ?

Did you find any bug ?

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date (5.0 MB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page