## 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)
## 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}
## 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.
## Libretro playlists for ScummVM core Playlists used in Libretro frontends (e.g. Retroarch) are plain text lists used to directly launch a game with a specific core from the user interface. Those lists are structured to pass to the core the path of a specific content file to be loaded (e.g. ROM). ScummVM core can accept as content the path to any of the files inside a valid game folder, the detection system will try to autodetect the game from the content file parent folder and run the game with default ScummVM options. The core also supports dedicated per game **hook** plain text files with **.
## Keyboard shortcuts ScummVM supports various in-game keyboard and mouse shortcuts, and since version 2.2.0 these can be manually configured in the **Keymaps tab**, or in the **configuration file**. For game-specific controls, see the [wiki entry](https://wiki.scummvm.org/index.php?title=Category:Supported_Games) for the game you are playing. Default shortcuts are shown in the table. | Shortcut| Description | --------------|------------------ | `Ctrl+F5` | Displays the Global Main Menu
| `Ctrl+u`| Mutes all sounds | `Ctrl+m`| Toggles mouse capture | `Ctrl+Alt` and `9` or `0` | Cycles forwards/backwards between graphics filters | `Ctrl+Alt` and `+` or `-` | Increases/decreases the scale factor | `Ctrl+Alt+a` | Toggles aspect ratio correction on/off | `Ctrl+Alt+f` | Toggles between nearest neighbor and bilinear interpolation (graphics filtering on/off) | `Ctrl+Alt+s` | Cycles through stretch modes | `Alt+Enter`| Toggles full screen/windowed mode | `Alt+s`| Takes a screenshot | `Ctrl+F7`| Opens virtual keyboard (if enabled). This can also be opened with a long press of the middle mouse button or wheel. | `Ctrl+Alt+d` | Opens the ScummVM debugger
Enables the assistive Predictive Input Dialog specifically for when clicking the left mouse button within text input fields. The Predictive Input Dialog can still be activated on demand if there's a specified key mapping for it
