renpy/Other Platforms
From Ren'Py
Contents |
Other Platforms
Note that these instructions are very experimental, and should be considered a guide. We welcome improvements, and ask that you Contact Us to report success or failure in getting Ren'Py to work on platforms that are not officially supported.
The three platforms Ren'Py officially supports are Windows 98+, Mac OS X 10.3+, and Linux x86. On this page, we will discuss how to compile all of the Ren'Py dependences from source. This will allow one to rebuild Ren'Py on these platforms, or to get Ren'Py running on other platforms.
The first thing you'll want to do is to make sure that libsdl and Python support your platform. If they do not, it will be necessary to modify them to support your platform, something that is out of the scope of this document.
Cross-compilation is also outside the scope of this document.
Preparation
You'll need a reasonably Unix-alike build system. While most Linux and Unix systemd distribute the tools you'll need to build Ren'Py, for Mac and Windows you'll need to download some additional software.
For the Mac, this means installing Xcode, which includes GCC and the rest of the tools we need.
For Windows, we recommend Msys/Mingw, which can be downloaded from [1]. While it's probably possible to get this working with Cygwin, we recommend against it, as it would mean that your copy of Ren'Py would have to be covered by the GNU GPL, as would any software you distribute with it.
A version of Python needs to be installed before proceeding. If you do not have Python 2.3+ installed already, you'll want to download it from [2]. If necessary, build it according to the directions on that page, and install it.
Anyway, once you have Python installed in your development environment, you'll want to get a command line. (In Windows, this means the Msys command line.)
Building renpy-deps
You should then download renpy-deps (from the Download Ren'Py page), and uncompress it into a directory that is part of your build environment. Change into that directory.
You'll need to have python 2.3 installed on your system, and usable when you type "python". If it's not in your path already, you'll have to add it.
On Msys in Windows, this can be done for a default install of Python 2.3 by typing:
export PATH=/c/python23:$PATH
On Mac OS X, you'll need to be sure your Python has pyobjc installed. Download it from [3]
If you're interested on running on a G3, you'll need to disable altivec support. Do this by running the command:
export NOALTIVEC=true
Finally, you're ready to build. Run the command:
sh build.sh
This will take a long time, but will recompile all of Ren'Py's dependencies. When it's done, if it succeeds, it will create the file
that file, with a command like: <pre> . env.sh
Building the Ren'Py Module
Now, you'll want to build the Ren'Py modules. Change into the module directory of a Ren'Py install tree, and run:
python setup.py install_lib -d $PYTHONPATH
On Mingw32, you'll want to run:
python setup.py build --compiler=mingw32 install_lib -d $PYTHONPATH
This will compile and install the Ren'Py modules.
Running Ren'Py Games
When you want to run Ren'Py, you'll want to ensure python is in your PATH, and then source envs.sh. Then change into a directory with a
<pre> python run_game.py
This will run Ren'Py games using the dependencies you compiled.
