If the download links on this page are missing, please download the SDK from https://www.renpy.org/dl/5.6.2/. Or click here to download the latest version of Ren'Py.

Ren'Py 5.6.2 "New World Order"

Ren'Py 5.6.2 "New World Order" was released on October 5, 2006. The main distributions are:

Each of these files contains the full Ren'Py development environment, which is enough to allow you to develop Ren'Py games on Windows 98+, Mac OS X 10.3+, and Linux x86. The development environment contains the files needed to produce games for all three platforms. It also includes a text editor and sample games.

For your convenience, we've posted the Release Announcement and Changelog. We've also made available the following programs, which can be used to run Windows-only Ren'Py games on non-Windows platforms:

Known Issues

The version of py4renpy included with 5.6.2 has problems when encountering a game with a space in its name. To fix this, drop python into the lib/ directory of Ren'Py, or the py4renpy-2.3.5-5.6.2 directory. This should be done before releasing a game for Linux.

Midi playing won't work on Intel versions of Mac OS X. Ren'Py will lock up when attempting to play a midi. We strongly recommend not using midi music with Ren'Py. This affects the current version of the demo. When using the demo on OS X, it's important to drop the volume to 0 before starting the game.

Release Announcement

I'm pleased to announce the release of Ren'Py 5.6.2 "New World Order". This release brings with it the new Launcher program, a tool that assists in developing Ren'Py games by automating many common tasks. It lets you create new games, edit games, check the games, and release standalone distributions for all 3 supported platforms. On Windows and Linux, we include the SciTE text editor, which should improve the Ren'Py editing experience. This release includes a number of minor bug fixes.

Downloads and a full release announcement can be found at:


Migrating your game from Ren'Py 5.6.1 or earlier requires you to do the following steps:

  1. Run Ren'Py, which should start the new launcher.
  2. Create a new project, entering the name of your game as a project.
  3. Replace the contents of the project's game directory with the contents of your existing game directory.
  4. Edit your game script, and remove the line that sets library.script_version. Ren'Py now takes care of setting this for you.

If you do not want to use the launcher, you can copy a game/ directory into renpy-5.6.2/ directory. Ren'Py will run your game rather then the launcher.

The documentation of Ren'Py is in the process of being migrated to the new wiki. For updated documentation, please visit http://www.renpy.org/wiki/renpy/doc/reference/Reference%20Manual . For legacy documentation, please read http://www.renpy.org/dl/5.6.1/reference.html

CHANGELOG for Ren'Py 5.6.2

The Ren'Py distribution has been reorganized, and now includes a launcher program that lets one edit Ren'Py programs, and perform common tasks with them. It also includes the SciTE text editor.

The rules for searching for the base directory have changed slightly. The base directory may now be given as the first positional argument on the command line. If that doesn't work, it defaults to the directory containing the program used to launch Ren'Py.

The game directory search has also changed. If a --game directory is given, then it is used relative to the current directory. (This is a change from the current behavior.) Othewise, all extensions are stripped from the program used to start Ren'Py. We first look for a directory with this name in the base directory. If it's not found, then we strip off everything before the first space or underscore, and try again. We repeat this until we find the game directory, or until we can't. We then try the "game" and "base" subdirectories of the base directory. If those don't exist, we use the base directory as the game directory.

We no longer change directory into the base directory. This means that screenshots are written into the current directory, rather then the base directory.

run_game.py has been renamed to renpy.py, and has been updated with two functions intended for customization by distributors. These functions control how Ren'Py looks for the common directory, and for save directories.

The function has been modified to accept arbitrary displayables, rather then just images.

Exported two new types of transitions. is a transition that shows the new image for a given number of seconds, while lets you combine multiple transitions into one.

Fixed a bug that made RLE images sometimes crash the system. Added a rle argument to Image and other image manipulators.

Fixed a bug that prevented the factory argument to from being accepted.

Fixed a bug that manifested itself in a crash when a clipped Displayable was placed at (x, y) where x <= 0 and y <= 0.

Fixed a focus bug that made it difficult to unhide windows.