Cross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.
Go to file
2018-03-04 19:34:57 +01:00
.github Rename PULL_REQUEST_TEMPLATE to PULL_REQUEST_TEMPLATE.md 2017-11-29 12:03:42 -05:00
.vscode subsystem part 2: add LABELS 2018-02-12 02:39:24 -05:00
audio (msvc) CXX_BUILD + griffin fixes. 2018-02-05 00:25:03 +01:00
bootstrap Merge pull request #5941 from frangarcj/vita-adrenaline 2017-12-21 01:05:28 +01:00
camera Refactor verbosity code - try to avoid log calls if verbosity is not 2018-01-17 06:28:26 +01:00
cheevos Reset Add buffer when hit condition is triggered 2018-02-15 14:30:46 -05:00
cores Update libretro-mpv core - only use dlopen for HAVE_OPENGLES builds 2018-02-23 14:40:31 +01:00
ctr (CTR) build fix. 2017-12-25 08:51:50 +01:00
defines Cleanups 2018-01-25 15:30:48 +01:00
deps UINT32_MAX not defined on random platforms even though we are including 2018-02-07 01:10:14 +01:00
dist-scripts Update 2018-02-18 02:08:18 +01:00
docs mark these as deprecated 2016-08-27 21:56:37 -05:00
emscripten emscripten: Use argument list for Module.print 2018-01-15 10:06:06 -05:00
frontend Fix UNIX build 2018-02-25 20:49:44 +01:00
gfx Take out d3d_common function call from d3d_w32_font.c 2018-03-03 05:42:14 +01:00
griffin Get rid of d3d context drivers 2018-03-02 17:23:43 +01:00
input Merge pull request #6329 from markand/fix-vid-pid 2018-02-26 18:39:33 +01:00
intl Added changes recommended by Tatsuya79 2018-03-04 19:34:57 +01:00
led Add frontend, battery level and memory amount detection to 3ds port 2018-01-10 16:52:32 -08:00
libretro-common Create string_is_equal_case_insensitive 2018-03-01 23:16:34 +01:00
libretro-db Don't use mmap for libretrodb - using mmap seems 2018-02-13 07:34:19 +01:00
location Refactor verbosity code - try to avoid log calls if verbosity is not 2018-01-17 06:28:26 +01:00
managers Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
media explicitly set codepage for Japanese menubar translation, fixes #4536 and #4761 2017-09-22 09:40:22 -07:00
memory Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
menu Remove unused variables 2018-03-01 22:28:26 +01:00
network Fix bug in string length in strlcpy. 2018-02-16 19:31:00 -05:00
pkg (Vulkan/D3D11/D3D12) Add HAVE_GLSLANG now to both Android and MSVC solutions - shaders 2018-03-02 02:14:29 +01:00
qb Disable D3D10 for now by default until it gets menu display driver 2018-02-15 12:46:37 +01:00
record Refactor verbosity code - try to avoid log calls if verbosity is not 2018-01-17 06:28:26 +01:00
tasks Remove unused variables 2018-03-01 22:28:26 +01:00
tools (D3D10/11/12) cleanups / fixes. 2018-01-30 19:34:53 +01:00
translation Cleanups 2018-01-26 04:37:53 +01:00
ui (msvc) CXX_BUILD + griffin fixes. 2018-02-05 00:25:03 +01:00
wifi Refactor verbosity code - try to avoid log calls if verbosity is not 2018-01-17 06:28:26 +01:00
wii Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
wiiu Update imports.h 2018-02-25 13:53:57 +00:00
.editorconfig Add EditorConfig support 2016-09-16 10:44:33 -04:00
.gitignore Add missing slash 2018-02-17 15:59:04 -08:00
.project
.travis.yml Squashed 'deps/SPIRV-Cross/' content from commit d4b0625cbd 2018-02-02 11:53:59 +01:00
autosave.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
CHANGES.md Update CHANGES.md 2018-03-02 02:18:49 +01:00
command.c shader code - Get rid of more hashes 2018-02-25 17:20:22 +01:00
command.h subsystem part 3: remove more globals 2018-02-12 02:39:25 -05:00
config.def.h Disable XMB shadow icons by default for PowerPC and ARM for performance 2018-03-01 17:34:08 +01:00
config.def.keybinds.h Removing long-obsolete now-disfunctional "netplay flip players" feature 2018-01-05 14:27:02 -05:00
config.features.h Remove remaining references to HAVE_FBO 2017-11-13 08:55:41 +01:00
configuration.c (configuration.c) 2018-02-17 11:55:39 +01:00
configuration.h add menu setting to toggle window decorations 2018-02-10 23:46:09 -05:00
configure
content.h subsystem part 3: fix saves 2018-02-12 02:39:26 -05:00
CONTRIBUTING.md
COPYING
core_impl.c (Menu) Menu driver no longer uses a duplicate system info 2017-05-28 17:21:57 +02:00
core_info.c (core_info.c) cleanup memory allocations 2018-02-04 23:07:24 +01:00
core_info.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
core_type.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
core.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
database_info.c (database_info.c) Cleanups 2018-02-25 21:58:52 +01:00
database_info.h Cleanups 2017-09-28 09:32:23 +02:00
defaults.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
dirs.c nitpicking fix: makes shader next start at the first shader 2018-02-19 20:01:23 -05:00
dirs.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
driver.c Reduce usage of string_is_not_equal_fast 2018-01-17 01:03:48 +01:00
driver.h Added an LED interface and a Raspberry Pi GPIO implementation 2017-12-27 11:11:08 -05:00
dynamic.c Refactor verbosity code - try to avoid log calls if verbosity is not 2018-01-17 06:28:26 +01:00
dynamic.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
fetch-submodules.sh Add --recursive in case submodules have third-party dependencies 2016-09-11 19:43:16 -04:00
file_path_special.c Simplify fill_pathname_representation_wrapper 2018-02-04 23:40:27 +01:00
file_path_special.h libretro-common: Clean up dependencies of file_path 2018-01-13 00:27:49 -05:00
file_path_str.c Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
lakka.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
list_special.c Conditionally build up shader list 2018-02-26 18:56:56 +01:00
list_special.h Fix more MSVC Griffin build errors 2017-12-30 13:35:47 +01:00
Makefile use 64-bit file offsets/seeking on windows 2018-02-14 06:16:12 +00:00
Makefile.common Get rid of d3d context drivers 2018-03-02 17:23:43 +01:00
Makefile.ctr Add 3DS threads 2018-01-17 14:00:57 -08:00
Makefile.ctr.salamander Remove -a from uname 2018-01-05 09:58:10 -08:00
Makefile.emscripten no longer compile with SDL support by default 2018-01-18 22:57:46 -06:00
Makefile.griffin SPIRV-Cross and glslang will compile with Griffin/MSVC targets now 2018-02-04 14:21:34 +01:00
Makefile.libogc Update 2017-08-20 00:54:39 +02:00
Makefile.msvc (D3D12) add menu display driver. 2018-02-08 00:18:05 +01:00
Makefile.openpandora Start removing SINC ifdefs for individual Makefiles 2017-12-31 21:34:31 +01:00
Makefile.pandora
Makefile.ps3 Start removing SINC ifdefs for individual Makefiles 2017-12-31 21:34:31 +01:00
Makefile.ps3.cobra Start removing SINC ifdefs for individual Makefiles 2017-12-31 21:34:31 +01:00
Makefile.ps3.salamander Define DEX_BUILD/CEX_BUILD/ODE_BUILD for PS3 versions - set 2017-12-23 08:12:39 +01:00
Makefile.psl1ght Remove remaining references to HAVE_FBO 2017-11-13 08:55:41 +01:00
Makefile.psp1 Start removing SINC ifdefs for individual Makefiles 2017-12-31 21:34:31 +01:00
Makefile.psp1.salamander Add vfs_implementation to Salamander builds 2017-12-14 15:18:48 +01:00
Makefile.switch (NSW) initial support for menu 2017-12-30 11:14:45 +01:00
Makefile.vita Reduce size of Makefiles 2017-12-07 05:54:54 +01:00
Makefile.vita.salamander Add vfs_implementation to Salamander builds 2017-12-14 15:18:48 +01:00
Makefile.wii.salamander Add vfs_implementation to Salamander builds 2017-12-14 15:18:48 +01:00
Makefile.wiiu Turn off WIIU_HID on master 2018-01-19 21:58:22 -08:00
Makefile.win Remove remaining references to HAVE_FBO 2017-11-13 08:55:41 +01:00
movie.c Update libretro-common 2017-12-15 00:31:37 +01:00
movie.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
msg_hash.c add basic support for arabic. 2018-02-05 20:54:55 +01:00
msg_hash.h subsystem part 2: add LABELS 2018-02-12 02:39:24 -05:00
no-xib.diff
paths.c subsystem part 3: fix saves 2018-02-12 02:39:26 -05:00
paths.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
performance_counters.c VC6 support (targets NT 3.51) 2017-09-06 23:03:02 -04:00
performance_counters.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
playlist.c Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
playlist.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
README-exynos.md
README-mali_fbdev_r4p0.md Fix some spelling errors (pendantic info lintian warnings). 2016-07-20 23:28:29 -03:00
README-OMAP.md
README.md Squashed 'deps/SPIRV-Cross/' content from commit d4b0625cbd 2018-02-02 11:53:59 +01:00
retroarch-android-debug.diff add patch to enable gdb/debugging on android 2018-03-01 16:01:04 -05:00
retroarch-mingw-build.sh
retroarch.c fix some potential crashes when a shader is not set in config 2018-02-07 21:26:01 -05:00
retroarch.cfg add menu setting to toggle window decorations 2018-02-10 23:46:09 -05:00
retroarch.desktop Making description more concrete and adding Russian translation 2017-11-22 19:04:59 +03:00
retroarch.h fix SHADER_NEXT/SHADER_PREV 2018-02-07 21:26:00 -05:00
setting_list.c (menu) Get rid of name_hash 2018-02-25 18:04:32 +01:00
setting_list.h (menu) Get rid of name_hash 2018-02-25 18:04:32 +01:00
verbosity.c Update and fix API error 2018-01-17 19:30:20 +01:00
verbosity.h Remove retro_inline 2018-01-17 06:47:49 +01:00
version_git.c Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
version_git.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
version.all Set 1.7.1 2018-02-17 16:43:51 +01:00
version.dtd Bump to version 1.7.0 2017-12-25 18:17:57 +01:00
version.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
wiiu-devel.properties.template Polish up WiiU deploy scripts 2018-01-10 22:51:00 -08:00

