In this new version of ScummVM Android, significant changes were made to the file access system to allow support for modern versions of the Android Operating System. Thus, you need to set up SAF in order to be able to add the games. 1## Adding Games 1. Select **Add Game...** from the launcher. 2. Inside the ScummVM file browser, use"lect **Go Up"** until you reach the "root" folder where you will seeich has the "**<Add a new folder>"** option. 2. Choose that, then browse and select the "parent" folder for![ScummVM file browser root](browser-root.png "ScummVM file browser root"){w=70%} 3. Double-tap **<Add a new folder>**. In your device's file browser, navigate to the folder containing all your games subfolders, e.g. "SD Card > myGames". Click on "Use this folder". 3. Then, a new folder "myGames" will appear on the "root" folder of. For example, **SD Card > ScummVMgames**. 4. Select **Use this folder**. ![OS selectable folder](fs-folder.png "OS selectable folder"){w=70%} 5. Select **ALLOW** to give ScummVM permission to access the folder. ![OS access permission dialog](fs-permission.png "OS access permission"){w=70%} 6. In the ScummVM file browser. 4. Browse through this folder to your game data., double-tap to browse through your added folder. Add a game by selecting the sub-folder containing the game files, then tap **Choose**. ![SAF folder added](browser-folder-in-list.png "SAF folder added"){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.
## 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. ![ScummVM file browser root](browser-root.png "ScummVM file browser root"){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**. ![OS selectable folder](fs-folder.png "OS selectable folder"){w=70%} 5. Select **ALLOW** to give ScummVM permission to access the folder. ![OS access permission dialog](fs-permission.png "OS access permission"){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**. ![SAF folder added](browser-folder-in-list.png "SAF folder added"){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!
## 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.