This page is out of date

You've reached a page on the Ren'Py wiki. Due to massive spam, the wiki hasn't been updated in over 5 years, and much of the information here is very out of date. We've kept it because some of it is of historic interest, but all the information relevant to modern versions of Ren'Py has been moved elsewhere.

Some places to look are:

Please do not create new links to this page.

Why Ren'Py?

Ren'Py is a free and cross-platform engine that helps you make story-based games. These include:

  • Visual Novels, computer-based stories presented using words, pictures, sounds and music. Ren'Py's script language makes writing visual novels easy and efficient, allowing visual novels to be made without needing a dedicated programmer.
Starlight Ep. 0
Starlight Ep. 0
  • Simulation Games, such as dating and management sims, can be written using Ren'Py's support for embedded Python. Ren'Py takes care of details like persistence and efficient rendering, letting the programmer focus on the game's user interface and logic. The same Ren'Py script language that makes writing visual novels easy makes it easy to include story segments inside your simulation game.
Magical Boutique
Magical Boutique

Ren'Py can be extended using user-defined displayables to support a wide variety of gameplay. Ren'Py should be suitable for any 2D story-centric game.

Free and Free to Use

Summer Session - A commercial game made with Ren'Py. Ren'Py is free to use with commercial and non-commercial games. While Ren'Py and the libraries it depends on are all open source, they are licensed in ways that let you choose if your game will be open-source or closed-source. There is no need to pay a fee to us or anyone else* to distribute your Ren'Py game. Ren'Py has already been used with a half-dozen commercial games, and more are on the way.

See the Ren'Py license for more details.

Of course, if you make money off of a Ren'Py game and feel like supporting further development, a donation would be nice.

* Unless you use mpeg or mp3 support, in which case you're responsible for paying for the patent license. We don't recommend using these formats in commercial games.



One of Ren'Py's biggest advantages is that it is cross platform. There are three primary platforms we support:

The Ren'Py launcher makes it possible to build versions of Ren'Py games for all three platforms from any of these three platforms, making it possible to develop (for example) Mac and Linux versions on Windows.

Another advantage is that Ren'Py games are not dependent on any other software on these platforms. There's no need for your users to download runtimes, drivers, codecs, or anything like that. If a user has one of the supported platforms, Ren'Py will run.

Ren'Py can also be made to run on other platforms that support pygame, provided they have a reasonable amount of memory.

Script Language

Ren'Py uses a simple text-based script language to write games in. Here's a small excerpt from a game:

label family:
    scene bg beach2 
    with dissolve

    "It wasn't long before Mary broke the silence, by asking me a

    show mary dark smiling 
    with dissolve

    m "I told you a little about my family... but I haven't asked you
       about yours yet. What's your family like?"
    p  "When I'm on the island here, I live with my aunt and uncle, but back
       home, I live with my mother, father, and sister."

    m "A sister? Is she older or younger?"

Moonlight Walks 2.0 As you can see, this example, taken from a working Ren'Py script doesn't require much extra typing when compared just simply typing in the script for the game. It even lets you abbreviate character names, letting you write m instead of "Mary".

Ren'Py lets you define characters and images in a central place. This makes it easy to make changes, without having to change the entire game. Another benefit of using a script is consistency, as it makes it easy to ensure that the placement of text and images does not inadvertently change throughout the game.

Being text-based, the Ren'Py script language can work with whatever text editors or other tools you choose. While we include the jEdit text editor, there's nothing forcing you to use it if you have another editor you like better. Other third-party tools can check your game's spelling, or show you the differences between two versions of the game.

Some of the things you can do from the script language are:

Features by Default

Preferences Screen Ren'Py includes, by default, all of the features a user expects from a visual novel game. While most of these features can be turned off if desired, by default each new game has:

Customization and Localization

Katawa Shoujo (NVL-mode) TFQ (Imagemap Preferences) There are many ways a game-maker can customize Ren'Py. A few of them are:

Ren'Py games have been made in or translated to the following languages:

  • Brazilian Portuguese
  • Czech
  • English
  • French
  • German
  • Italian
  • Indonesian
  • Japanese
  • Russian
  • Spanish

With proper fonts, Ren'Py should support any left-to-right language that does not require ligatures.

File Types

Ren'Py Launcher, jEdit, and Demo Game Ren'Py can display the following image formats:

Ren'Py can play the following audio formats:

Ren'Py can play the following movie formats:

Ren'Py supports TrueType fonts, and a variety of image-based font formats. Ren'Py can archive files into its own archive file format, RPA. This protects files from casual access.

* These formats may be patented, and so may not be suitable for use in commercial games.


More than games have been released with Ren'Py.

This means that there are now a large number of people with Ren'Py experience, many of whom are willing to support new users. The best place to go for support is the Ren'Py forum at the Lemma Soft Forums, which has more than posts in threads. (Figures accurate as of {{#time: F d, Y | }}.)

Getting Started

Hopefully, this has convinced you to use Ren'Py to make your next story-based game. Once you've downloaded Ren'Py, the best place to get started is with the Quickstart Manual.

We can't wait to see what you do with it!