Changes

Note The recommended toolchain for building RetroArch on Windows is MinGW- w64 running inside the following is MSYS2 environment. Installers for 64-bit Windows onlyMSYS2 can be found at [https://msys2.github.io/ msys2.github.io]. 32Other toolchains like TDM-bit Windows GCC or Visual Studio can work, but this guide will need to get 32-bit MinGW instead and use 32-bit headers and libs for RetroArchonly cover MSYS2.

Download ==Preparing the prepackaged toolchain from [https://www.dropbox.com/sh/91sakv0qdyxjx9f/0jhM7OoWBP/dev_tools/RetroArch_MinGW64_gcc-4.8.2.7z here].environment==

Extract Once you have installed MSYS2, you will need to update it somewhere, for example C:\MinGWand install the toolchain packages.

Run Git Bash===Updating MSYS2=== First, start the MSYS2 Shell entry that should be present in your Start Menu. Updating your install is a multiple step operation: first you update the core, then you have to rehash the environment and finally you'll be able to properly update the rest of the system. Once you are in the MSYS2 Shell terminal, run the following commands to upgrade the core MSYS2 packages:  pacman --noconfirm -Sy pacman --needed --noconfirm -S bash pacman pacman-mirrors msys2-runtime Once the window closes, open the MSYS2 Shell again and type <code>pacman --noconfirm -Su</code> then repeat the previous operation to finish the process.Note: If you get fork errors, the second step may have failed. You should go to your msys2 install directory and run <code>autorebase.bat</code> manually.vbsIf that didn't solve the problem consider reinstalling msys2. Then do  ===Installing the build time dependencies=== The following commandswill install everything you need to build RetroArch in your MSYS2 environment. *For 32 bit builds run:  pacman -S --noconfirm --needed git make mingw-w64-i686-toolchain mingw-w64-i686-pkg-config mingw-w64-i686-SDL2 mingw-w64-i686-libxml2 mingw-w64-i686-freetype mingw-w64-i686 python3 mingw-w64-i686-ffmpeg *For 64 bit builds:  pacman -S --noconfirm --needed git make mingw-w64-x86_64-toolchain mingw-w64-x86_64-pkg-config mingw-w64-x86_64-SDL2 mingw-w64-x86_64-libxml2 mingw-w64-x86_64-freetype mingw-w64-x86_64-python3 mingw-w64-x86_64-ffmpeg For the nvidia-cg-toolkit packages, you will need to download the pkg manually from Sourceforge to your home directory for [http://sourceforge.net/projects/msys2/files/REPOS/MINGW_GCC_4_9/i686/mingw-w64-i686-nvidia-cg-toolkit-3.1-2-any.pkg.tar.xz/download 32-bit] or [http://sourceforge.net/projects/msys2/files/REPOS/MINGW_GCC_4_9/x86_64/mingw-w64-x86_64-nvidia-cg-toolkit-3.1-2-any.pkg.tar.xz/download 64-bit], then use pacman to install them. *32-bit:  pacman -U --noconfirm mingw-w64-i686-nvidia-cg-toolkit-3.1-2-any.pkg.tar.xz *64-bit:  pacman -U --noconfirm mingw-w64-x86_64-nvidia-cg-toolkit-3.1-2-any.pkg.tar.xz After installing the packages, close the MSYS2 shell and open either MinGW-w64 Win64 Shell for 64 bit builds or MinGW-w64 Win32 Shell if you want to build for 32 bit systems. Both should be available in your Start Menu. ==Cloning RetroArch and libretro repositories== Once you are running the MSY2 MinGW-w64 Shell, then you will need to clone the RetroArch and libretro Git repositories.

sh ./libretro-fetch.sh

You should now have all This will fetch every repository in the libretro organization on Github into <code>%MSYS2%/home/%USERNAME%/</code> . Since there are a lot of repositories cloned in the libretro-super folder within your MinGW folderto download, this will take a while to complete. You can use <code>libretro-fetch.sh </code> again to update all repositories. Just as a tip, always do a "git pull" to update the repository and "make clean" to clean up old build files before building anythingyou can fetch repositories individually by specifying their name e.g. <code>. /libretro-j sets the number of jobs to do simultaneously, if you have a quad-core CPU, use -j4fetch. sh mednafen_psx</code>

It should update after that. If not, delete the whole repository and run <code>libretro-fetch.sh </code> again.

==To build Building RetroArch:==Download To build RetroArch from the MSY2 MinGW-w64 Shell, execute the [httpfollowing://themaister.net  cd libretro-super/retroarch&& git pull && git submodule update -dl/RetroArch-win64-headersinit && .zip headers] and [http:/configure && make clean && make -j4 You should see a list of files being compiled, ending with <code>LD retroarch</themaistercode>. You can then copy the newly compiled <code>retroarch.netexe</code> from <code>libretro-super\retroarch-dl</code> to wherever you keep your RetroArch-win64-libsinstallation.zip libs] and extract them  If you want to do a debug build, then execute the folder where following:  make clean make DEBUG=1 GL_DEBUG=1 -j4 mv retroarch.exe retroarch_debug.exe This build will have all of the RetroArch repository was cloned debug symbols intact and will be built with compiler optimizations turned off, so it can be run through a debugger like gdb. If you are experiencing a missing DLL error, you can fetch all MSYS2 installed DLLs by executing this line:  for i in $(seq 3); do for bin in $(ldd *exe *dll | grep -i mingw | cut -d\libretro -f 3); do cp -super\vu "$bin" . ; done; done Video filters and Audio DSP filters are compiled by going into gfx/filters and audio/filters, respectively, and running make on the Makefile. For example  cd retroarch if cd gfx/filters make clean make After they build, you used can copy the filters to your RetroArch installation. ==Building libretro cores== After running the fetch script), you should have a folder for each libretro core in your libretro-super folder. You can use <code>libretro-build.sh</code> to build all cores at once:  cd libretro-super ./libretro-build.sh This will attempt to build almost every core available. Then execute these commands from the Git Bash shellThis can take quite a while to complete, so you may wish to build cores individually:

cd retroarch./libretro-build.sh mednafen_psx git pull make The exact names for fetching or building individual cores can be found in the [https://github.com/libretro/libretro-f Makefilesuper/blob/master/rules.win clean make d/core-f Makefilerules.sh /rules.win d/core-j4rules.sh] script.

You should see a list of files being compiled, ending with "LD RetroArch.exe". You can then copy the newly compiled retroarch.exe and \tools\retroarchCores that build successfully are put in <code>/dist/win</code> or <code>/dist/win_x64</code> in your libretro-joyconfigsuper folder.exe from Be sure to run <code>libretro-super\retroarch fetch.sh</code> to wherever you keep update your RetroArch installationlocal Git clones before building.

==To build libretro Building cores:manually==

After running If you wish, you can build cores manually if you want more control over the fetch scriptbuild process, you should have a folder though it's not recommended for each libretro core in your libretro-super folderinexperienced users. For most cores , all you need to do is do:

If there isn't a Makefile or Makefile.libretro in the top level, try to find a "libretro" folder within the repository and there should be a makefile Makefile in there. After the core is built, it will be in the same folder as the makefile Makefile used to compile it. The following need only <code>make</code>:* 4do-libretro* blastem-libretro* any 'beetle' source* cannonball* daphne* Dinothawr* FreeIntv* freej2me (inside <code>/src/libretro</code>)* Gearboy (inside <code>/platforms/ibretro</code>)* libretro-atari800* libretro-cap32* libretro-chailove* libretro-crocods* libretro-lutro* libretro-o2em* libretro-uae* melonDS* Mesen (inside <code>/Libretro</code>)* mrboom-libretro* mupen64plus-libretro* nestopia (inside <code>/libretro</code>)* nxengine-libretro* parallel-n64* ppsspp (inside <code>/libretro</code>)* prosystem-libretro* reicast-emulator* REminiscence* SameBoy (inside <code>/libretro</code>)* scummvm (inside <code>/backends/platform/libretro/build</code>)* snes9x (inside <code>/libretro</code>)* stella-libretro* tgbdual-libretro* theodore* virtualjaguar-libretro* yabause (inside <code>/libretro</code>) The following need <code>make -f Makefile.libretro</code>:* 81-liberetro* blueMSX-libretro* Craft* desmume (inside <code>/desmume</code>)* dosbox-libretro* easyrpg-libretro (inside <code>/builds/libretro</code>)* fbalpha (NOTE: makefile.libretro is **all-lowercase**.)* fuse-libretro* gambatte-libretro* Genesis-Plus-GX* gw-libretro* Hatari* libretro-JamVM* libretro-meowPC98 (inside <code>/libretro</code>)* libretro-vecx* mgba* NP2kai (inside <code>/sdl2</code>)* picodrive* px68k-libretro* PokeMini* snes9x-next* vba-next The following cores also require the running of <code>git submodule update --init</code>: * dolphin* libretro-ppsspp* picodrive Some cores need special commands for building: ===bsnes===  make profile='%PROFILE%' clean make profile='%PROFILE%' -j4

Refer to the [https://github.com/libretro/libretro-super/blob/master/libretro-build-common.sh libretro-build-common.sh] for exact commands for each coreReplace %PROFILE% with accuracy, balanced, or performance.

cd libretro-super sh libretro-buildDolphin requires Cmake now. Its information on the Libretro core is inside <code>/Source/Core/DolphinLibretro</code>.sh

MAKE=makecd libretro CC=gcc CXXmake -f Makefile.%TARGET% MACHINE=g++%MACH%

Cores that build successfully are put in /dist/win in your libretroReplace %TARGET% with the device to which you plan on building the core (e.g. linux-super folderportable_x86_64, mingw_x86...)Replace %MACH% with any one of the following devices: chip8, gc, nes, sms.

cd libretro-mame make -f Makefile.libretro PTR64=1 clean make -f Makefile.libretro PTR64==bSNES Performance===1 -j4

cd libretro-bsnes/perf make ui='target-libretro' profileThis core will take a while to build, depending on how fast your CPU is, how many jobs you specify, and how many cores your CPU has. You can save some time updating the core by adding PARTIAL='performance' 1 when doing a clean make ui. You can specify a subtarget by adding e.g. <code>SUBTARGET='target-libretro' profilearcade</code> or <code>SUBTARGET='performance' -j4tiny</code> in the current version of MAME.

===bSNES BalancedRedream===Redream requires Cmake.

cd libretro-bsnes/balanced make ui='target==Rustation-libretro' profile='balanced' clean== Rustation is written in Rust, not C or C++; neither make ui='target-libretro' profile='balanced' -j4nor Cmake would work.

=Building on Linux==bSNES Accuracy===Building on Linux is similar to building on Windows.

To make a build with NOTE: Compilation may fail if you do not have the dynarec availablefollowing installed:

cd libretro* g++* libgl1-mesa-dev* libsdl2-mupen64plusdev make WITH_DYNAREC=x86_64 clean* mesa-common-dev make WITH_DYNAREC=x86_64 * pkg-j4config

Download and install [http* alsa (libsdl2-dev)* libpulse (libpulse-dev)* lossaudo* lopenal (libopenal-dev)* jack* libroar (libroar-dev) WARNING://www.python.org/ftp/python/2.7.5/python-2.7.5.amd64.msi Python 2.7.5] to the default locationThis might break your compilation.* rsound

make -f Makefile.libretro PTR64=1 PYTHON="Chttps:/Python27/pythonwwww.exe" clean make -f Makefileraspberrypi.libretro PTR64=1 PYTHON="C:org/Python27forums/pythonwviewtopic.exe" -j4php?f=78&t=56070

This core will take a while to build, depending The above might work on how fast your CPU is, how many jobs you specifyregular desktop Linux, and how many cores your CPU hastoo.

Libretro-super is a series of scripts used to ease the compilation and installation of each and every libretro emulation core and RetroArch itself. Thus this is the simplest route to a fully functional installation. If you need or want to build each core individually then you can refer to the [https[Category://github.com/libretro/libretro-super/blob/master/libretro-build-common.sh build-common.shFAQs]] script for direction. git clone git[[Category://github.com/libretro/libretro-super.git cd libretro-super sh libretro-fetch.sh sh libretro-build.sh sh libretro-install.sh <path where you'd like RetroArch installed>]]