Cross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.
Go to file
2017-12-25 17:52:38 -08:00
.github Rename PULL_REQUEST_TEMPLATE to PULL_REQUEST_TEMPLATE.md 2017-11-29 12:03:42 -05:00
.vscode Improve vscode support 2017-12-05 14:50:40 -05:00
audio (xaudio) Cleanups 2017-12-25 08:11:10 +01:00
bootstrap Merge pull request from frangarcj/vita-adrenaline 2017-12-21 01:05:28 +01:00
camera Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
cheevos Move path_file_exists to filestream and do away with filestream 2017-12-14 20:05:46 +01:00
cores Disable Temporal Interpolation by default in internal FFmpeg core 2017-12-22 17:24:13 -05:00
ctr (CTR) build fix. 2017-12-25 08:51:50 +01:00
defines Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
deps (STB Truetype) Try to silence potential uninitialized reference to winding_lengths 2017-12-24 18:54:57 +01:00
dist-scripts Define DEX_BUILD/CEX_BUILD/ODE_BUILD for PS3 versions - set 2017-12-23 08:12:39 +01:00
docs
emscripten Audio Performance Change 2017-09-26 20:53:02 -04:00
frontend Cleanups 2017-12-25 07:49:07 +01:00
gfx Merge branch 'master' into master 2017-12-25 17:52:38 -08:00
griffin Ifdef the broken dbus code better. 2017-12-16 05:19:05 -08:00
input xinput: check for valid function pointers before calling them 2017-12-23 23:02:29 -05:00
intl Update Polish language - use the header 2017-12-18 19:46:28 +01:00
libretro-common Update 2017-12-24 18:53:03 +01:00
libretro-db Update c_converter with libretro-common vfs changes 2017-12-20 20:15:33 -05:00
location Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
managers Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
media explicitly set codepage for Japanese menubar translation, fixes and 2017-09-22 09:40:22 -07:00
memory Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
menu Merge branch 'master' into master 2017-12-25 17:52:38 -08:00
network show the frontend name and CPU architecture on netplay rooms 2017-12-17 11:51:50 -05:00
pkg Bump to version 1.7.0 2017-12-25 18:17:57 +01:00
qb Ifdef the broken dbus code better. 2017-12-16 05:19:05 -08:00
record Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
tasks Fixes for overlay buttons 2017-12-17 12:36:18 +00:00
tools Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
ui Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
wifi Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
wii Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
wiiu Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
.editorconfig
.gitignore Bugfixes 2017-12-16 20:47:08 -08:00
.project
.travis.yml travis: libusb package was in wrong place 2017-11-28 23:16:38 -05:00
autosave.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
CHANGES.md Update CHANGES.md 2017-12-26 00:47:31 +01:00
command.c fix fullscreen toggle 2017-12-17 13:16:40 -05:00
command.h fix fullscreen toggle 2017-12-17 13:16:40 -05:00
config.def.h Disable automatically add content by playlist by default 2017-12-25 18:19:55 +01:00
config.def.keybinds.h New lightgun binds 2017-11-26 16:59:48 +00:00
config.features.h Remove remaining references to HAVE_FBO 2017-11-13 08:55:41 +01:00
configuration.c fix fullscreen toggle 2017-12-17 13:16:40 -05:00
configuration.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
configure
content.h
CONTRIBUTING.md
COPYING
core_impl.c
core_info.c Move path_file_exists to filestream and do away with filestream 2017-12-14 20:05:46 +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 - use malloc 2017-09-29 05:01:00 +02: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
diff.diff
dirs.c Move path_file_exists to filestream and do away with filestream 2017-12-14 20:05:46 +01:00
dirs.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
driver.c Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
driver.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
dynamic.c Remove file_ prefixes, for consistency with the rest of libretro. They're not useful, anything they'd mean is provided by the vfs_iface-> anyways. Also rename delete to remove to match libc and avoid C++ keywords. 2017-12-15 17:28:55 +01:00
dynamic.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
fetch-submodules.sh
file_path_special.c This include doesn't go here 2017-11-25 20:25:59 +01:00
file_path_special.h Cheevos badges 2017-11-23 08:04:54 -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 Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
list_special.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
Makefile Update make install for new retroarch-assets src 2017-12-06 14:34:20 -05:00
Makefile.common libchdr requires both 7zip and zlib 2017-12-25 04:18:42 +01:00
Makefile.ctr Bugfixes 2017-12-16 20:47:08 -08:00
Makefile.ctr.salamander Bugfixes 2017-12-16 20:47:08 -08:00
Makefile.emscripten Reduce size of Makefiles 2017-12-07 05:54:54 +01:00
Makefile.griffin this line is not required 2017-12-19 21:56:16 -05:00
Makefile.libogc Update 2017-08-20 00:54:39 +02:00
Makefile.openpandora Merge version.h, dist-cores.sh and version.all 2017-09-26 01:05:43 +02:00
Makefile.pandora
Makefile.ps3 enable STB Unicode font renderer for PS3 2017-12-23 21:35:45 -05:00
Makefile.ps3.cobra Define DEX_BUILD/CEX_BUILD/ODE_BUILD for PS3 versions - set 2017-12-23 08:12:39 +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 (PSP1) Change to -O2 2017-12-12 00:17:17 +01:00
Makefile.psp1.salamander Add vfs_implementation to Salamander builds 2017-12-14 15:18:48 +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 [WiiU] Add -D__WUT__; fixes integrated libiosuhax 2017-12-20 13:47:30 +11:00
Makefile.wiiu.salamander Add vfs_implementation to Salamander builds 2017-12-14 15:18:48 +01: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 msg_hash: support GDI files 2017-09-18 09:03:43 -07:00
msg_hash.h add menu setting for window opacity, includes generic display server interface 2017-12-11 18:12:42 -05:00
no-xib.diff
paths.c Clean up trailing whitespace 2017-12-12 00:24:18 -08: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
README-OMAP.md
README.md Add DOS to the list of supported operating systems 2017-12-24 21:47:40 -05:00
retroarch-mingw-build.sh
retroarch.c Merge pull request from fr500/master 2017-12-17 19:21:26 +01:00
retroarch.cfg add menu options for OSD background color 2017-10-10 14:53:32 -04:00
retroarch.desktop Making description more concrete and adding Russian translation 2017-11-22 19:04:59 +03:00
retroarch.h fix fullscreen toggle 2017-12-17 13:16:40 -05:00
setting_list.c Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
setting_list.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
verbosity.c Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
verbosity.h
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 Bump to version 1.7.0 2017-12-25 18:17:57 +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

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
  • FreeBSD
  • NetBSD
  • MacOS
  • PlayStation 3
  • PlayStation Portable
  • Original Xbox
  • Xbox 360 (Libxenon/XeXDK)
  • Wii, GameCube (Libogc)
  • WiiU
  • Nintendo 3DS
  • 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.