Build Status Coverity Scan Build Status

RetroArch

RetroArch is the reference frontend for the libretro API. Popular examples of implementations for this API includes videogame system emulators and game engines, but also more generalized 3D programs. These programs are instantiated as dynamic libraries. We refer to these as "libretro cores".

XMB menu driver

rgui menu driver

glui menu driver

libretro

libretro is an API that exposes generic audio/video/input callbacks. A frontend for libretro (such as RetroArch) handles video output, audio output, input and application lifecycle. A libretro core written in portable C or C++ can run seamlessly on many platforms with very little/no porting effort.

While RetroArch is the reference frontend for libretro, several other projects have used the libretro interface to include support for emulators and/or game engines. libretro is completely open and free for anyone to use.

libretro API header

Binaries

Latest Windows binaries are currently hosted on the buildbot.

Support

To reach developers, either make an issue here on GitHub, make a thread on the forum, or visit our IRC channel: #retroarch @ irc.freenode.org.

Documentation

See our Documentation Center. On Unix, man-pages are provided. More developer-centric stuff is found here.

Philosophy

RetroArch attempts to be small and lean, while still having all the useful core features expected from an emulator. It is designed to be very portable and features a gamepad-centric UI. It also has a full-featured command-line interface.

In some areas, RetroArch goes beyond and emphasizes on not-so-common technical features such as multi-pass shader support, real-time rewind (Braid-style), video recording (using FFmpeg), etc.

