Nintendo Switch

This page contains all the information you need to get ScummVM up and running on a Nintendo Switch.

What you’ll need

A homebrew-enabled Nintendo Switch console. How to enable homebrew is outside the scope of this documentation.

Installing ScummVM

The Nintendo Switch package is available for download on the ScummVM Downloads page.

Download the zip file to a computer, and extract the files.

Copy the extracted scummvm folder to your Nintendo Switch microSD card, into the /switch/ folder.

Transferring game files

Copy the folders containing game files into the /switch/scummvm/ folder on the microSD card.

ScummVM on the Nintendo switch supports cloud functionality.

See Handling game files for more information about game file requirements.

Controls

Default control map

These controls can also be manually configured in the Keymaps tab. See the Keyboard shortcuts page for common keyboard shortcuts.

Button	Action
Left stick	Mouse
Left stick + R button	Slow Mouse
Ⓑ	Left mouse button
Ⓐ	Right mouse button
Directional buttons	Keypad ‘Cursor’ Keys
Directional buttons + R button	Diagonal Keypad ‘Cursor’ Keys
L button	Game menu (F5)
R button	Shift
Ⓨ	Period
Ⓨ + R button	Space
Ⓧ	Escape
Ⓧ + R button	Return
	Global main menu (GMM)
	Toggle virtual keyboard
+ R button	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
Two finger drag	Move pointer while left mouse button is held down (drag and drop). The pointer directly follows the first finger. The drag is ended when the last finger is removed.
Three finger drag	Move pointer while right mouse button is held down (drag and 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
Two finger drag	Move pointer while left mouse button is held down (drag-and-drop). The pointer motion is affected by the first finger. The drag is ended when the last finger is removed.
Three finger drag	Move pointer while right mouse button is held down (drag-and-drop). The pointer motion is affected by the first finger. The drag is ended when the last finger is removed.

Keyboard and mouse support

Physical USB mice and keyboards work on the Switch and are supported by ScummVM. All keyboards work but not all mice work. A mouse compatibility list is available on this Google Sheet.

Touch support

For multi-touch gestures, the fingers have to be far enough apart from each other that the Switch does not recognize them as a single finger, otherwise the pointer jumps around.

The touch control scheme can be switched in the global settings. From the Launcher, go to Options > Control > Touchpad mouse mode.

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

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 the Controls tab affects how far the pointer moves in response to a finger movement.

Two finger drag

Hold down two fingers to initiate a drag-and-drop feature. The two finger drag simulates the left mouse button 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.
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.

Three finger drag

Hold down the three fingers to initiate a drag-and-drop feature. The three finger drag simulates the right mouse button being held down.

Paths

Saved games

/switch/scummvm/saves

Configuration file

/switch/scummvm/scummvm.ini

Settings

For more information, see the Settings section of the documentation. Only platform-specific differences are listed here.

Audio

Supported devices:

MT-32 emulator
FluidSynth (General MIDI emulator)
AdLib emulator

Supported audio file formats:

MP3
OGG
FLAC
Uncompressed audio

Controls

See the Touch support section.