aboutsummaryrefslogtreecommitdiff
path: root/backends/platform/sdl/switch/README.SWITCH
blob: fc49130623ccbfb5f30e4ea0237a1d5cd164c2aa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
ScummVM-Switch README
==============================================================================

Installation
============
 - The latest daily version of ScummVM for Switch is [here](https://buildbot.scummvm.org/snapshots/master/switch-master-latest.zip) (needs to be unzipped).
 - Copy the scummvm folder to your SD card into the folder /switch/ so that you have a folder `/switch/scummvm` with `scummvm.nro` and other folders inside.
 - Launch ScummVM using your favorite method to launch homebrew on the Switch

Notes
=====
 - This README may be outdated, for more up-to-date instructions and notes see
   the Switch Port Wiki: https://wiki.scummvm.org/index.php/Nintendo_Switch

Building the source code
========================
This port of ScummVM to the Switch is based on SDL2. It uses the open source SDK provided by devkitPro.

To build ScummVM for Switch:

 - Obtain the ScummVM source code (https://github.com/scummvm/scummvm)

 - Install the development tools for Switch following the official instructions (https://devkitpro.org/wiki/Getting_Started)

 - Install libraries via
```
sudo dkp-pacman -S \
switch-sdl2 \
switch-libmad \
switch-libogg \
switch-libvorbis \
switch-flac \
switch-libtheora \
switch-libpng \
switch-libjpeg-turbo \
switch-zlib \
switch-freetype \
switch-sdl2_net \
switch-curl \
switch-libtimidity \
switch-pkg-config
```

 - Create a subdirectory somewhere outside the source folder for your ScummVM build and cd into it

 - Execute the command (once a curl-config script exists for devkitA64, the --disable-libcurl could be omitted)
```
../scummvm/configure --host=switch --disable-libcurl
```

 - Execute the command
```
make scummvm_switch.zip
```

Port Authors
============
cpasjuste

Thanks
======
[devkitPro](https://devkitpro.org devkitPro) and [Switchbrew](https://switchbrew.org/) teams