Pastebin launched a little side project called HostCabi.net, check it out ;-)Don't like ads? PRO users don't see any ads ;-)

Untitled4 sec ago
regLua | 6 sec ago
Untitled9 sec ago
Untitled17 sec ago
Untitled12 sec ago
Untitled13 sec ago
Untitled14 sec ago
Untitled14 sec ago

readme.txt

By: m2e on Oct 2nd, 2012 | syntax: None | size: 6.65 KB | hits: 564 | expires: Never

download | raw | embed | report abuse | print

Text below is selected. Please press Ctrl+C to copy to your clipboard. (⌘+C on Mac)

THIS IS NOW OUTDATED. CHECK THIS LINK FOR NEW VERSIONS http://pastebin.com/ZyRkVY5W
######################################################################################
KS2Android.py can be found at http://pastebin.com/ZyRkVY5W
---------------------------------------------------------------------------------------
Here's a compiled apk for lazy people: http://tiny.cc/KS-v1-Android
The above also includes a fix for crashes cased by some character animations.
For those who are computer savvy, it required a change in RenPy's compatibility module.
It replaces the MoveTransition function with OldMoveTransition which in turn causes
define.move_transitions to fail.
Regarding the license and derivative works, Katawa Shoujo itself remains unchanged.
The engine that runs KS was ported to Android and as such KS can run on it.
---------------------------------------------------------------------------------------
UPDATE: Send an email here if you need support [email protected] or to tell me you succeeded.
Report bugs and crashes, I will be updating the script as issues arise.
When additional support is added by Ren'Py developers, I will update it.
You might want to check this every now and then.
UPDATE2: 2 January 2013
- The script has been modified and a bit. I removed some cleanup steps so the script doesn't
delete the helper scripts and doesn't backup the game scripts before changing them.
However all of that doesn't really matter because you will be running the script in a COPY
of your Katawa Shoujo folder which you can later safely delete.
- Added instructions on how to set the SD card as the default installation location for
Android phones with less than required internal memory
These are instructions on how to port Katawa Shoujo to Android.
KS2Android does 92% of the work for you automagically.
What works:
- The text and the script (I hope; I didn't test everything)
- Backgrounds and characters
- Particles (e.g. snow)
- Sound effects
- Music
What doesn't:
- During some transitions the game will "crash", just click on ignore and you're good to go
This is due to a bug in RenPy itself
- Videos between acts
- Some scene transitions (the first blackout, eyes opening and closing, "bubble" transitions when starting the game and opening the menu)
What you will need:
- Windows OS
- Windows version of Katawa Shoujo
- Python
- Java Development Kit
- Internet connection
- 3GB of free space
- About 60 minutes of free time
- An Android phone with over 300MB of free app space
- A pinch of luck
If your phone doesn't have 300MB of free internal memory you might want to try this:
http://www.howtogeek.com/114667/how-to-install-android-apps-to-the-sd-card-by-default-move-almost-any-app-to-the-sd-card/
You will find the Android SDK installed under \rapt-6.14.1.0\android-sdk after you have successfully finished running the script (step 2 specifically)
First thing you will need to do is install Python2.7 and JDK (Java Development Kit)
You can get Python2.7 from http://www.python.org/download/
Choose "Python 2.7.3 Windows Installer", download it and install it with default options.
I'm not sure if the 64-bit version could cause problems. It shouldn't.
Feel free to install that one if you have a 64-bit version of Windows.
You can get the latest version of JDK from http://www.oracle.com/technetwork/java/javase/downloads/index.html
You need the JDK, not JRE so click the download button that says JDK next to it.
You will need to accept the license agreement and choose the Windows version.
"Windows x86" if you have 32-bit windows and "Windows x64" if you have 64-bit windows.
Download that and install it.
After you've installed everything make a copy of your Katawa Shoujo folder and copy KS2Android.py in there.
Now you are ready to launch the script.
If you installed Python correctly you can just double-click KS2Android.py to run it.
It will start by downloading RAPT (RenPy Android Packaging tool)
Give it a minute to finish the download.
Then it will extract RAPT and run a RAPT script that installs Apache Ant and Android SDK.
Apache Ant will be installed after a minute.
RAPT will then open a webpage and ask if you accept Android SDK Terms and Conditions.
Write "yes" in the console to continue.
It will continue to download and install Android SDK.
This will take a while (let's say 10 minutes) so you can get up and exercise while you wait.
You will then be asked if you want to create a signing key. You want that.
Android usually doesn't let you install unsigned packages without a bit of hacking.
Type "yes" and press enter.
Another question: Will you create a backup? Write "yes" here even though you won't.
It doesn't matter if you lose it, you can just make another since you're making it only for yourself.
You will have to enter a name too. Write whatever you want. It doesn't matter at all.
RAPT will finish it's business and return you back to KS2Android.
Now it will unpack the game files because it has to remove the videos since they aren't supported on Android yet and they would just take up extra space.
Then the game will be launched and closed twice to decompile, patch and recompile a file that is causing problems on Android.
Without this backgrounds wouldn't load and you wouldn't see any of the characters either.
After patching it will copy some settings and start building the package.
It shouldn't take longer than a few minutes.
And that's it, your Android port of Katawa Shoujo is done.
You will then have a file called "KatawaShoujo.apk" that is just over 330MB large.
Copy that file to your Android phone and install it.
DISTRIBUTING THAT FILE IS AGAINST THE CREATIVE COMMONS (NC ND) LICENSE!"
DO NOT SHARE IT!"
NOTES:
A file named "progress.txt" will be created in the same folder as KS2Android.py
That file is used to track the progress in case something goes wrong and the script crashes.
If that happens you can try running the script again and it might continue as if nothing happened.
You can also try setting the progress value to represent the last successful step and restarting it.
1 - Installed RAPT
2 - Installed Android SDK
3 - Downloaded UnRPA script
4 - Unpacked the game files
5 - Removed game videos
6 - Copied game scripts
7 - Downloaded decompile script
8 - Decompiled game scripts
9 - Patched
10 - Made a backup of the original script before recompiling <-- Removed in UPDATE2
11 - Recompiled the patched script (and restored the backup)
12 - Copied the compiled patched script
13 - Copied RAPT packaging configuration
14 - Built the package

create a new version of this paste RAW Paste Data

THIS IS NOW OUTDATED. CHECK THIS LINK FOR NEW VERSIONS http://pastebin.com/ZyRkVY5W

######################################################################################

KS2Android.py can be found at http://pastebin.com/ZyRkVY5W

---------------------------------------------------------------------------------------
Here's a compiled apk for lazy people: http://tiny.cc/KS-v1-Android
The above also includes a fix for crashes cased by some character animations.
For those who are computer savvy, it required a change in RenPy's compatibility module.
It replaces the MoveTransition function with OldMoveTransition which in turn causes
define.move_transitions to fail.

Regarding the license and derivative works, Katawa Shoujo itself remains unchanged.
The engine that runs KS was ported to Android and as such KS can run on it.
---------------------------------------------------------------------------------------

UPDATE: Send an email here if you need support kss22aa@gmail.com or to tell me you succeeded.
        Report bugs and crashes, I will be updating the script as issues arise.
        When additional support is added by Ren'Py developers, I will update it.
        You might want to check this every now and then.

UPDATE2: 2 January 2013
         - The script has been modified and a bit. I removed some cleanup steps so the script doesn't
         delete the helper scripts and doesn't backup the game scripts before changing them.
         However all of that doesn't really matter because you will be running the script in a COPY
         of your Katawa Shoujo folder which you can later safely delete.
	 - Added instructions on how to set the SD card as the default installation location for
	 Android phones with less than required internal memory

These are instructions on how to port Katawa Shoujo to Android.
KS2Android does 92% of the work for you automagically.

What works:
 - The text and the script (I hope; I didn't test everything)
 - Backgrounds and characters
 - Particles (e.g. snow)
 - Sound effects
 - Music

What doesn't:
 - During some transitions the game will "crash", just click on ignore and you're good to go
	This is due to a bug in RenPy itself
 - Videos between acts
 - Some scene transitions (the first blackout, eyes opening and closing, "bubble" transitions when starting the game and opening the menu)

What you will need:
 - Windows OS
 - Windows version of Katawa Shoujo
 - Python
 - Java Development Kit
 - Internet connection
 - 3GB of free space
 - About 60 minutes of free time
 - An Android phone with over 300MB of free app space
 - A pinch of luck

If your phone doesn't have 300MB of free internal memory you might want to try this:
http://www.howtogeek.com/114667/how-to-install-android-apps-to-the-sd-card-by-default-move-almost-any-app-to-the-sd-card/
You will find the Android SDK installed under \rapt-6.14.1.0\android-sdk after you have successfully finished running the script (step 2 specifically)


First thing you will need to do is install Python2.7 and JDK (Java Development Kit)

You can get Python2.7 from http://www.python.org/download/
Choose "Python 2.7.3 Windows Installer", download it and install it with default options.
I'm not sure if the 64-bit version could cause problems. It shouldn't.
Feel free to install that one if you have a 64-bit version of Windows.

You can get the latest version of JDK from http://www.oracle.com/technetwork/java/javase/downloads/index.html
You need the JDK, not JRE so click the download button that says JDK next to it.
You will need to accept the license agreement and choose the Windows version.
"Windows x86" if you have 32-bit windows and "Windows x64" if you have 64-bit windows.
Download that and install it.

After you've installed everything make a copy of your Katawa Shoujo folder and copy KS2Android.py in there.


Now you are ready to launch the script.
If you installed Python correctly you can just double-click KS2Android.py to run it.

It will start by downloading RAPT (RenPy Android Packaging tool)
Give it a minute to finish the download.

Then it will extract RAPT and run a RAPT script that installs Apache Ant and Android SDK.

Apache Ant will be installed after a minute.
RAPT will then open a webpage and ask if you accept Android SDK Terms and Conditions.

Write "yes" in the console to continue.

It will continue to download and install Android SDK.
This will take a while (let's say 10 minutes) so you can get up and exercise while you wait.

You will then be asked if you want to create a signing key. You want that.
Android usually doesn't let you install unsigned packages without a bit of hacking.
Type "yes" and press enter.

Another question: Will you create a backup? Write "yes" here even though you won't.
It doesn't matter if you lose it, you can just make another since you're making it only for yourself.

You will have to enter a name too. Write whatever you want. It doesn't matter at all.

RAPT will finish it's business and return you back to KS2Android.

Now it will unpack the game files because it has to remove the videos since they aren't supported on Android yet and they would just take up extra space.
Then the game will be launched and closed twice to decompile, patch and recompile a file that is causing problems on Android.
Without this backgrounds wouldn't load and you wouldn't see any of the characters either.

After patching it will copy some settings and start building the package.
It shouldn't take longer than a few minutes.

And that's it, your Android port of Katawa Shoujo is done.

You will then have a file called "KatawaShoujo.apk" that is just over 330MB large.
Copy that file to your Android phone and install it.

DISTRIBUTING THAT FILE IS AGAINST THE CREATIVE COMMONS (NC ND) LICENSE!"
DO NOT SHARE IT!"


NOTES:
A file named "progress.txt" will be created in the same folder as KS2Android.py
That file is used to track the progress in case something goes wrong and the script crashes.
If that happens you can try running the script again and it might continue as if nothing happened.
You can also try setting the progress value to represent the last successful step and restarting it.
 1 - Installed RAPT
 2 - Installed Android SDK
 3 - Downloaded UnRPA script
 4 - Unpacked the game files
 5 - Removed game videos
 6 - Copied game scripts
 7 - Downloaded decompile script
 8 - Decompiled game scripts
 9 - Patched
 10 - Made a backup of the original script before recompiling <-- Removed in UPDATE2
 11 - Recompiled the patched script (and restored the backup)
 12 - Copied the compiled patched script
 13 - Copied RAPT packaging configuration
 14 - Built the package

Pastebin.com Tools & Applications

iPhone/iPad

Windows

Firefox

Chrome

WebOS

Android

Mac

Opera

Click.to

UNIX

WinPhone