User Manual/Appendix: Controls

WORK IN PROGRESS, HELP NEEDED

If you want to contribute, send us a sample of text you'd write for the new manual, and we will consider adding you an account. You can work on the manual in the Wiki, but if you prefer, supplying us with HTML or TeX sources is fine, too (we will then translate them for the Wiki). You can have a look at our TODO page for a list of tasks that need to be done.

This page contains control mapping for various platforms.

Caanoo

Touchscreen:
Buttons	Action	Notes
Touchscreen	Move Pointer and process 'Tap Mode' on touch.
Help II	Toggle Touchscreen 'Tap Mode'	Adjusts the 'on tap' response, it cycles from 'Left Click' (Default), 'Right Click' and 'Hover'.
Left Trigger + Y	Toggle Touchscreen 'Tap Mode'	Adjusts the 'on tap' response, it cycles from 'Left Click' (Default), 'Right Click' and 'Hover'.
Left Trigger + Touchscreen 'Tap'	Force the touchscreen 'Tap' to simulate a 'Right Click' regardless of the 'Tap Mode'.	Ideal for quickly simulating a 'Right Click' in games without changing the configured 'Tap Mode'.

Mouse Emulation:
Buttons	Action	Notes
Analogue Joystick	Move Pointer
B	Left Click
X	Right Click

Keyboard Emulation:
Buttons	Action	Notes
Help I	Display in-game menu where supported	Save, Load, Quit etc.
Home	Escape
Hold (On Power Button)	Exit ScummVM gracefully	Please exit ScummVM doing this or via the menu, do not just turn off your Caanoo or you can loose save games
Y	Space Bar
Right Trigger	Return

Button Combinations:
Buttons	Action	Notes
Left Trigger + Right Trigger	Display the ScummVM Virtual Keyboard	Ideal for entering 'Save Game' names or 'Copy Protection' information.
Left Trigger + Help I	Display the Global ScummVM Main Menu	Return to launcher and setup system options
Left Trigger + Home	Exit ScummVM gracefully	Please exit ScummVM doing this or via the menu, do not just turn off your Caanoo or you can loose save games
Left Trigger + A	Open "Predictive Text" entry dialog	Used in AGI games as long as a suitable dictionary is available

Dreamcast

Game Controller Mapping:
Button	Action	Notes
Joystick	Move Pointer
Directional pad	Move Pointer (slowly)	Also controls the on-screen keyboard
A	Left Click
B	Right Click
Y	Space	Pause
Start	F5	Load and save
Left trigger	Bring up/remove the on-screen keyboard
X	5	For boxing in Indy 3
D-Pad + X	1, 2, 3, 4, 6, 7, 8, 9	Likewise

GameCube

TODO

GP2X

Touchscreen: (on F200)
Buttons	Action	Notes
Touchscreen	Move Pointer and process 'Tap Mode' on touch.
Left Trigger + Y	Toggle Touchscreen 'Tap Mode'	Adjusts the 'on tap' response, it cycles from 'Left Click' (Default), 'Right Click' and 'Hover'.
Left Trigger + Touchscreen 'Tap'	Force the touchscreen 'Tap' to simulate a 'Right Click' regardless of the 'Tap Mode'.	Ideal for quickly simulating a 'Right Click' in games without changing the configured 'Tap Mode'.

Mouse Emulation:
Buttons	Action	Notes
dPad/Joystick	Move Pointer
Joystick Click	Left Click
B	Left Click
X	Right Click

Keyboard Emulation:
Buttons	Action	Notes
Start (Home on F200)	Display in-game menu if supported	Save, Load, Quit etc.
Select	Escape
Y	Space Bar
Right Trigger	Return
Volume -/+	Set Volume

Button Combinations:
Buttons	Action	Notes
Left Trigger + Volume	Set Subtitle Speed	In SCUMM games
Left Trigger + Right Trigger	Display the ScummVM Virtual Keyboard	Ideal for entering 'Save Game' names or 'Copy Protection' information.
Left Trigger + Start (or Home on the F200)	Display the Global ScummVM Main Menu	Return to launcher and setup system options
Left Trigger + Select	Exit ScummVM gracefully	Please exit ScummVM doing this or via the menu, do not just turn off your Caanoo or you can loose save games
Left Trigger + A	Open "Predictive Text" entry dialog	Used in AGI games as long as a suitable dictionary is available
Left Trigger + B	Toggle 'Zoom'	Cycles the zoom modes - Ideal for high resolution games like Broken Sword/COMI
Joystick Click + X	Open "Save" dialog	Used in Future_Wars

GP2XWiz

