Pastebin launched a little side project called, check it out ;-)Pastebin is 300% more awesome when you are logged in. Sign Up, it's FREE!


By: m2e on Oct 2nd, 2012  |  syntax: None  |  size: 11.75 KB  |  hits: 42,600  |  expires: Never
download  |  raw  |  embed  |  report abuse  |  print
Text below is selected. Please press Ctrl+C to copy to your clipboard. (⌘+C on Mac)
  1. Katawa Shoujo Android port
  2. The latest version is v7, last updated on 23 January 2014
  4. I'm sorry for not making any updates or responding to emails in over a month.
  5. I just didn't have time work on this. It took me over an hour to reply to everyone now.
  6. I have sent v7 to a few people to test it and it seems to be working fine.
  8. In reply to anonymous emails signed: NotReallyDave
  9. >Also, if you wish to contact me through other means, maybe you've got *************?
  10. I do but I'm not going to write it down here for obvious reasons.
  11. Feel free to email me yours but I don't think that's necessary.
  13. >Still, my mission has not been accomplished yet. It didn't actually convert existing saves.
  14. You did run KS, right? Did you check the location mentioned in the updated FAQ answer regarding saves?
  16. >it did not start on Xperia SP on Android 4.1.2 (hangs after loading splash image, as you said)
  17. Try v7.
  19. >This device also has funny way of storing your app data, because I need to put obb file in limited internal storage (what is 5GB nowadays...).
  20. I don't really understand this. You mean that its external storage directory doesn't reside on an external removable device (such as an sdcard) but on device's internal memory? That's normal.
  22. Instructions:
  23. - Download the Android package (.apk) and expansion data file (.obb) from the links in the Downloads section
  24. - Copy both files to your phone using a usb cable, bluetooth, etc. or just download them straight to your phone.
  25. - Install the apk using any Android file manager.
  26. (If the installation fails, make sure "Unknown sources" is checked in your device's security settings)
  27. - Copy the obb file to /Android/obb/vn.katawashoujo/ on your external storage device,
  28.   usually an SD Card. Create the folders if they don't exists. Delete obb files from previous versions.
  29. (If you don't copy the obb file or if you copy it to the wrong location you will be greeted with the message
  30. saying "Download failed because the resources could not be found" when you launch KS)
  31. - That's it, launch KS
  33. (For earlier versions only monolithic apks are available, there is no obb file)
  36. Downloads: (Last update: 23 January 2014)
  37. Latest version: (apk)
  38.        (obb)
  40. Older versions: (Dev-Host
  41.        (Dev-Host
  44.        (Dev-Host
  45.        (Dev-Host
  47.        (Dev-Host)
  48.                   Here's a one-piece version (334MB in a single apk) for those who had problems
  49.                   with the obb expansion file.
  52.        (Dev-Host)
  53.        (Dev-Host, use only if your device has less
  54.                                                         than 512MB of RAM and/or Katawa Shoujo is
  55.                                                         randomly force-closing.)
  57.        (Dev-Host)
  59.        (Dev-Host, no waiting, captchas and similar annoyances,
  60.                                               why didn't I know about it before?)
  61.        (Multiupload, multi-annoyances)
  63.        (Dropbox)
  65. You will maybe lose your progress when you update.
  66. If you are unable to save your game after updating you will have to clear the app's
  67. data from the settings menu. (this only happened in old versions)
  69. Differences from the PC version:
  70. What works:
  71.  - The text and the script
  72.  - Backgrounds and characters
  73.  - Particles (e.g. snow)
  74.  - Sound effects
  75.  - Music
  76.  - Saving and loading
  77.  - Transitions (as of 12 June 2013)
  78.  - Videos between acts (as of 18 December 2013)
  79. What doesn't:
  80.  - Everything works (Fuck yeah!)
  82. Changelog and bugs:
  84. Here "crash" actually means "exception screen with an ignore button".
  86. v7 - known bugs:
  87.      - The note window, see below
  88.      - The ending credits don't work, will be fixed in the next version
  89.    - fixes:
  90.      - Fixed the black screen issue with v6 on some devices.
  91.    - changes:
  92.      - Added a link to this pastebin on the splash screen due to an increasing number
  93.        of reuploads which do not link here.
  95. v6 - known bugs:
  96.      - KS hangs on a black screen on some devices after the loading screen
  97.        I am investigating the issue and will make an update as soon as possible
  98.      - The note window, see below
  99.    - fixes:
  100.      - All videos now work e.g. route introductions, passing of time sequences etc.
  101.    - changes:
  102.      - Now includes all the content from Katawa Shoujo 1.1
  103.      - The game now uses /Android/data/vn.katawashoujo/files/saves on your external storage
  104.        as the save location.
  105.      - The save states are NOT compatible with the PC version. The persistance file is.
  106.        The persistance file is what holds your progress info, completion percentage, library
  107.        and gallery unlock status.
  108.      - All your saves and the persistance data will be copied over to the new location the
  109.        next time you start KSv6 if you installed it over an older version.
  110.        If you try to load an incompatible save, it will crash the game.
  112. v5 - known bugs:
  113.      - The note window, it seems to actually be a problem in Ren'Py
  114.    - fixes:
  115.      - All transitions work now
  117.    A lot of bugs that I had to work around have been fixed in Ren'Py itself so this version is made
  118.    completely from scratch. Let me know if there are any bugs I missed.
  120. v4 - known bugs:
  121.      - The note window, see v2
  122.    - fixes:
  123.      - Fixed the crash that happened at the end of each route.
  124.        Seems like 4LS considered the fact that they might want to make a related project as some point
  125.        and used "multipersistent storage". Basically, it allows two different Ren'Py games to share
  126.        progress information.
  127.        From what I understand, it just notes which ends you have seen but no information is ever
  128.        read from the file.
  129.        Since Ren'Py for Android doesn't have multipersistent storage implemented yet I have just
  130.        removed it from the script.
  132. v3 - known bugs:
  133.      - The note window, see v2
  134.      - A crash possibly related to saving some information after finishing a route has been reported.
  135.        I am yet to look into it.
  136.    - fixes:
  137.      - Fix for the "JPEG loading error" that was occurring on some devices (awaiting feedback! -> FIXED)
  138.      - Fixed two bugs in Shizune's route related to the "[" character and double-speak.
  140. v2 - known bugs:
  141.      - The note window (e.g. the note from Hisao's mom and dad) doesn't show up if the background
  142.        is set to tile. Instead I've set it to stretch for the time being. The text doesn't strictly
  143.        follow the horizontal lines on the note anymore but it doesn't look bad.
  144.        This is also present in v1.
  145.        If anyone reading this has any experience with Ren'Py, let me know.
  146.      - Emi-knockdown and Shizune-Lilly-showdown scenes have been reported to cause an exception
  147.        (JPEG loading error) on Android 4.1.1 (clicking on "Ignore" skips a few lines but you can continue)
  148.        I haven't been able to reproduce the issue on my Android 4.0.4 device.
  149.    - fixes:
  150.      - Fixed the credits screen crash
  151.      - Hopefully fixed all crashes related to character transitions (if you encounter any, email me)
  153. v1 - known bugs:
  154.      - On a couple of points in the game you'll get an "An exception has occurred" screen with a bunch
  155.        of technical information. Just click on "Ignore" and you're good to go.
  156.      - The credits on the end will keep throwing exceptions and you can't really continue no matter how
  157.        many times you click on "Ignore"
  159. Feel free to send bug reports to:
  160. (and any kind of feedback really, I like to know that someone appreciates my work, just looking at the download statistics doesn't really cut it)
  161. When sending a crash report, please include the .txt files from /Android/data/vn.katawashoujo/files
  162. If possible, include the system log. You can access it with apps such at CatLog (root required for Android 4.1+)
  163. The log should be saved just moments after the crash happens.
  166. FAQ (Last change: 18 December 2013):
  168. Q: It hangs at the loading screen. What do I do?
  169. A: It will take a while to load, especially if it's an older phone, give it a minute or two.
  171. Q: It crashes at the loading screen! What is this shit?
  172. A: Are you using CyanogenMod? If so, there seems to be a bug in CM which causes an error. Try sending a bug report to CM devs.
  173. Someone made a bug report for it here:
  175. Q: Where are the save files located?
  176. A: v6+: /Android/data/vn.katawashoujo/files/saves on your external storage
  177.    v1-5: /data/data/vn.katawashoujo/files/saves but you can't access them without rooting your phone.
  179. Q: Can I use the save files from the PC version?
  180. A: You can't use the save files but you can use the persistance file. See the changelog for v6 for more info.
  181. Old answer: No, they are incompatible due to differences between the Ren'Py versions.
  182.    What you can do is tick "Skip unread text" in the options menu (something that a surprisingly large amount of people don't know about),
  183.    enter skip mode and just skip through everything you've already read.
  184.    KS on Android is using a much more recent version of Ren'Py so skip mode is a lot faster than on PC.
  185. Old answer 2: Save files from KS 1.1 on Linux and OSX might be compatible but I haven't tested that.
  187. Q: Are you from Indonesia?
  188. A: No. A link to this paste has appeared on what seems to be a popular Indonesian forum.
  189.    KSG threads on 4chan are the only place where I posted the link myself.
  191. Q: How can I contact you?
  192. A: Send an email to
  196. History...
  197. This was previously a paste containing a Python script that operated on the Windows version
  198. of Katawa Shoujo and compiled it into an Android package.
  199. It was designed to avoid the complications of the Creative Commons license which forbids
  200. distributing derivative works. However after I saw how many bugs were introduced by the
  201. incompatibility between the different versions of Ren'Py I decided to drop that idea and
  202. just upload compiled versions here.
  203. If anyone is interested in changes that are required, drop me a note here:
  204. For historical reasons the script is now available here:
  207. -In reply to an anonymous email from Dave U. Random <>
  208. Creating an app to export the save files would be impossible without giving the app root
  209. access because of how Android works. A user with root access can use any file manager
  210. to copy the files to another location. (See the FAQ for the location of save files)
  211. Another option would be to modify Ren'Py's saving mechanism to save the files to another
  212. location but I'd rather not go that far.
  213. Please notify me when you've read this.
  216. -In reply to an anonymous email from Anonymous <> signed: NotReallyDave
  217. I hope I have fulfilled your request with the change made to the latest version.
  219. What happened is that the latest Ren'Py uses external storage as the preferred
  220. location for save files unless there are already some in other locations.
  221. I have modified it to move the existing saves to the new location.
  223. >I'm sending it once more, in case it landed where it shouldn't
  224. I received a total of two emails from you. One probably did land where it shouldn't.
  226. >Also, Android video support? Awesome, are we missing anything else to enjoy it fully?
  227. No, it think that's it.