Difference between revisions of "IOS"

From ScummVM :: Wiki
Jump to navigation Jump to search
m
Line 9: Line 9:


=iPhone=
=iPhone=
A port of 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 [http://www.scummvm.org ScummVM] for the iPhone / iPod Touch. Look [http://forums.scummvm.org/viewtopic.php?t=4744&start=15 here] for the latest changes.


== Installation ==
== Installation ==

Revision as of 20:32, 7 October 2008

IOS Port
Latest Released Version 0.12.0
Supported Audio Options Ogg, MP3, Uncompressed
Additional Webpage(s) None
Maintainer(s) vinterstum
Forum Port Forum
Status Maintained
First Official Version 0.11.0

iPhone

A port of ScummVM for the iPhone / iPod Touch. Look here for the latest changes.

Installation

Cydia (Firmware 2.0 and upwards)

  • Start Cydia
  • Go to the Sections tab, and find the "Repositories" section.
  • Select and install the UrbanFanatics.com source
  • ScummVM should now be in the main category list, ready for you to install!

Installer.app (Firmware 1.1.4 and below)

  • Open Installer.app on a jailbroken iPhone or iPod touch. Use Google to find out how to jailbreak your specific version of the firmware on your device.
  • Tap the "Sources" button in the bottom-right corner.
  • Tap the "Edit" button in the top-right corner.
  • Tap the "Add" button in the top-left corner.
  • Enter http://urbanfanatics.com/scummvm.xml into the text area and tap "OK".
  • Installer will refresh your sources. It may close. If so, reopen it.
  • ScummVM is now available for install in the Games section.

Games

To copy the game data files over to your device:

  • 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".
  • If you're using Windows, you can try try iPhoneBrowser instead.
  • Make a subdirectory on your phone under /var/root (or /var/mobile for firmware versions 1.1.3 and above), 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).
  • 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 added them).


Documentation

Controls

Left click Single tap
Right click Hold one finger on screen where you want to click, single tap another
Arrow keys Without holding any other finger down, swipe your finger quickly across the screen in the direction of the arrow key you want.
ESC Hold one finger on screen, double tap another
F5 (menu) Hold one finger on screen, swipe another down from top to bottom
F 0-9 keys Press the keyboard button directly under the appropriate number
Pause Keyboard spacebar
Toggle Click+Drag mode Hold one finger on screen, swipe another 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 Hold one finger on screen, swipe another up 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 blogs

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

You need original disks to run the games. We will not give support to anyone using illegal copies of the games. The only two games which are legal to download (Flight of the Amazon Queen and Beneath a Steel Sky) can be found at our downloads page. 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 for over 40+ active developers.


Compatibility List

Legend

No known problems Playable, with problems Unplayable


Tested Games

Game Status Notes
Beneath a Steel Sky Fully Playable Save/load buttons must be double-tapped to function.
Broken Sword 1: The Shadow of the Templars Fully Playable
Day of the Tentacle Completed
The Dig Fully playable
Flight of the Amazon Queen Fully playable
Full Throttle Fully playable
Gobliiins Fully playable
Gobliins 2 Fully playable
Indiana Jones and the Fate of Atlantis Completed
Indiana Jones and the Last Crusade Fully playable
King's Quest 3 Fully playable
Loom Completed
Maniac Mansion Completed
Monkey Island 1: The Secret of Monkey Island Completed
Monkey Island 2: LeChuck's Revenge Fully playable
Monkey Island 3: The Curse of Monkey Island Playable Intro can only be skipped with "ESC" in click+drag mode.
Sam & Max Hit the Road Completed
Simon the Sorcerer 1 Fully playable
Simon the Sorcerer 2 Fully playable
Zak McKracken and the Alien Mindbenders Fully playable


Submit Games

Have you tried a game not in the above list, or have an addition to an existing entry? Please write up a report in the iPhone game compatibility thread and it will be added here!