Touchscreen:
Buttons	Action	Notes
Touchscreen	Move Pointer and process 'Tap Mode' on touch.
Left Trigger + Y	Toggle Touchscreen 'Tap Mode'	Adjusts the 'on tap' response, it cycles from 'Left Click' (Default), 'Right Click' and 'Hover'.
Left Trigger + Touchscreen 'Tap'	Force the touchscreen 'Tap' to simulate a 'Right Click' regardless of the 'Tap Mode'.	Ideal for quickly simulating a 'Right Click' in games without changing the configured 'Tap Mode'.

Mouse Emulation:
Buttons	Action	Notes
dPad Joystick	Move Pointer
B	Left Click
X	Right Click

Keyboard Emulation:
Buttons	Action	Notes
Menu	Display in-game menu if supported	Save, Load, Quit etc.
Select	Escape
Y	Space Bar
Right Trigger	Return
Volume -/+	Set Volume

Button Combinations:
Buttons	Action	Notes
Left Trigger + Right Trigger	Display the ScummVM Virtual Keyboard	Ideal for entering 'Save Game' names or 'Copy Protection' information.
Left Trigger + Menu	Display the Global ScummVM Main Menu	Return to launcher and setup system options
Left Trigger + Select	Exit ScummVM gracefully	Please exit ScummVM doing this or via the menu, do not just turn off your Caanoo or you can loose save games
Left Trigger + A	Open "Predictive Text" entry dialog	Used in AGI games as long as a suitable dictionary is available

iPhone / iPod Touch

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.

LinuxMoto

Game Controller Mapping - pkg (A1200, E6, A1600) (motoezx):
Buttons	Action
Call key	Menu
Hangup key	Skip Scene
Camera key	Virtual Keyboard
joy(fire) or volume '-'	Left Click
volume '+'	Right Click
mod+camera key (mod - key beetwin vol'+' & vol'-')	Quit

Game Controller Mapping - mgx, mpkg, pep (E8, EM30, U9, ZN5, Z6, V8, VE66, EM35) (motomagx):
Buttons	Action
Left softkey	Menu
Hangup key	Skip Scene
Right softkey	Virtual Keyboard
joy(fire) or volume '-'	Left Click
volume '+'	Right Click
Clr key	Quit

Maemo

N810 Mapping:
Button	Action
Menu	Global Main menu
Fullscreen	Toggle Fullscreen
Zoom+	Right Click
Zoom-	Switch (left) clicking mode
CTRL + Zoom-	Virtual Keyboard
Home	Remap Keys

N800 Mapping:
Button	Action
Menu	Global Main menu
Fullscreen	Virtual Keyboard
Zoom+	Right Click
Zoom-	Switch (left) clicking mode
Home	Remap Keys

N900 Mapping:
Button	Action
CTRL + SHIFT + m	Global Main menu
Zoom+	Right Click
Zoom-	Switch (left) clicking mode
CTRL + Zoom-	Virtual Keyboard

Nintendo 64

Game Controller Mapping:
Button	Action
Left Trigger	ESC
Right Trigger	Virtual Keyboard
Analog	Mouse Movement
D-Pad	Slow Mouse Movement
Start	F5 / Main menu in some games
Z	Mouse Left Button
B	Mouse Right Button
A	. / Skip dialogues in some games
C buttons	Numeric keypad keys

In addition to the gamepad you can use the Nintendo 64 mouse like a normal PC mouse.

Nintendo DS

Game Controller Mapping - right-handed mode (default):
Button	Action
Pad Left	Left mouse button mode
Pad Right	Right mouse button mode
Pad Right	Hover mouse mode
Pad Down	Skip dialogue line (for some LucasArts games), Show inventory (for Beneath a Steel Sky), Show active objects (for Simon the Sorcerer)
Start	Pause/game menu (works in some games)
Select	DS Options
B	Skip cutscenes
A	Swap main screen and zoomed screen
Y	Show/Hide debug console
X	Show/Hide on-screen keyboard
L + D-pad or L + Pen	Scroll touch screen view
L + B	Zoom in
L + A	Zoom out
Game Controller Mapping - left-handed mode:
Button	Action
Y	Left mouse button mode
A	Right mouse button mode
X	Hover mouse mode
B	Skip dialogue line (for some LucasArts games), Show inventory (for Beneath a Steel Sky), Show active objects (for Simon the Sorcerer)
Start	Pause/game menu (works in some games)
Select	DS Options
D-pad down	Skip cutscenes
D-pad up	Swap main screen and zoomed screen
D-pad left	Show/Hide debug console
D-pad right	Show/Hide on-screen keyboard
LR+ D-pad or R + Pen	Scroll touch screen view
R + D-pad down	Zoom in
R + D-pad right	Zoom out

