Dealing with Problems link


Dealing With Display Problems link

As of version 6.13, Ren'Py will take advantage of graphics acceleration hardware, if it's present and functional. Using hardware acceleration brings with it several advantages, such as allowing vertical-blank synchronization and scaling games to full-screen size while preserving aspect ratio.

By default, Ren'Py selects a renderer to use in the following order:

  1. OpenGL 2.0 or greater.
  2. DirectX 9, provided that all libraries are available.
  3. OpenGL 1.x.
  4. Software.

A small fraction of systems may experience problems when running hardware accelerated Ren'Py games. These problems are often due to buggy graphics drivers, and so your first step to fixing them should be to check for an update to your graphics card drivers.

If upgrading your video drivers does not fix the problem, you should consider switching video renderers, using the following steps.

  1. Hold down Shift while starting Ren'Py, or press Shift+G once Ren'Py has started.
  2. From the "Graphics Acceleration" menu that appears, choose the renderer to use.
  3. Choose "Quit", then restart Ren'Py.

We suggest trying OpenGL, DirectX, and Software, in that order.

Windows Encoding Problems link

Ren'Py will fail to start on Windows if it's placed in a directory with a full path that isn't representable in the current system language. For example, if Ren'Py is in the directory:


and the system is set to use the English language, Ren'Py will be unable to start. To fix this problem, start the control panel, select "Region and Language Options", "Advanced", and change the Language for non-Unicode programs.

OS X 10.9 Mavericks link

A bug in OS X 10.9 Mavericks prevents Ren'Py from starting when launched on a non-primary display. Until Apple fixes this bug, please launch Ren'Py from the the primary display.

64-Bit Linux Problems link

Ren'Py 6.14.x and 6.15.0-3 were compiled incorrectly, and will often fail to operate on 64-bit Linux computers. The best way to work around this is to download Ren'Py 6.15.4 or later, and use it to run the game:

/path/to/renpy-6.15.4/ /path/to/game-with-problems