Cross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.
Go to file
2021-02-06 22:41:02 +02:00
.github Fix GitHub Actions (#11984) 2021-02-04 13:49:08 +01:00
.vscode
audio Clean all the warnings in PS2 2021-01-30 15:47:52 +01:00
bluetooth
bootstrap [VITA] Remove old threading workaround 2020-11-15 09:41:37 +01:00
camera/drivers
cheevos Silence some implicit conversion warnings 2021-02-03 12:34:10 +01:00
cores (ffmpeg core) Struct reordering, alignment 2020-08-16 04:23:15 +02:00
ctr (3DS) On error, only init gfx on salamander build 2021-01-17 15:44:35 +01:00
defines [VITA] Add support for Vita GLES2 (PIGLET) 2021-01-06 19:14:30 +01:00
deps (Metal) Fix some build problems 2021-01-19 04:38:07 +01:00
dingux OpenDingux: Enable selection of image interpolation method when using 'sdl_dingux' gfx driver 2020-10-05 14:34:21 +01:00
dist-scripts Update dist-cores.sh 2021-01-06 00:18:46 +01:00
docs
emscripten Emscripten: remove unused dependency (buildfix) 2020-12-18 03:40:18 +00:00
frontend Clean all the warnings in PS2 2021-01-30 15:47:52 +01:00
gfx Vita: VitaGL api changes (#11981) 2021-02-04 11:46:00 +01:00
griffin Add 'Upscale_256x-320x240' video filter 2021-01-31 13:38:40 +00:00
input (WIN32) Cursor clipping for grabbed mouse 2021-02-02 14:15:58 +02:00
intl Submenu for Device Index 2021-02-05 19:49:15 +02:00
led LED win32 keyboard driver cleanup 2021-01-02 05:46:04 +02:00
libretro-common (RTGA) Lower raw_data size to 18 bytes and leave behind a comment 2021-02-03 11:01:36 +01:00
libretro-db (Mac) More warning fixes 2021-01-26 21:21:51 +01:00
location/drivers
media ui_win32_application.c: Add support for accelerators to main win32 message loop 2020-12-28 16:39:39 -05:00
memory
menu Reorder Mouse Index next to Device Index 2021-02-06 22:41:02 +02:00
midi Use C-style comments 2021-02-03 10:04:42 +01:00
network (libretro-common) Rename rhash to lrc_hash 2020-12-28 19:55:54 +01:00
pkg (Mac) Silence more warnings 2021-01-26 20:39:36 +01:00
play_feature_delivery (Android/Play Store Builds) Add option to switch all installed cores to Play Store versions 2020-09-02 17:13:03 +01:00
ps2 (PS2) added Multitap support (up to 8 players) (#11928) 2021-01-24 00:04:04 +01:00
qb (FontRenderer/FreeType) Use fontconfig to select fonts if available 2021-01-30 18:49:47 -07:00
record/drivers first 2020-12-19 15:14:14 +03:00
reference
samples/tasks/database New faster json parser/writer library rjson 2020-10-12 03:02:20 +09:00
shaders
shaders-hlsl
shaders-hlsl-no-opt/asm/frag
shaders-msl
shaders-no-opt/asm/frag
tasks Savestate logging cleanup 2021-02-03 13:29:32 +02:00
tests-other
tools (com-parser) Use STRLEN_CONST 2020-10-02 20:50:11 +02:00
ui qt: fix mouse cursor limited by window range on F5 press 2021-02-04 17:54:05 +01:00
uwp [UWP] VFS: Use Win32 file APIs when possible 2021-01-07 00:14:21 +08:00
vita/launcher
wifi (Metal) Fix some build problems 2021-01-19 04:38:07 +01:00
wii Add Wii build to .gitlab-ci.yml 2020-12-04 11:01:34 +00:00
wiiu (Wiiu) Cleanups 2020-07-24 04:42:43 +02:00
.editorconfig Add AppStream support for Linux and BSD 2020-08-05 23:56:17 +03:00
.gitignore Merge pull request #11925 from Ryunam/custom-dirs 2021-02-01 23:20:00 +01:00
.gitlab-ci.yml (.gitlab-ci.yml) Set expiry time to 10 minutes for all artefacts 2021-01-21 11:53:30 +01:00
.project
.travis.yml Update Travis config for new Android targetSdkVersion 2020-11-01 20:55:26 -07:00
10bpc-gl.diff
accessibility.h
AUTHORS.h
autosave.h
CHANGES.md Update CHANGES.md 2020-12-13 12:58:53 +01:00
cheat_manager.c Move cheat_manager and state_manager to root folder 2020-10-15 05:29:20 +02:00
cheat_manager.h Move cheat_manager and state_manager to root folder 2020-10-15 05:29:20 +02:00
CODING-GUIDELINES Expand CODING-GUIDELINES 2020-08-25 14:04:41 +02:00
com.libretro.RetroArch.appdata.xml Bump up to version 1.9.0 2020-08-08 00:06:53 +02:00
command.h Add Run-Ahead Toggle hotkey with notifications 2020-11-06 21:39:11 +01:00
config.def.h (Apple/ARM64) Set __aarch64__ for Core Updater URL 2021-01-26 22:58:45 +01:00
config.def.keybinds.h Add Run-Ahead Toggle hotkey with notifications 2020-11-06 21:39:11 +01:00
config.features.h
configuration.c Config logging cleanup 2021-02-03 13:43:56 +02:00
configuration.h Enable configuration of directory for Favorites, History, Images, Music and Video playlists 2021-01-21 21:28:10 +01:00
configure
content.h Reorder structs, alignment 2020-08-15 23:10:31 +02:00
CONTRIBUTING.md
COPYING
core_backup.c (Clang) Silence 'n' is never used warnings 2021-02-03 11:48:33 +01:00
core_backup.h Reorder structs, alignment 2020-08-15 23:10:31 +02:00
core_info.c Add ctype variants to stdstring and use it in RA 2020-09-27 22:15:32 +02:00
core_info.h (Android/Play Store Builds) Add option to switch all installed cores to Play Store versions 2020-09-02 17:13:03 +01:00
core_option_manager.h Cleanup 2020-10-15 07:09:01 +02:00
core_type.h
core_updater_list.c (Android) Play Store builds: Do not resolve symlinks when handling core paths 2020-08-31 12:13:49 +01:00
core_updater_list.h (Android/Play Store) Add frontend support for core installation via Play Feature Delivery 2020-08-28 16:30:54 +01:00
core.h Reorder structs, alignment 2020-08-15 23:10:31 +02:00
database_info.c use strlcpy_literal for string literal copies 2020-09-19 23:28:01 +02:00
database_info.h Alignment changes 2020-08-14 18:19:57 +02:00
defaults.h Enable configuration of directory for Favorites, History, Images, Music and Video playlists 2021-01-21 21:28:10 +01:00
disk_control_interface.c
disk_control_interface.h More struct reordering/alignment 2020-08-14 21:00:04 +02:00
disk_index_file.c New faster json parser/writer library rjson 2020-10-12 03:02:20 +09:00
disk_index_file.h More struct reordering/alignment 2020-08-14 21:00:04 +02:00
Doxyfile
driver.h Get rid of RARCH_DRIVER_CTL_FIND_INDEX 2020-09-16 18:41:45 +02:00
dynamic.h Add more global warnings 2020-10-10 17:44:56 +02:00
fetch-submodules.sh
file_path_special.c (RGUI) Add support for CJK fonts 2020-12-10 15:17:26 +00:00
file_path_special.h Enable configuration of directory for Favorites, History, Images, Music and Video playlists 2021-01-21 21:28:10 +01:00
github-contributors.py
lakka.h
list_special.h
Makefile Squashed 'deps/vitaGL/' changes from 2934af8af0..81403e2751 2020-10-16 20:24:43 +02:00
Makefile.apple
Makefile.classic_sega_mini
Makefile.classic_snesc
Makefile.common Add 'Upscale_256x-320x240' video filter 2021-01-31 13:38:40 +00:00
Makefile.ctr (3DS) Generate random cia version 2021-01-02 00:26:42 +01:00
Makefile.ctr.salamander (rhash to lrc_hash) Fix console builds 2020-12-28 20:24:55 +01:00
Makefile.dingux OpenDingux: Enable compilation with custom toolchains 2020-12-02 12:07:52 +00:00
Makefile.emscripten (Emscripten) Makefile.emscripten: Allow linker 'TOTAL_MEMORY' value to be set via command line 2021-01-08 14:52:52 +00:00
Makefile.griffin (Makefile.griffin) Fix windows_msvc2010 makefile target(s) (#11978) 2021-02-03 17:37:15 +01:00
Makefile.libnx ibxm: update to 20191214 2020-11-21 20:30:19 +00:00
Makefile.libogc
Makefile.msvc
Makefile.ngc Add NGC build to .gitlab-ci.yml 2020-12-04 17:35:31 +00:00
Makefile.openpandora
Makefile.orbis
Makefile.pandora
Makefile.ps2 Clean all the warnings in PS2 2021-01-30 15:47:52 +01:00
Makefile.ps2.salamander Remove legacy way of using logs for PS2 and PSP platform 2021-01-19 14:31:45 +01:00
Makefile.psl1ght Remove obsolete __CELLOS_LV2__ references - use PSL1GHT instead 2020-12-19 15:32:26 +01:00
Makefile.psl1ght.salamander (rhash to lrc_hash) Fix console builds 2020-12-28 20:24:55 +01:00
Makefile.psp1 Remove legacy way of using logs for PS2 and PSP platform 2021-01-19 14:31:45 +01:00
Makefile.psp1.salamander Remove legacy way of using logs for PS2 and PSP platform 2021-01-19 14:31:45 +01:00
Makefile.rg350 OpenDingux: Enable compilation with custom toolchains 2020-12-02 12:07:52 +00:00
Makefile.switch ibxm: update to 20191214 2020-11-21 20:30:19 +00:00
Makefile.vita Vita: Disable temporarily VITAGL 2021-02-04 12:29:06 +01:00
Makefile.vita.salamander [VITA] Fix bubble name 2021-01-03 23:41:14 +01:00
Makefile.wii Add Wii build to .gitlab-ci.yml 2020-12-04 11:01:34 +00:00
Makefile.wii.salamander (rhash to lrc_hash) Fix console builds 2020-12-28 20:24:55 +01:00
Makefile.wiiu (rhash to lrc_hash) Fix console builds 2020-12-28 20:24:55 +01:00
Makefile.win
manual_content_scan.c Reorder struct 2020-10-10 18:14:03 +02:00
manual_content_scan.h
msg_hash.c (msg_hash) Use different locale names for ... 2021-01-30 18:46:16 -07:00
msg_hash.h Submenu for Mouse Index 2021-02-06 01:59:54 +02:00
no-xib.diff
nvda_controller.h
nvdaControllerClient64.dll
paths.h Jdgleaver improvements 2020-11-20 03:55:55 +01:00
performance_counters.h Cleanups - split up global state to retroarch_data.h 2020-11-17 01:34:20 +01:00
playlist.c New faster json parser/writer library rjson 2020-10-12 03:02:20 +09:00
playlist.h (Android) Play Store builds: Do not resolve symlinks when handling core paths 2020-08-31 12:13:49 +01:00
README-exynos.md
README-mali_fbdev_r4p0.md
README-OMAP.md
README.md Squashed 'deps/vitaGL/' changes from 81403e2..34bc720 2020-11-13 14:29:36 +01:00
retroarch_data.h We need to change this ifdef now that we temporarily disable vitagl 2021-02-04 12:51:52 +01:00
retroarch_fwd_decls.h Cleanups 2020-12-09 22:23:07 +01:00
retroarch-android-debug.diff
retroarch-apple-packaging.sh Build OSX Metal using Makefile (#11941) 2021-01-26 09:48:15 +01:00
retroarch-mingw-build.sh
retroarch.c 'On-Screen Notifications' menu clean-ups 2021-02-05 16:55:09 +00:00
retroarch.cfg
retroarch.desktop
retroarch.h (Metal) Fix some build problems 2021-01-19 04:38:07 +01:00
runtime_file.c (Clang) Silence 'n' is never used warnings 2021-02-03 11:48:33 +01:00
runtime_file.h Reorder structs, alignment 2020-08-15 23:10:31 +02:00
setting_list.h Move this outside of the header and into menu_setting.c 2020-09-05 20:27:29 +02:00
state_manager.c fix SSE2 implementation of find_change 2021-01-21 22:26:45 -07:00
state_manager.h Move rewind manager state variable to p_rarch 2020-10-15 06:04:20 +02:00
switch_performance_profiles.h First attempt at adding proper brightness 2020-11-26 19:22:05 +01:00
translation_defines.h
travis_metal_deploy.sh
travis-deploy-key.enc
verbosity.c Shader log spam reduction (#11977) 2021-02-03 13:49:07 +01:00
verbosity.h Shader log spam reduction (#11977) 2021-02-03 13:49:07 +01:00
version_git.c
version_git.h
version.all Bump up to version 1.9.0 2020-08-08 00:06:53 +02:00
version.dtd Bump up to version 1.9.0 2020-08-08 00:06:53 +02:00
version.h
wiiu-devel.properties.template

Build Status Coverity Scan Build Status Crowdin

RetroArch

RetroArch is the reference frontend for the libretro API. Popular examples of implementations for this API includes video game system emulators and game engines as well as 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

ozone 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 to 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 binaries are currently hosted on the buildbot.

Support

To reach developers, either make an issue here on GitHub, make a thread on the forum, chat on discord, or visit our IRC channel: #retroarch @ irc.freenode.org. You could create a post in Reddit with Technical Support flair.

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 and touchscreen 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), run-ahead input latency removal, etc.

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

Platforms

RetroArch has been ported to the following platforms:

  • DOS
  • Windows
  • Linux
  • Emscripten (WebAssembly and JavaScript)
  • FreeBSD
  • NetBSD
  • OpenBSD
  • Haiku
  • Solaris
  • macOS (PPC, x86-32 and x86-64)
  • PlayStation 2
  • PlayStation 3
  • PlayStation Portable
  • PlayStation Vita
  • Original Microsoft Xbox
  • Microsoft Xbox 360 (Libxenon/XeXDK)
  • Nintendo GameCube
  • Nintendo Wii
  • Nintendo Wii U
  • Nintendo 3DS/2DS
  • Nintendo Switch
  • Nintendo NES/SNES Classic Edition
  • 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
  • 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 it does not 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.

CRT 15Khz Resolution Switching

CRT SwitchRes will turn on, on the fly. However, you will need to restart RetroArch to disable it. With CRT SwitchRes enable RetroArch will start in 2560 x 480 @ 60.

If you are running Windows, before enabling the CRT SwitchRes options please make sure you have installed CRTEmudriver and installed some modelines. The minimum modelines for all games to switch correctly are:

  • 2560 x 192 @ 60.000000
  • 2560 x 200 @ 60.000000
  • 2560 x 240 @ 60.000000
  • 2560 x 224 @ 60.000000
  • 2560 x 237 @ 60.000000
  • 2560 x 256 @ 50.000000
  • 2560 x 254 @ 55.000000
  • 2560 x 448 @ 60.000000
  • 2560 x 480 @ 60.000000

Install these modelines replacing 2560 with your desired super resolution. The above resolutions are NTSC only so if you would be playing any PAL content please add PAL modelines:

  • 2560 x 192 @ 50.000000
  • 2560 x 200 @ 50.000000
  • 2560 x 240 @ 50.000000
  • 2560 x 224 @ 50.000000
  • 2560 x 288 @ 50.000000
  • 2560 x 237 @ 50.000000
  • 2560 x 254 @ 55.000000
  • 2560 x 448 @ 50.000000
  • 2560 x 480 @ 50.000000

Some games will require higher PAL resolutions which should also be installed:

  • 2560 x 512 @ 50.000000
  • 2560 x 576 @ 50.000000

Ideally install all these modelines and everything will work great.

Super Resolutions

The default super resolution is 2560. It is displayed just under the CRT switch option, which can be found in video settings. This can be changed within the retroarch.cfg. The only compatible resolutions are 1920, 2560 and 3840. Any other resolutions will be ignored and native switching will be activated.

Native Resolutions

If native resolutions are activated you will need a whole new set of modelines:

  • 256 x 240 @ 50.006977 SNESpal

  • 256 x 448 @ 50.006977 SNESpal

  • 512 x 224 @ 50.006977 SNESpal

  • 512 x 240 @ 50.006977 SNESpal

  • 512 x 448 @ 50.006977 SNESpal

  • 256 x 240 @ 60.098812 SNESntsc

  • 256 x 448 @ 60.098812 SNESntsc

  • 512 x 240 @ 60.098812 SNESntsc

  • 512 x 224 @ 60.098812 SNESntsc

  • 512 x 448 @ 60.098812 SNESntsc

  • 256 x 192 @ 59.922745 MDntsc

  • 256 x 224 @ 59.922745 MDntsc

  • 320 x 224 @ 59.922745 MDntsc

  • 320 x 240 @ 59.922745 MDntsc

  • 320 x 448 @ 59.922745 MDntsc

  • 320 x 480 @ 59.922745 MDntsc

  • 256 x 192 @ 49.701458 MDpal

  • 256 x 224 @ 49.701458 MDpal

  • 320 x 224 @ 49.701458 MDpal

  • 320 x 240 @ 49.701458 MDpal

  • 320 x 288 @ 49.701458 MDpal

  • 320 x 448 @ 49.701458 MDpal

  • 320 x 480 @ 49.701458 MDpal

  • 320 x 576 @ 49.701458 MDpal

  • 256 x 288 @ 49.701458 MSYSpal

  • 256 x 240 @ 60.098812 NESntsc

  • 256 x 240 @ 50.006977 NESpal

  • 640 x 237 @ 60.130001 N64ntsc

  • 640 x 240 @ 60.130001 N64ntsc

  • 640 x 480 @ 60.130001 N64ntsc

  • 640 x 288 @ 50.000000 N64pal

  • 640 x 480 @ 50.000000 N64pal

  • 640 x 576 @ 50.000000 N64pal

  • 256 x 252 @ 49.759998 PSXpal

  • 320 x 252 @ 49.759998 PSXpal

  • 384 x 252 @ 49.759998 PSXpal

  • 640 x 252 @ 49.759998 PSXpal

  • 640 x 540 @ 49.759998 PSXpal

  • 384 x 240 @ 59.941002 PSXntsc

  • 256 x 480 @ 59.941002 PSXntsc

  • 352 x 240 @ 59.820000 Saturn/SGFX_NTSCp

  • 704 x 240 @ 59.820000 SaturnNTSCp

  • 352 x 480 @ 59.820000 SaturnNTSCi

  • 704 x 480 @ 59.820000 SaturnNTSCi

  • 352 x 288 @ 49.701458 SaturnPALp

  • 704 x 288 @ 49.701458 SaturnPALp

  • 352 x 576 @ 49.701458 SaturnPALi

  • 704 x 576 @ 49.701458 SaturnPALi

  • 240 x 160 @ 59.730000 GBA

  • 320 x 200 @ 60.000000 Doom

// Arcade

  • 400 x 254 @ 54.706841 MK
  • 384 x 224 @ 59.637405 CPS1

These modelines are more accurate giving exact hz. However, some games may have unwanted results. This is due to mid-scanline resolution changes on the original hardware. For the best results super resolutions are the way to go.

CRT resolution switching & MAME

Some arcade resolutions can be very different from consumer CRTs. There is resolution detection to ensure MAME games will be displayed in the closest available resolution but drawn at their native resolution within this resolution. Meaning that the MAME game will look just like the original hardware.

MAME ROMs that run in a vertical aspect like DoDonPachi need to be rotated within MAME before resolution switching and aspect correction will work. Do this before enabling CRT SwitchRes so that RetroArch will run in your desktop resolution. Once you have rotated any games that may need it turn CRT SwitchRes on.

Socials

The links below belong to our official channels. Links other than this may have been created by fans, independent members or followers. We seriously recommend using our original resources.