Ren’Py Visual Novels on Android

What you need:

1. A Ren’Py game (let’s call it TEST for this tutorial)
2. unrpa
3. Python 2.7
4. Ren’Py for Android, preferably the latest version

How to install:

1 – Using Python 2.7 and unrpa, extract data.rpa from TEST’s “game” folder. the links given on how to do so. It may be named something else at times but just remember to extract the content from the .rpa file.

2 – Insert the extracted content back into the “game” folder, and delete the .rpa file from that folder.

3 – Install Ren’Py for Android on your preferred Android device of choice.

4 – There will be a “renpy” folder on your Android device, in the “sdcard” root folder. Transfer your “game” folder into the renpy folder so it looks like “renpy/TEST/game”.

5 – In the “TEST” folder, create a “android.txt” file. Then enter these details:


Enter the title and author details accordingly. Optionally, you can add in a png called “icon.png”. This will be shown when you’re selecting your game in the Ren’py for Android main screen.

6 – Now start up Ren’py for Android and you’re ready to play!


Games with keyboard functions wouldn’t work. Because Ren’Py for Android does NOT support keyboard fucntions yet.

Games with video files will crash when trying to access them. Video is not supported as well.

Loading some Ren’Py games will result in unexpected errors at times. If you’re familiar with Python scripting language though, you can try to fix them by yourself.

Last but not least, REMEMBER to rename “TEST” with the name of the visual novel you’re transferring to your Android device.


19 responses to “Ren’Py Visual Novels on Android

  1. Thank you for this info :3 I’m trying with Katawa Shoujo but it doesn’t work, it shows random pixels and crashes sometimes.

    • If you are familiar with how Ren’Py works, you will notice that KS uses an uncommon method of calling up media files. So these do lead to crashes sometimes. Also, they have video files included, which can’t run on Android Ren’Py yet.

  2. Hello!
    I’m from Kazakhstan, so I only learn English, so excuse for my mistakes!
    I unstall RenPy for Android, but… there are not “renpy” folder on my Tablet. I downloaded and unstalled RenPy one more time, but no result.
    What can I do? Help me, please.

  3. i already tried this method. i extracted data.rpa from katawa shoujo.
    but when i start renpy, there’s appear a message said that :

    “I’m sorry, but an uncaught exception occurred.

    While running game code:
    ScriptError: could not find label ‘start’.

    — Full Traceback ————————————————————

    Full traceback:
    File “/home/tom/ab/android-rebuild/private/renpy/”, line 261, in run
    File “/home/tom/ab/android-rebuild/private/renpy/”, line 1259, in execute
    File “/home/tom/ab/android-rebuild/private/renpy/”, line 485, in lookup
    ScriptError: could not find label ‘start’.”

    how to fix this ?

  4. I do know that is hardly a visual novel, but if anyone tried to run “Long live the Queen” by Hanako Games on Android and came upon the following error:

    While executing init code:
    File “game/glpatch.rpy”, line 1, in script
    File “game/glpatch.rpy”, line 5, in python
    ImportError: cannot import name gltexture

    — Full Traceback ————————————————————

    Full traceback:
    File “/home/tom/ab/android-rebuild/private/renpy/”, line 261, in run
    File “/home/tom/ab/android-rebuild/private/renpy/”, line 630, in execute
    File “/home/tom/ab/android-rebuild/private/renpy/”, line 978, in py_exec_bytecode
    File “game/glpatch.rpy”, line 5, in
    ImportError: cannot import name gltexture

    then it would be worthwhile to try to rename glpatch_6_12.rpyc as glpatch.rpyc – it has solved the problem for me. Tried for: Retail version; Steam version not tested.

    And grateful thanks to Sakamoto for brilliant guide and website – thank you very much!

  5. Hey Sakamoto.

    I’ve tried running Dandelion : Wishes Brought To You on my phone via Ren’Py Launcher and all I’ve got was :
    ” I’m sorry, but an uncaught exception occurred.

    While executing init code:
    File “game\init.rpy”, line 17, in script
    File “game\init.rpy”, line 24, in python
    ImportError: No module named rx_socket

    — Full Traceback ————————————————————

    Full traceback:
    File “/home/tom/ab/android-rebuild/private/renpy/”, line 261, in run
    File “/home/tom/ab/android-rebuild/private/renpy/”, line 630, in execute
    File “/home/tom/ab/android-rebuild/private/renpy/”, line 978, in py_exec_bytecode
    File “game\init.rpy”, line 24, in
    File “/home/tom/ab/android-rebuild/private/renpy/”, line 475, in load_module
    File “rpyxml/”, line 3, in
    ImportError: No module named rx_socket”

    I made sure all the files listed there were in the game folder and tried running it again. Nothing new happened. There are several rpa files in the game folder, should I extract all or just archive.rpa?

    The launcher seemd to work, as I tried launching Re:Alistair++ and it worked to some moment, where the game would crash. Launcher as well.

    Do you have any idea what could I be doing wrong here? I tried to google it and nothing particural happened. I’m at loss to what could be wrong.

    Please help ;-;


  6. Hello, I have really no Idea how to use Python or Unpra, and overall, this tutorial is too unclear and short for me. Probably I am just too dumb for this. Anyways, I am trying to run Press-Switch on Android, is there any other tutorial or way for me to play this Visual Novel on my Android Device? Please help me.

  7. So the Renpy for Android app can’t support video files…
    Will deleting those video files could solve the problem?
    I’m currently working on deIz and Katawa Shoujo to play them on android…

  8. I’ve been fiddling with Highway Blossoms, trying to get it to work on android. It starts off with a webm file, of course, so I can’t tell if anything I’m doing is even working. I’m thinking that if I could find the call to load the webm file, I could replace it with a PNG, but I’ve yet to find a single mention of a webm file within the *.rpy and *.rpyc files.

    I am beginning to wonder if many of these files are encrypted. Is there perhaps some workaround?

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s