RetroArch also emphasizes on being easy to integrate into various launcher frontends.

Platforms

RetroArch has been ported to the following platforms:

  • DOS
  • Windows
  • Linux
  • Emscripten
  • FreeBSD
  • NetBSD
  • OpenBSD
  • Haiku
  • Solaris
  • MacOS X
  • PlayStation 3
  • PlayStation Portable
  • PlayStation Vita
  • Original Microsoft Xbox
  • Microsoft Xbox 360 (Libxenon/XeXDK)
  • Nintendo Wii, GameCube (Libogc)
  • Nintendo WiiU
  • Nintendo 3DS
  • Nintendo Switch
  • Raspberry Pi
  • Android
  • iOS
  • Blackberry

Dependencies (PC)

There are no true hard dependencies per se.

On Windows, RetroArch can run with only Win32 as dependency.

On Linux, there are no true dependencies. For optimal usage, the following dependencies come as recommended:

  • GL headers / Vulkan headers
  • X11 headers and libs, or EGL/KMS/GBM

OSX port of RetroArch requires latest versions of XCode to build.

RetroArch can utilize these libraries if enabled:

  • nvidia-cg-toolkit
  • libxml2 (GLSL XML shaders)
  • libfreetype2 (TTF font rendering on screen)

RetroArch needs at least one of these audio driver libraries:

  • ALSA
  • OSS
  • RoarAudio
  • RSound
  • OpenAL
  • JACK
  • SDL
  • PulseAudio
  • XAudio2 (Win32, Xbox 360)
  • DirectSound (Win32, Xbox 1)
  • CoreAudio (OSX, iOS)

To run properly, RetroArch requires a libretro implementation present, however, as it's typically loaded dynamically, it's not required at build time.

Dependencies (Console ports, mobile)

Console ports have their own dependencies, but generally do not require anything other than what the respective SDKs provide.

Configuring

The default configuration is defined in config.def.h. It is not recommended to change this unless you know what you're doing. These can later be tweaked by using a config file. A sample configuration file is installed to /etc/retroarch.cfg. This is the system-wide config file.

RetroArch will on startup create a config file in $XDG_CONFIG_HOME/retroarch/retroarch.cfg if doesn't exist. Users only need to configure a certain option if the desired value deviates from the value defined in config.def.h.

To configure joypads, use the built-in menu or the retroarch-joyconfig command-line tool.

Compiling and installing

Instructions for compiling and installing RetroArch can be found in the Libretro/RetroArch Documentation Center.