Release Notes

Version 2.0.0

Released 2019-03-10

Lots of improvements in 2.0.0. Too many to list, but the two main improvements:

  • Using shaders for sprites, making drawing sprites incredibly fast.
  • Using ffmpeg for sound.

Version 1.3.7

Released 2018-10-28

  • Fix for Issue 275 where sprites can get blurry.

Version 1.3.6

Released 2018-10-10

  • Bux fix for spatial hashing
  • Implement commands for getting a pixel, and image from screen

Version 1.3.5

Released 08-23-2018

Bug fixes for spatial hashing and sound.

Version 1.3.4

Released 28-May-2018

New Features

  • Issue 197: Add new set of color names that match CSS color names
  • Issue 203: Add on_update as alternative to update
  • Add ability to read .tmx files.

Bug Fixes

  • Issue 159: Fix array backed grid buffer example
  • Issue 177: Kind of fix issue with gi sound library
  • Issue 180: Fix up API docs with sound
  • Issue 198: Add start of isometric tile support
  • Issue 210: Fix bug in MacOS sound handling
  • Issue 213: Update code with gi streamer
  • Issue 214: Fix issue with missing images in animated sprites
  • Issue 216: Fix bug with venv
  • Issue 222: Fix get_window when using a Window class


  • Issue 217: Fix typo in doc string
  • Issue 198: Add example showing start of isometric tile support

Version 1.3.3

Released 2018-May-05

New Features

  • Issue 184: For sound, wav, mp3, and ogg should work on Linux and Windows. wav and mp3 should work on Mac.

Updated Examples

  • Add happy face drawing example

Version 1.3.2

Released 2018-Apr-20

New Features

  • Issue 189: Add spatial hashing for faster collision detection
  • Issue 191: Add function to get the distance between two sprites
  • Issue 192: Add function to get closest sprite in a list to another sprite
  • Issue 193: Improve decorator support

Updated Documentation

  • Link the class methods in the quick index to class method documentation
  • Add mountain midpoint displacement example
  • Improve CSS
  • Add “Two Worlds” example game

Updated Examples

  • Update to not use all_sprites_list
  • Update to add a warning about how to manage text on a scrolling screen
  • Issue 194: Fix for calculating distance traveled in scrolling examples

Version 1.3.1

Released 2018-Mar-31

New Features

  • Update create_rectangle code so that it uses color buffers to improve performance
  • Issue 185: Add support for repeating textures
  • Issue 186: Add support for repeating textures on Sprites
  • Issue 184: Improve sound support
  • Issue 180: Improve sound support
  • Work on improving sound support

Updated Documentation

  • Update quick-links on homepage of
  • Update Sprite class documentation
  • Update copyright date to 2018

Updated Examples

  • Update PyMunk example code to use keyboard constants rather than hard-coded values
  • New sample code showing how to avoid placing coins on walls when randomly placing them
  • Improve listing/organization of sample code
  • Work at improving sample code, specifically try to avoid using all_sprites_list
  • Add PyMunk platformer sample code
  • Unsuccessful work at getting TravisCI builds to work
  • Add new sample for using shape lists
  • Create sample code showing difference in speed when using ShapeLists.
  • Issue 182: Use explicit imports in sample PyMunk code
  • Improve sample code for using a graphic background
  • Improve collect coins example
  • New sample code for creating caves using cellular automata
  • New sample code for creating caves using Binary Space Partitioning
  • New sample code for explosions

Version 1.3.0

Released 2018-February-11.


Version 1.2.5

Released 2017-December-29.

Bug Fixes


Version 1.2.4

Released 2017-December-23.

Bug Fixes

Version 1.2.3

Released 2017-December-20.

Bug Fixes

  • Issue 44: Improve wildcard imports
  • Issue 150: “Shapes” example refers to chapter that does not exist
  • Issue 157: Different levels example documentation hook is messed up.
  • Issue 160: sprite_collect_coins example fails to run
  • Issue 163: Some examples aren’t loading images


  • Issue 84: Allow quick running via -m
  • Issue 149: Need better error message with check_for_collision
  • Issue 151: Need example showing how to go between rooms
  • Issue 152: Standardize name of main class in examples
  • Issue 154: Improve GitHub compatibility
  • Issue 155: Improve readme documentation
  • Issue 156: Clean up root folder
  • Issue 162: Add documentation with performance tips
  • Issue 164: Create option for a static sprite list where we don’t check to see if things moved.
  • Issue 165: Improve error message with physics engine

Version 1.2.2

Released 2017-December-02.

Bug Fixes

  • Issue 143: Error thrown when using scroll wheel
  • Issue 128: Fix infinite loop in physics engine
  • Issue 127: Fix bug around warning with Python 3.6 when imported
  • Issue 125: Fix bug when creating window on Linux


  • Issue 147: Fix bug building documentation where two image files where specified incorrectly
  • Issue 146: Add release notes to documentation
  • Issue 144: Add code to get window and viewport dimensions
  • Issue 139: Add documentation on what collision_radius is
  • Issue 131: Add example code on how to do full-screen games
  • Issue 113: Add example code showing enemy turning around when hitting a wall
  • Issue 67: Improved support and documentation for joystick/game controllers