Cross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.
Go to file
Mahyar Koshkouei 87a7c0f426 Show GL hex error in hex
Fixes an issue whereby a hexadecimal error value was being printed in
decimal.

Tested on a RPi that suffers from issue 6078.

Signed-off-by: Mahyar Koshkouei <mahyar.koshkouei@gmail.com>
2018-01-17 17:08:03 +00:00
.github Rename PULL_REQUEST_TEMPLATE to PULL_REQUEST_TEMPLATE.md 2017-11-29 12:03:42 -05:00
.vscode only reinit when HID devices are attached 2017-12-27 15:34:18 -05:00
audio Refactor verbosity code - try to avoid log calls if verbosity is not 2018-01-17 06:28:26 +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 Fixed HTTP request for cheevos; fixed handling invalid cheevos 2018-01-03 21:34:52 +00:00
cores Add libretro-mpv 2018-01-15 01:38:05 +01:00
ctr (CTR) build fix. 2017-12-25 08:51:50 +01:00
defines (D3D8) can now render content frame, rgui and overlays. 2018-01-17 07:10:45 +01:00
deps Cleanups 2018-01-07 14:52:26 +01:00
dist-scripts copy over new .wasm file instead of old .js.mem file 2018-01-16 19:24:01 -06: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 Start using string_is_equal predominantly 2018-01-16 22:53:38 +01:00
gfx Show GL hex error in hex 2018-01-17 17:08:03 +00:00
griffin add joypad driver for emscripten 2018-01-14 00:15:30 -06:00
input Reduce usage of string_is_not_equal_fast 2018-01-17 01:03:48 +01:00
intl Reduce usage of string_is_not_equal_fast 2018-01-17 01:03:48 +01:00
led Add frontend, battery level and memory amount detection to 3ds port 2018-01-10 16:52:32 -08:00
libretro-common Cleanups 2018-01-17 06:44:16 +01:00
libretro-db oh right, that's what it wants. 2017-12-28 04:13:00 +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 Refactor verbosity code - try to avoid log calls if verbosity is not 2018-01-17 06:28:26 +01:00
network Start using string_is_equal predominantly 2018-01-16 22:53:38 +01:00
pkg Remove xbox media path 2018-01-17 09:05:28 +01:00
qb Refactor verbosity code - try to avoid log calls if verbosity is not 2018-01-17 06:28:26 +01:00
record Refactor verbosity code - try to avoid log calls if verbosity is not 2018-01-17 06:28:26 +01:00
tasks fix display name for builtin autoconfs again 2018-01-16 22:18:28 -05:00
tools Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
translation Add frontend, battery level and memory amount detection to 3ds port 2018-01-10 16:52:32 -08:00
ui Start using string_is_equal predominantly 2018-01-16 22:53:38 +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 (WIIU) add remaining menu shaders. 2018-01-12 02:54:45 +01:00
.editorconfig Add EditorConfig support 2016-09-16 10:44:33 -04:00
.gitignore build optimized emscripten builds as WASM 2018-01-15 04:00:09 -06:00
.project Allow to load roms from external apps. 2013-08-19 23:23:39 +02:00
.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 2018-01-17 09:20:56 +01:00
command.c fix warning. 2018-01-04 17:38:31 +01:00
command.h fix fullscreen toggle 2017-12-17 13:16:40 -05:00
config.def.h add mouse support to emscripten 2018-01-13 20:51:30 -06: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 Start using string_is_equal predominantly 2018-01-16 22:53:38 +01:00
configuration.h Merge pull request #6027 from meepingsnesroms/master 2018-01-02 06:19:48 +01:00
configure (qb) Add qb.system.sh 2015-06-16 20:46:11 -03:00
content.h Simplify content_get_crc 2017-05-06 16:41:22 +02: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 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 update diff.diff 2017-01-17 17:13:42 +01:00
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 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 Update 2018-01-17 00:49:23 +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 Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
list_special.h Fix more MSVC Griffin build errors 2017-12-30 13:35:47 +01:00
Makefile Makefile: Use cp / chmod instead of install. 2018-01-15 10:24:33 -08:00
Makefile.common add joypad driver for emscripten 2018-01-14 00:15:30 -06:00
Makefile.ctr Remove -a from uname 2018-01-05 09:58:10 -08:00
Makefile.ctr.salamander Remove -a from uname 2018-01-05 09:58:10 -08:00
Makefile.emscripten more build modifications to emscripten (needed for mupen64 to work) 2018-01-15 21:02:01 -06:00
Makefile.griffin * Compile C code with MSVC Makefile as C instead of C++ 2018-01-01 17:38:04 +01:00
Makefile.libogc Update 2017-08-20 00:54:39 +02:00
Makefile.openpandora Start removing SINC ifdefs for individual Makefiles 2017-12-31 21:34:31 +01:00
Makefile.pandora Move pandora files 2015-09-20 15:41:28 +02:00
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 (WIIU) add remaining menu shaders. 2018-01-12 02:54:45 +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 Merge pull request #6027 from meepingsnesroms/master 2018-01-02 06:19:48 +01:00
no-xib.diff Add no-xib.diff 2015-10-13 23:23:33 +02:00
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 exynos: update TODO list 2014-08-09 16:43:48 +02:00
README-mali_fbdev_r4p0.md Fix some spelling errors (pendantic info lintian warnings). 2016-07-20 23:28:29 -03:00
README-OMAP.md video_omap: more docu fixes 2014-01-14 16:39:24 -06:00
README.md readme: Update supported platforms 2018-01-02 22:49:46 -05:00
retroarch-mingw-build.sh Add support for different "make" binaries 2014-07-30 01:14:57 +02:00
retroarch.c Reduce usage of string_is_not_equal_fast 2018-01-17 01:03:48 +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 Start using string_is_equal predominantly 2018-01-16 22:53:38 +01:00
setting_list.h Clean up trailing whitespace 2017-12-12 00:24:18 -08:00
verbosity.c Refactor verbosity code - try to avoid log calls if verbosity is not 2018-01-17 06:28:26 +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 Polish up WiiU deploy scripts 2018-01-10 22:51:00 -08: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
  • 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.