## ScummVM at a Glance ScummVM is a modern reimplementation of various game engines. Once you transfer the original game data to your device, it endeavors to use it to faithfully recreate the original gaming experience. ScummVM isn't your typical emulator of DOS, Windows, or some console. Rather than a one-size-fits-all approach, it takes a meticulous route, implementing the precise game logic for each specific title or engine it supports. ScummVM will not work with game engines it does not support. ScummVM is developed by a team of volunteers and is free software. We lack an extensive testing team, possess only a limited range of devices, and cannot always address every request. We also do not run advertisements or sell you anything. Please be mindful of this when you submit a complaint or a bug report. ## Where to get the games Visit [our Wiki](https://wiki.scummvm.org/index.php?title=Where_to_get_the_games) for a detailed list of supported games and where to purchase them. Alternatively, you can download a variety of [freeware games](https://scummvm.org/games) and [demos](https://www.scummvm.org/demos/) directly from our website. The ScummVM team does not endorse any specific game supplier. However, the project receives a commission from every purchase made on [ZOOM-Platform](https://www.zoom-platform.com/?affiliate=c049516c-9c4c-42d6-8649-92ed870e8b53) through affiliate referral links. Additionally, games not available on ZOOM-Platform can be found on other suppliers such as GOG.com and Steam. For other (out-of-print) games, consider checking platforms like Amazon, eBay, Game Trading Zone, or other auction sites. Be cautious of faulty games and illegal game copies.
## Connecting a cloud service - Quick mode 1. From the Launcher, select **Global Options** and then select the **Cloud** tab. 2. Select your preferred cloud storage service from the **Active storage** dropdown, then select **Connect**. {w=70%} 3. Select **Quick mode**. {w=70%} 4. Select **Run server** and then select **Next** {w=70%} {w=70%} 5. Open the link. {w=70%} 6. In the browser window that opens, select the cloud service to connect. {w=70%} 7. Sign in to the chosen cloud service. Once completed, return to ScummVM. 8. On the success screen, select **Finish** to exit. {w=70%} 9. Back on the main Cloud tab, select **Enable storage**. {w=70%} 10. You're ready to go! Use the cloud functionality to sync saved games or game files between your devices. {w=70%} For more information, including how to use the manual connection wizard, see our [Cloud documentation](https://docs.scummvm.org/en/latest/use_scummvm/connect_cloud.html)
EnglishI18N: <Add a new folder> must match the translation done in backends/fs/android/android-saf-fs.h
In this new version of ScummVM for Android, significant changes were made to the file access system to allow support for modern versions of the Android Operating System. If you find that your existing added games or custom paths no longer work, please edit those paths: 1. From the Launcher, go to **Game Options > Paths**. Select **Game Path** or **Extra Path**, as appropriate. 2. Inside the ScummVM file browser, select **Go Up** until you reach the root folder which has the **<Add a new folder>** option. 3. Double-tap **<Add a new folder>**. In your device's file browser, navigate to the folder containing all your game folders. For example, **SD Card > ScummVMgames** 4. Select **Use this folder**. 5. Select **Allow** to give ScummVM permission to access the folder. 6. In the ScummVM file browser, double-tap to browse through your added folder. Select the folder containing the game's files, then tap **Choose**. Repeat steps 1 and 6 for each game.
EnglishI18N: <Add a new folder> must match the translation done in backends/fs/android/android-saf-fs.h
In this new version of ScummVM for Android, significant changes were made to the file access system to allow support for modern versions of the Android Operating System. To add a game: 1. Select **Add Game...** from the launcher. 2. Inside the ScummVM file browser, select **Go Up** until you reach the root folder which has the **<Add a new folder>** option. 3. Double-tap **<Add a new folder>**. In your device's file browser, navigate to the folder containing all your game folders. For example, **SD Card > ScummVMgames** 4. Select **Use this folder**. 5. Select **Allow** to give ScummVM permission to access the folder. 6. In the ScummVM file browser, double-tap to browse through your added folder. Select the sub-folder containing the game's files, then tap **Choose**. Repeat steps 1 and 6 for each game.
## Help, I'm lost! First, make sure you have the games and necessary game files ready. Check the **Where to Get the Games** section under the **General** tab. Once obtained, follow the steps outlined in the **Adding Games** tab to finish adding them on this device. Take a moment to review this process carefully, as some users encountered challenges here owing to recent Android changes. Need more help? Refer to our [online documentation for Android](https://docs.scummvm.org/en/latest/other_platforms/android.html). Got questions? Swing by our [support forums](https://forums.scummvm.org/viewforum.php?f=17) or hop on our [Discord server](https://discord.gg/4cDsMNtcpG), which includes an [Android support channel](https://discord.com/channels/581224060529148060/1135579923185139862). Oh, and heads up, many of our supported games are intentionally tricky, sometimes mind-bogglingly so. If you're stuck in a game, think about checking out a game walkthrough. Good luck!
## Touch control modes The touch control mode can be changed by tapping or clicking on the controller icon in the upper right corner ### Direct mouse The touch controls are direct. The pointer jumps to where the finger touches the screen (default for menus). {w=10em} ### Touchpad emulation The touch controls are indirect, like on a laptop touchpad. {w=10em} ### Gamepad emulation Fingers must be placed on lower left and right of the screen to emulate a directional pad and action buttons. {w=10em} To select the preferred touch mode for menus, 2D games, and 3D games, go to **Global Options > Backend > Choose the preferred touch mode**. ## Touch actions ### Two finger scroll To scroll, slide two fingers up or down the screen ### Two finger tap To do a two finger tap, hold one finger down and then tap with a second finger. ### Three finger tap To do a three finger tap, start with holding down one finger and progressively touch down the other two fingers, one at a time, while still holding down the previous fingers. Imagine you are impatiently tapping your fingers on a surface, but then slow down that movement so it is rhythmic, but not too slow. ### Immersive Sticky fullscreen mode Swipe from the edge to reveal the system bars.They remain semi-transparent and disappear after a few seconds unless you interact with them. ### Global Main Menu To open the Global Main Menu, tap on the menu icon at the top right of the screen. {w=10em} ## Virtual keyboard To open the virtual keyboard, long press on the controller icon at the top right of the screen, or tap on any editable text field. To hide the virtual keyboard, tap the controller icon again, or tap outside the text field. {w=10em}
## Adding Games 1. Select **Add Game...** from the launcher. 2. Inside the ScummVM file browser, select **Go Up** until you reach the root folder which has the **<Add a new folder>** option. {w=70%} 3. Double-tap **<Add a new folder>**. In your device's file browser, navigate to the folder containing all your game folders. For example, **SD Card > ScummVMgames**. 4. Select **Use this folder**. {w=70%} 5. Select **ALLOW** to give ScummVM permission to access the folder. {w=70%} 6. In the ScummVM file browser, double-tap to browse through your added folder. Add a game by selecting the sub-folder containing the game files, then tap **Choose**. {w=70%} Step 2 and 3 are done only once. To add more games, repeat Steps 1 and 6. See our [Android documentation](https://docs.scummvm.org/en/latest/other_platforms/android.html) for more information.
## Help, I'm lost! First, make sure you have the games and necessary game files ready. Check the **Where to Get the Games** section under the **General** tab. Once obtained, follow the steps outlined in the **Adding Games** tab to finish adding them on this device. Need more help? Refer to our [online documentation for iOS](https://docs.scummvm.org/en/latest/other_platforms/ios.html). Got questions? Swing by our [support forums](https://forums.scummvm.org/viewforum.php?f=15) or hop on our [Discord server](https://discord.gg/4cDsMNtcpG), which includes an [iOS support channel](https://discord.com/channels/581224060529148060/1149456560922316911). Oh, and heads up, many of our supported games are intentionally tricky, sometimes mind-bogglingly so. If you're stuck in a game, think about checking out a game walkthrough. Good luck!
## Touch control modes The touch control mode can be changed by tapping or clicking on the controller icon in the upper right corner, by swiping two fingers from left to right, or in the global settings from the Launcher go to **Global Options > Backend > Choose the preferred touch mode**. It's possible to configure the touch mode for three situations (ScummVM menus, 2D games and 3D games). ### Direct mouse The touch controls are direct. The pointer jumps to where the finger touches the screen (default for menus). {w=10em} ### Touchpad emulation The touch controls are indirect, like on a laptop touchpad. {w=10em} To select the preferred touch mode for menus, 2D games, and 3D games, go to **Global Options > Backend > Choose the preferred touch mode**. ## Touch actions | Gesture| Action | ------------------|------------------- | `One finger tap`| Left mouse click | `Two fingers tap` | Right mouse click | `Two fingers double tap` | ESC | `One finger press & hold for >0.5s` | Left mouse button hold and drag, such as for selection from action wheel in Curse of Monkey Island | `Two fingers press & hold for >0.5s` | Right mouse button hold and drag, such as for selection from action wheel in Tony Tough | `Two fingers swipe (left to right)` | Toggles between the touch modes | `Two fingers swipe (right to left)` | Toggles virtual controller (>iOS 15) | `Two fingers swipe (top to bottom)` | Access Global Main Menu in games | `Pinch (zoom in/out)` | Enables/disables keyboard ### Virtual Gamepad Devices running iOS 15 or later can connect virtual gamepad controller by swiping two fingers from right to left or through **Global Options > Backend**. The directional button can be configured to either a thumbstick or a dpad. **Note** While the virtual controller is connected it is not possible to perform mouse clicks using tap gestures since they are disabled as long as the virtual controller is visible. Left mouse clicks are performed by pressing the A button. Tap gestures are enabled again when virtual controller is disconnected. ### Global Main Menu To open the Global Main Menu, tap on the menu icon at the top right of the screen or swipe two fingers downwards. {w=10em} ## Virtual keyboard To open the virtual keyboard, long press on the controller icon at the top right of the screen, perform a pinch gesture (zoom out) or tap on any editable text field. To hide the virtual keyboard, tap the controller icon again, do an opposite pinch gesture (zoom in) or tap outside the text field. {w=10em}
## Use of keyboard External keyboards are supported and from iOS 13.4 most of the special keys, e.g. function keys, Home and End, are mapped. For external keyboards missing the special keys, e.g. the Apple Magic Keyboard for iPads, the special keys can be triggered using the following key combinations: | Key combination| Action | ------------------|------------------- | `CMD + 1`| F1 | `CMD + 2`| F2 | `...`| ... | `CMD + 0`| F10 | `CMD + SHIFT + 1` | F11 | `CMD + SHIFT + 2` | F12 | `CMD + UP`| PAGE UP | `CMD + DOWN`| PAGE DOWN | `CMD + LEFT`| HOME | `CMD + RIGHT`| END
## Adding Games 1. Copy the required game files to the ScummVM application. There are several ways to do that, see our [Transferring game files documentation](https://docs.scummvm.org/en/latest/other_platforms/ios.html#transferring-game-files) for more information. 2. Select **Add Game...** from the launcher. 3. In the ScummVM file browser, double-tap to browse to your added folder. Add a game by selecting the sub-folder containing the game files, then tap **Choose**. To add more games, repeat the steps above. See our [iOS documentation](https://docs.scummvm.org/en/latest/other_platforms/ios.html) for more information.
## Touch actions ### Press Touch area Press Touch area to perform a left mouse click ### Play/Pause Press Play/Pause to perform a right mouse click ### Global Main Menu To open the Global Main Menu, press Back/Menu button. ## Virtual keyboard To open the virtual keyboard, press and hold the Play/Pause button. To hide the virtual keyboard, press the Back/Menu button.
## Adding Games 1. Copy the required game files to the ScummVM application. There are several ways to do that, see our [Transferring game files documentation](https://docs.scummvm.org/en/latest/other_platforms/tvos.html#transferring-game-files) for more information. 2. Select **Add Game...** from the launcher. 3. In the ScummVM file browser, double-tap to browse to your added folder. Add a game by selecting the sub-folder containing the game files, then tap **Choose**. To add more games, repeat the steps above. See our [tvOS documentation](https://docs.scummvm.org/en/latest/other_platforms/tvos.html) for more information.