You can switch between the right-handed and left-handed mode using the DS Options (Select button).

An icon on the top screen will show you which mouse mode you're in.

Left mouse button mode	Right mouse button mode	Mouse hover mode

In hover mode, there are some additional controls. While holding the pen on the screen, tapping D-pad left or D-pad right (or A/Y in left handed mode) will click the left or right mouse button.

There is an alternative method of control which doesn't require you to change modes with the D-pad. Press 'Select' to bring up the DS options, and choose 'Tap for left click, double tap for right click'. In this mode, you can quickly tap the screen to left click the mouse, and tap twice to right click the mouse.

Some games also have specific controls that are listed in the table below.

Game Controller Mapping - Game-specific controls:
Button	Action
Sam and Max Hit the Road
D-pad right	Cycle through cursor modes
Indiana Jones games' Fighting mode (activated in DS Option)
D-pad left	Move left
D-pad right	Move right
D-pad up	Guard up
D-pad down	Guard down
Y	Guard middle
X	Punch high
A	Punch middle
B	Punch low
Left shoulder	Fight towards the left
Right shoulder	Fight towards the right
Beneath a Steel Sky
D-pad down	Show inventory
Simon the Sorcerer 1/2
D-pad down	Show active objects
AGI games
Start	Show the menu bar
Bargon Attack
Start	Hit F1 when you need to start the game (use the on-screen keyboard for other function keys)

Nintendo Switch

Game Controller Mapping:
Button	Action
Left stick	Mouse
R + Left stick	Slow Mouse
B	Left mouse button
A	Right mouse button
DPad	Keypad "Cursor" Keys (useful for character motion in Sierra games)
R + DPad	Diagonal Keypad "Cursor" Keys
L Trigger	Game menu (F5)
R Trigger	Shift (used to enable Mass Add in menu)
Y	Period '.' (used to skip dialog lines)
R + Y	Space ' '
X	Escape (used to skip cutscenes)
R + X	Return
Plus	ScummVM's global in-game menu
Minus	Toggle virtual keyboard
R + Minus	AGI predictive input dialog
Touch Controls (Touchpad Mouse Mode Off, Default):
Touch	Action
short single finger tap	Move pointer to finger position and left mouse button click
short second finger tap while holding one finger	Move pointer to first finger position and right mouse button click
single finger drag	Move pointer directly with finger
dual finger drag (long second finger tap while holding one finger)	Move pointer while left mouse button is held down (drag'n'drop). The pointer directly follows the first finger. The drag is ended when the last finger is removed.
triple finger drag (long second and third finger tap while holding one finger)	Move pointer while right mouse button is held down (drag'n'drop). The pointer directly follows the first finger. The drag is ended when the last finger is removed.
Touch Controls (Touchpad Mouse Mode On):
Touch	Action
short single finger tap	Left mouse button click
short second finger tap while holding one finger	Right mouse button click
single finger drag	Move pointer indirectly with finger, pointer speed can be adjusted in control settings
dual finger drag (long second finger tap while holding one finger)	Move pointer while left mouse button is held down (drag'n'drop). The pointer motion is affected by the first finger. The drag is ended when the last finger is removed.
triple finger drag (long second and third finger tap while holding one finger)	Move pointer while right mouse button is held down (drag'n'drop). The pointer motion is affected by the first finger. The drag is ended when the last finger is removed.

Notes:

• Physical USB mice and keyboards work on the Switch and are supported by ScummVM. All keyboards work. Not all mice work. A mouse compatibility list is available here

• For multi-touch gestures, the fingers have to be far enough apart from each other, so that the Switch will not erroneously recognize them as a single finger. Otherwise the pointer will jump around.

• The touch control scheme can be switched in the main menu via "options->controls->touchpad mouse mode"

• When touchpad mouse mode is off (default), the touch controls are direct. The pointer always jumps to the finger.

• When touchpad mouse mode is on, the touch controls are indirect. The finger can be far away from the pointer and still move it, like on a laptop touchpad. The pointer speed setting in "options->controls" affects how far the pointer moves in response to a finger movement.

• The two finger drag is useful for Full Throttle to bring up the action menu, and in the menu to use the scroll bar in the game list. It works in the following way: holding down two fingers for a while initiates a drag'n'drop where the left mouse button is being held down. The first finger affects mouse motion during the drag, the second finger can be removed without affecting the drag. When the last finger is removed, the left mouse button is released and the drag is over. Note the second finger can be anywhere, it doesn't have to be close to the first finger, and it doesn't have to be put down simultaneously with the first finger, either.

