A port of [[About|ScummVM]] for the iPhone / iPod Touch. Look [http://forums.scummvm.org/viewtopic.php?t=4744&start=15 here] for the latest changes.

A port of [[About|ScummVM]] for the iPhone / iPod Touch. Look [http://forums.scummvm.org/viewtopic.php?t=4744&start=15 here] for the latest changes.

+

+

== Non-Jailbroken installation ==

+

Now it is possible to install ScummVM on non-jailbroken devices. But you will have to compile it by yourself. Here is a blog post explaining the process: [http://blog.pmlabs-apps.com/scummvm-on-ios-without-jailbreak/ ScummVM on iOS without Jailbreak]

Games

To copy the game data files over to your device:

On the iPhone/iPod install OpenSSH (if it is not already installed), using Cydia.

Install an SFTP client (For Macs, Cyberduck is good. For Windows, FileZilla should do the trick). Then connect your SFTP client to your iPhone/iPod using the IP address the device shows in its network settings (Hit Settings, then Wi-Fi, then find the network you're connected to). The username is "root" and the password probably "alpine".

Make a subdirectory on your phone under /var/mobile (or /var/root for firmware versions 1.1.2 and below), and upload the games there (don't place them anywhere else on the phone, as you'll be filling up the smaller system partition then). Here you can see exactly which files you need for which games.

Make sure these files and directories have the right permissions set! You're uploading as root, all the files need to be readable by the 'mobile' user as well.

When you've uploaded all the games you want, start up ScummVM and add the game(s) there (navigate to the same directory you uploaded them to).

Documentation

Controls

Game Controller Mapping:

Action

Touch screen control

Left click

Single tap

Right click

Hold one finger on screen where you want to click, single tap another

Arrow keys

Only with ScummVM 2.1.0 or above, use a three fingers swipe in the direction of the arrow key you want. You can also use the arrow buttons in the bar above the keyboard (on iPhone you may need to scroll the bar to see those).

ESC

Hold one finger on screen, double tap another. Since ScummVM 2.1.0 you can also use the Esc key in the bar above the keyboard.

Tab

Since ScummVM 2.1.0 use the Tab button in the bar above the keyboard.

Return

Since ScummVM 2.1.0 use the Return button in the bar above the keyboard.

Global Main Menu

Swipe two fingers down from top to bottom. Note: In all versions before 1.5.0, this only send "F5" and thus in some games different menus were brought up. Since ScummVM 2.1.0 you can also use the left-most button in the bar above the keyboard.

Enable/disable keyboard

Rotate phone to Portrait orientation, rather than landscape to enable the keyboard. Since ScummVM 2.1.0 you can also use the pinch gesture to enable or disable the keyboard (pinch in to enable the keyboard and pinch out to disable it). If no external keyboard is connected, this shows and hides the On Screen keyboard. When an external keyboard is connected, instead of showing/hiding the On Screen keyboard this enables/disables inputs from the external keyboard.

F 0-9 keys

Press the keyboard button directly under the appropriate number. Since ScummVM 2.1.0 use the bar above the keyboard instead.

Pause

Keyboard spacebar

Toggle Click+Drag mode

Swipe two fingers up from bottom to top. In this mode, a mouse click is sent immediately when you touch the screen, drags to wherever you slide your finger, and releases where you lift your finger. If you press down a second finger in this mode, you effectively release the left mouse button, and press down the right one (which is then released when you lift your finger again). Useful for Monkey Island 3: The Curse of Monkey Island and Full Throttle.

Toggle Touchpad mode

Swipe two fingers from left to right. In this mode, the cursor doesn't stay underneath your finger, but is rather moved around from its current position depending on the direction of your finger movement, just like a touchpad on a laptop. From version 0.12.0-pre3 and upwards only.

Suspend

Press the tactile "home" button.

Quit

Press and hold the tactile "home" button for 5-6 seconds.

A note for those coming from weblogs

The official site for ScummVM is scummvm.org. This is only a port-specific page.

You need the original disks to run the games. We will not give support to anyone using illegal copies of the games. There is a growing list of formerly commercial games turned into freeware which can be found at our downloads page or in other places. A number of games are still on sale, and for games not in the list, go to eBay, into your attic or sometimes they're still in local bargain bins.

ScummVM is not an emulator, and the project is not only about LucasArts games since 2002 (i.e. today we support over 150 different games by a number of different game software companies).

Vinterstum created just one of 30 ScummVM ports, and ScummVM is a work of over 40 active developers.