TOP

How to install and play CLANNAD on your iPhone or iTouch

You just got a brand new Apple iPhone, and you are also an enthusiast of visual novels and eroge. Isn't it only natural you would see if anybody ported a few ADV games to the iPhone? Well..at least that's what I did :)
Fortunately ADV game players are in luck as xclannad, an open source REALLIVE interpreter engine has now been ported to the iPhone. Provided that you have a jailbroken iPhone with version 2.0 or higher firmware, it isn't too difficult to bring Nagisa or Tomoyo (or whoever your fav. CLANNAD character is) wherever you go.
Here I will provide an English guide to get CLANNAD going hopefully without too much trouble. There's a few bugs in the current build of xclannad such as a glitch when you play pranks on Fuuko in her path, and don't expect to get the leaked Baka-Tsuki SEEN.TXT working as a voiced-patched SEEN.TXT seems to crash the game. This method should work for other REALLIVE engined games such as Tomoyo After and Little Busters. Please note that all the same steps apply for jailbroken iPod Touch owners.

Pre-requisites

Jailbroken iPhone (FW 2.0 or greater)
xclannad for 2.x iPhone obtainable here
Japanese font. I used msuigothic.ttf that came with my windows installation. You can also try the open source Mikachan-Font.
WinSCP so you can transfer files to your jailbroken iPhone
Terminal application on your iPhone or a SSH client such as PuTTY
iPhone Tunnel Suite (optional)

Prepare Clannad.app

Firstly, head over to the Shiori-chan Project page and download+extract 'xclannad for iPhoneOS 2.x.x JB (ARM) version 0.07hb low-mem' and the app package file. The first file contains the xclannad executable, while the second file contains the Clannad.app package so that you can run the game from the Springboard menu.
In the folder where you extracted xclannad.app, open SDLAppParam.plist and edit the following line:

<string>/var/mobile/Media/xclannadGameDirectory</string>

<string>/var/mobile/Media/ons/clannad</string>

or wherever you would like to later place the CLANNAD game data. I would suggest placing it somewhere within the /var/mobile directory.
You can also rename the xclannad.app to whatever you want, i.e. Clannad.app. You would want to if the game you plan to install isn't CLANNAD, i.e. for Tomoyo After you could use 智代アフター.app.
Next, the newly created .app folder must be transferred to your iPhone's /Applications directory.

Copying the game files

In this step we will transfer the game files, and the .app folder to the phone. I'm going to assume that your device is connected to the same wireless network as the computer containing the game files and the .app folder. Otherwise you can connect through USB if you have iTunnel. I suggest through iTunnel as I've found transferring files via wifi copiusly slow (<500kB/s).

Launch WinSCP and click on 'New' to create a new session. Fill out the Session details like so, taking special note of your iPhone's IP and root password (alpine by default). To obtain your iPhone's IP, go into iPhone Settings >Wi-Fi networks > your wireless network. Alternatively if you are connecting via iTunnel, the IP address you must enter into WinSCP is simply 127.0.0.1.

Once you've connected, navigate to /var/mobile/Media/ and create a new folder named 'ons', and inside that folder create another directory named 'clannad'. (This step should depend on what game you are installing and where you want to put the game files).
Next, navigate to the folder containing your CLANNAD game files and select folders BGM, DAT, G00, GAN, MOV, PDT SYS, WAV and GAMEEXE.INI. drag those files to the /var/mobile/Media/ons/clannad folder which should be open in WinSCP. Go and make dinner as it could take up to 1 hour to copy all the files, longer if you are connected via wifi.

Once you have copied the game files, copy seen.txt to the same folder. However, you must use binary mode to transfer it. When WinSCP shows the Copy prompt, click 'Transfer settings...' and change the mode to 'Binary', then proceed with the transfer. The Copy prompt should appear like so:

You must also place your chosen font inside the /var/mobile/Media/ons/clannad directory. The font must be renamed to default.ttf. Next, change the permissions of the folder by right clicking the clannad folder > Properties. Enter '0777' into the 'Octal' field and select 'Set group, owner and permissions recursively'. Go and make a coffee while the permissions are being set.

Once you have done this the remote clannad directory should look something similar to this:

At this point you should copy Clannad.app and its contents to the /Application folder on your phone. Don't forget to copy the xclannad executable from the first archive into the Clannad.app folder as well; then setting the permissions of Clannad.app to 0755 recursively.

Signing the executable

This step is necessary as the OS kernel runs a hash check on all applications that are run by the user. Unsigned applications are likely to exit with a 'Killed' message. To sign the xclannad executable:

Open the terminal app in your iPhone or connect via an SSH client such as PuTTY. You should use the same settings that you also used for WinSCP.
Type the following commands:

$ su

(enter alpine for the password)

root# apt-get install ldid
root# ldid -S /Applications/Clannad.app/xclannad
root# sysctl -w security.mac.proc_enforce=0 security.mac.vnode_enforce=0

Set root as the owner of Clannad.app:

 root# chown -R root:admin /Applications/Clannad.app

Running the game

Either restart your phone or 'respring' if you have BossPrefs. the Clannad icon should now be in your menu (you can customise the icon by placing a roughly 60x60 image named Icon.png in the /Applications/Clannad.app directory. Enjoy!

Acknowledgements

Special thanks go out to the users at iphone wiki for providing the Japanese version of the guide, katane for porting all those ADV engines to iPhoneOS and JAGARL for creating the xclannad REALLIVE interpreter.

If you have any queries or comments please feel free to send me an e-mail.

cellsplicer-notat-gmail.com