• Typical usage of dual finger drag and drop in Full Throttle: Hold down one finger over an object. Then hold down a second finger somewhere on the screen for a little bit to initiate a dual finger drag. This brings up the action menu. Now let go of the second finger. The dual-finger drag continues since one finger is still down. Select an action with the first finger, and let go of the first finger to end the drag.

• There is also a three finger drag that causes the right-mouse button to be held down, instead of the left one. It might be useful for some games.

OpenPandora

Touchscreen:
Buttons	Action	Notes
Touchscreen	Move Pointer and process 'Tap Mode' on touch.
Y	Toggle Touchscreen 'Tap Mode'.	Adjusts the 'on tap' response, it cycles 'Left Click' (Default), 'Right Click', 'Hover' and 'Hover - DPad Click'. 'Hover - DPad Click' is just what is suggests. You can use a press on the DPad to create a left click wherever the stylus is pressing on the screen and hover at all other times.
Left Trigger + Touchscreen 'Tap'.	Force the touchscreen 'Tap' to simulate a 'Right Click' regardless of the 'Tap Mode'.	Ideal for quickly simulating a 'Right Click' in games without changing the configured 'Tap Mode'.
A + Touchscreen 'Tap'.	Left Click.	Ideal for Left Handed users of the touchscreen when combined with the hover 'Tap Mode'.
B + Touchscreen 'Tap'.	Right Click.	Ideal for Left Handed users of the touchscreen when combined with the hover 'Tap Mode'.

Mouse Emulation: (Default Nub Settings)
Buttons	Action	Notes
Left Nub	Move Pointer.
Right Nub moved Left	Left Click.
Right Nub moved Right	Right Click.

Keyboard/Buttons: Wherever possible the keyboard layout has been kept the same as the desktop versions of ScummVM. Only OpenPandora specific button layouts are shown below. Normal keys should behave as you expect.
Buttons	Action	Notes
dPad	Cursor Keys.	Ideal for AGI games.
X	Display the Global ScummVM Main Menu in supported engines.	Return to launcher, setup system options and save/load.

Button Combinations:
Buttons	Action	Notes
Start/Ctrl + Q	Exit ScummVM gracefully	Please exit ScummVM doing this or via the menu, do not just turn off your OpenPandora you can loose save games.

PlayStation 2

TODO

PlayStation 3

Touchscreen:
Buttons/Control	Action	Notes
Left stick	Move Pointer
Cross	Left Mouse Button
Circle	Right Mouse Button
Triangle	Game Menu (F5)
Square	Escape
Start	ScummVM's Global Main Menu (Crtl+F5)
Select	Toggle Vitual Keyboard
L1	AGI Predictive Input Dialog

PSP

Game Controller Mapping:
Button	Action
Right trigger	Modifier key (see below for uses)
Left trigger	ESC (Usually skips cutscenes. Depends on game)
Analog	Mouse movement
Right trigger + Analog	Fine mouse movement
D-Pad	Arrow keys (useful mostly in SCI and AGI games)
D-Pad + Right Trigger	Diagonal arrow keys (it's hard to input diagonals on some PSPs)
Triangle	Enter (useful for some dialogs)
Cross	Left Mouse Button (usually the main button)
Circle	Right Mouse Button (secondary button in some games)
Square	'.' (skip dialogue in some games e.g. Scumm)
Right trigger + Square	Spacebar (useful in Gobli*ns and SCI games)
Right trigger + Start	F5 (Main Menu in some games)
Select	Show/Hide Virtual Keyboard. Hold down to move keyboard onscreen (with D-Pad).
Right trigger + Select	Show Image Viewer (see below)
Start	Global Menu. Allows you to 'Return To Launcher' to play another game
Virtual Keyboard Mode:
Start	Enter key. Also exits virtual keyboard mode
Select	Exit the virtual keyboard mode
Right trigger	Input letters: lowercase/uppercase (press to toggle)
Left trigger	Input numbers/symbols (press to toggle)
D-Pad	Select square of characters (up, down, left or right)
Buttons/Triggers	Choose a specific character in the square. The four center characters are chosen by the button in the corresponding position. The 2 top characters are chosen by the triggers.
Analog	Moves in a direction (left/right/up/down) (Useful to keep moving while typing in AGI games among other things)
Image Viewer:
Left/Right	previous/next image (e.g. go from psp_image1.png to psp_image2.png)
Up/down	zoom in/out
Analog	move around the image
Triggers, Start	exit image viewer
1st Person Game Mode (Can be ignored by most users):
Right Trigger + Left Trigger + Square	Enable 1st Person Mode
Square	Is the modifier key instead of Right Trigger.
Left/Right Trigger	Strafe left/right
D-Pad Left/Right	Turn left/right
Square + D-Pad	F1/F2/F3/F4
Square + Select	Image Viewer
Square + Start	Esc (shows game menu)

Vita

Game Controller Mapping:
Button	Action
Left stick	Mouse
R + Left stick	Slow Mouse
Cross	Left mouse button
Circle	Right mouse button
DPad	Keypad "Cursor" Keys (useful for character motion in Sierra games)
R + DPad	Diagonal Keypad "Cursor" Keys
L Trigger	Game menu (F5)
R Trigger	Shift (used to enable Mass Add in menu)
Square	Period '.' (used to skip dialog lines)
R + Square	Space ' '
Triangle	Escape (used to skip cutscenes)
R + Triangle	Return
Start	ScummVM's global in-game menu
Select	Toggle virtual keyboard
R + Select	AGI predictive input dialog
Front Panel Touch Controls, always enabled (from version 2.1.0):
Touch	Action
short single finger tap	Move pointer to finger position and left mouse button click
short second finger tap while holding one finger	Move pointer to first finger position and right mouse button click
single finger drag	Move pointer directly with finger
dual finger drag (long second finger tap while holding one finger)	Move pointer while left mouse button is held down (drag'n'drop). The pointer directly follows the first finger. The drag is ended when the last finger is removed.
triple finger drag (long second and third finger tap while holding one finger)	Move pointer while right mouse button is held down (drag'n'drop). The pointer directly follows the first finger. The drag is ended when the last finger is removed.
Back Panel Touch Controls, enabled via Touchpad Mouse Mode option (from version 2.1.0):
Touch	Action
short single finger tap	Left mouse button click
short second finger tap while holding one finger	Right mouse button click
single finger drag	Move pointer indirectly with finger, pointer speed can be adjusted in control settings
dual finger drag (long second finger tap while holding one finger)	Move pointer while left mouse button is held down (drag'n'drop). The pointer motion is affected by the first finger. The drag is ended when the last finger is removed.
triple finger drag (long second and third finger tap while holding one finger)	Move pointer while right mouse button is held down (drag'n'drop). The pointer motion is affected by the first finger. The drag is ended when the last finger is removed.

Notes:

• For multi-touch gestures, the fingers have to be far enough apart from each other, so that the Vita will not erroneously recognize them as a single finger. Otherwise the pointer will jump around.

• Real bluetooth mice and keyboards work on the Vita and are supported by ScummVM. This was tested working with Jelly Bean BT keyboard and mouse combo ASIN:B06Y56BBYP and with the standalone Jelly Comb Bluetooth Wireless Mouse ASIN:B075HBDWCF. Not all bluetooth keyboards or mice pair successfully with the Vita. Use settings->devices on the Vita home screen to try and pair your devices.

• Touch control mode can be changed via the option "touchpad mouse mode" in options->controls.

• The front touch always uses a direct mode, where the mousepointer jumps to the finger position (like on a mobile phone screen).

• When "touchpad mouse mode" is off, the rear touch is disabled.

• When "touchpad mouse mode" is on, the rear touch is enabled in addition to front touch. The rear touch uses an indirect mode, where the finger can be far away from the pointer and still move it, (like on a laptop touchpad). The pointer speed setting in options->controls affects how far the pointer moves in response to a finger movement on the rear panel.

• The advanced option "frontpanel_touchpad_mode=false" in scummvm.ini can be changed with a texteditor to "frontpanel_touchpad_mode=true" . This forces the front panel into an indirect mode similar to the rear panel. If this option is set, the pointer does not jump to the finger anymore.

• The two finger drag is useful for Full Throttle to bring up the action menu, and in the menu to use the scroll bar in the game list. It works in the following way: holding down two fingers for a while initiates a drag'n'drop where the left mouse button is being held down. The first finger affects mouse motion during the drag, the second finger can be removed without affecting the drag. When the last finger is removed, the left mouse button is released and the drag is over. Note the second finger can be anywhere, it doesn't have to be close to the first finger, and it doesn't have to be put down simultaneously with the first finger, either.

• Typical usage of dual finger drag and drop in Full Throttle: Hold down one finger over an object. Then hold down a second finger somewhere on the screen for a little bit to initiate a dual finger drag. This brings up the action menu. Now let go of the second finger. The dual-finger drag continues since one finger is still down. Select an action with the first finger, and let go of the first finger to end the drag.

• There is also a three finger drag that causes the right-mouse button to be held down, instead of the left one. It might be useful for some games.

Symbian

TODO

Wii

TODO

Windows CE

See Windows CE controls

TODO: move the content to this page