2016-09-06 03:34:03 +00:00
[![Build Status ](https://travis-ci.org/libretro/RetroArch.svg?branch=master )](https://travis-ci.org/libretro/RetroArch)
2016-12-10 21:02:39 +00:00
[![Coverity Scan Build Status ](https://scan.coverity.com/projects/8936/badge.svg )](https://scan.coverity.com/projects/retroarch)
2020-06-04 09:40:25 +00:00
[![Crowdin ](https://badges.crowdin.net/retroarch/localized.svg )](https://crowdin.com/project/retroarch)
2016-09-06 03:34:03 +00:00
2012-04-21 21:27:15 +00:00
# RetroArch
2010-12-24 01:00:13 +00:00
2013-11-26 22:09:12 +00:00
RetroArch is the reference frontend for the libretro API.
2018-05-04 02:55:30 +00:00
Popular examples of implementations for this API includes video game system emulators and game engines as well as
2013-11-26 22:09:12 +00:00
more generalized 3D programs.
These programs are instantiated as dynamic libraries. We refer to these as "libretro cores".
2010-12-24 01:00:13 +00:00
2020-03-07 20:26:28 +00:00
![XMB menu driver ](docs/XMB-main-menu.jpg "XMB menu driver" )
2017-08-26 09:26:18 +00:00
2020-03-07 20:26:28 +00:00
![rgui menu driver ](docs/rgui-main-menu.jpg "rgui menu driver" )
2017-08-26 09:26:18 +00:00
2020-03-07 20:26:28 +00:00
![glui menu driver ](docs/glui-main-menu.jpg "glui menu driver" )
![ozone menu driver ](docs/ozone-main-menu.jpg "ozone menu driver" )
2017-08-26 09:26:18 +00:00
2013-10-02 08:54:03 +00:00
## libretro
2010-12-24 01:00:13 +00:00
2020-03-16 06:49:18 +00:00
[libretro ](https://www.libretro.com ) is an API that exposes generic audio/video/input callbacks.
2013-10-02 08:54:03 +00:00
A frontend for libretro (such as RetroArch) handles video output, audio output, input and application lifecycle.
2018-03-20 07:54:23 +00:00
A libretro core written in portable C or C++ can run seamlessly on many platforms with very little to no porting effort.
2013-10-02 08:54:03 +00:00
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.
2010-12-24 01:00:13 +00:00
2016-06-12 18:44:55 +00:00
[libretro API header ](https://github.com/libretro/RetroArch/blob/master/libretro-common/include/libretro.h )
2012-04-22 09:59:31 +00:00
2013-10-02 08:54:03 +00:00
## Binaries
2018-05-31 17:26:35 +00:00
Latest binaries are currently hosted on the [buildbot ](http://buildbot.libretro.com/ ).
2013-10-02 08:54:03 +00:00
## Support
2020-03-16 06:49:18 +00:00
To reach developers, either make an issue here on GitHub, make a thread on the [forum ](https://www.libretro.com/forums/ ), chat on [discord ](https://discord.gg/C4amCeV ), or visit our IRC channel: #retroarch @ irc.freenode.org. You could create a post in [Reddit ](https://www.reddit.com/r/RetroArch/ ) with *Technical Support* flair.
2011-11-16 20:28:30 +00:00
2013-10-02 08:54:03 +00:00
## Documentation
2011-11-16 20:28:30 +00:00
2017-10-30 05:06:05 +00:00
See our [Documentation Center ](https://docs.libretro.com/ ). On Unix, man-pages are provided.
2020-03-07 20:26:28 +00:00
More developer-centric stuff is found [here ](https://docs.libretro.com/development/libretro-overview/ ).
2013-10-02 08:54:03 +00:00
## Related projects
2012-04-22 09:59:31 +00:00
2014-12-25 23:13:30 +00:00
- Cg/HLSL shaders: [common-shaders ](https://github.com/libretro/common-shaders )
2017-10-30 02:34:43 +00:00
- slang shaders: [slang-shaders ](https://github.com/libretro/slang-shaders )
- GLSL shaders: [glsl-shaders ](https://github.com/libretro/glsl-shaders )
2012-06-03 19:40:10 +00:00
- Helper scripts to build libretro implementations: [libretro-super ](https://github.com/libretro/libretro-super )
2017-10-30 05:06:05 +00:00
- GitHub mirrors of projects, useful for generating diff files: [libretro-mirrors ](https://github.com/libretro-mirrors/ )
2012-04-22 09:59:31 +00:00
2013-10-02 08:54:03 +00:00
## Philosophy
2010-12-24 01:00:13 +00:00
2018-03-20 07:54:23 +00:00
RetroArch attempts to be small and lean
2015-02-13 21:24:21 +00:00
while still having all the useful core features expected from an emulator.
2018-05-31 17:26:35 +00:00
It is designed to be very portable and features a gamepad-centric and touchscreen UI.
2013-10-02 08:54:03 +00:00
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,
2018-05-31 17:26:35 +00:00
real-time rewind (Braid-style), video recording (using FFmpeg), run-ahead input latency removal, etc.
2010-12-24 01:00:13 +00:00
2018-05-31 17:26:35 +00:00
RetroArch also emphasizes being easy to integrate into various launcher frontends.
2013-10-02 08:54:03 +00:00
## Platforms
2012-02-02 12:51:15 +00:00
2017-10-30 05:06:20 +00:00
RetroArch has been ported to the following platforms:
2012-02-02 12:51:15 +00:00
2017-12-25 02:47:40 +00:00
- DOS
2022-05-21 21:40:28 +00:00
- Windows 11
- Windows 10
- Windows 8
- Windows 7
- Windows Vista
- Windows XP
- Windows Millennium
- Windows 2000
- Windows NT 3.5
- Windows 98
- Windows 95
2017-10-30 05:06:20 +00:00
- Linux
2018-05-31 17:26:35 +00:00
- Emscripten (WebAssembly and JavaScript)
2017-11-01 04:49:41 +00:00
- FreeBSD
2017-11-06 17:03:33 +00:00
- NetBSD
2018-01-03 03:49:46 +00:00
- OpenBSD
- Haiku
2018-01-21 19:48:11 +00:00
- Solaris
2022-05-21 21:40:28 +00:00
- Apple macOS (PPC, x86-32 and x86-64)
- Apple iOS
- Apple tvOS
- Android (2.x to most recent version)
- PlayStation2
- PlayStation3
- PlayStation4
2017-10-30 02:34:43 +00:00
- PlayStation Portable
2018-01-03 03:49:46 +00:00
- PlayStation Vita
- Original Microsoft Xbox
- Microsoft Xbox 360 (Libxenon/XeXDK)
2022-05-21 21:40:28 +00:00
- Microsoft Xbox One
- Microsoft Xbox Series S/X
2018-05-31 17:26:35 +00:00
- Nintendo GameCube
- Nintendo Wii
2018-05-04 02:55:30 +00:00
- Nintendo Wii U
2020-03-07 20:26:28 +00:00
- Nintendo 3DS/2DS
2018-01-03 03:49:46 +00:00
- Nintendo Switch
2018-05-31 17:26:35 +00:00
- Nintendo NES/SNES Classic Edition
2012-06-19 21:57:46 +00:00
- Raspberry Pi
2013-03-22 13:52:25 +00:00
- Blackberry
2022-05-21 21:40:28 +00:00
- OpenDingux
- Miyoo
- RS90
- RetroFW
2012-02-02 12:51:15 +00:00
2013-10-02 08:54:03 +00:00
## Dependencies (PC)
2010-12-24 01:00:13 +00:00
2016-02-24 17:52:33 +00:00
There are no true hard dependencies per se.
2010-12-24 01:00:13 +00:00
2016-02-24 17:52:33 +00:00
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
2013-03-16 11:46:15 +00:00
- X11 headers and libs, or EGL/KMS/GBM
2013-10-02 08:54:03 +00:00
OSX port of RetroArch requires latest versions of XCode to build.
2010-12-24 01:00:13 +00:00
2012-04-21 21:27:15 +00:00
RetroArch can utilize these libraries if enabled:
2010-12-24 01:00:13 +00:00
- nvidia-cg-toolkit
2011-01-25 12:24:51 +00:00
- libfreetype2 (TTF font rendering on screen)
2010-12-24 01:00:13 +00:00
2012-04-21 21:27:15 +00:00
RetroArch needs at least one of these audio driver libraries:
2010-12-24 01:00:13 +00:00
- ALSA
- OSS
- RoarAudio
- RSound
- OpenAL
2011-01-01 15:03:15 +00:00
- JACK
2011-01-25 12:24:51 +00:00
- SDL
2011-01-29 00:15:09 +00:00
- PulseAudio
2013-03-22 13:52:55 +00:00
- XAudio2 (Win32, Xbox 360)
2013-03-22 13:52:25 +00:00
- DirectSound (Win32, Xbox 1)
2013-03-16 11:46:15 +00:00
- CoreAudio (OSX, iOS)
2010-12-24 01:00:13 +00:00
2018-03-20 07:54:23 +00:00
To run properly, RetroArch requires a libretro implementation present; however, as it's typically loaded
2012-04-16 16:40:56 +00:00
dynamically, it's not required at build time.
2010-12-24 01:10:47 +00:00
2013-10-02 08:54:03 +00:00
## Dependencies (Console ports, mobile)
2012-04-16 16:52:14 +00:00
Console ports have their own dependencies, but generally do not require
anything other than what the respective SDKs provide.
2022-05-21 21:40:28 +00:00
## Requirements
2022-05-21 21:52:33 +00:00
### OpenGL1 ###
To run this driver, your videocard needs to at least support the OpenGL 1.1 spec.
**Shaders**: Since OpenGL 1.x has no shader capabilities whatsoever, it is not possible
to use shaders with this driver.
**Menu driver support**: MaterialUI, XMB, Ozone and RGUI should all work correctly.
XMB won't have shader pipeline effects because of the aforementioned lack of shader
support.
### OpenGL2 ###
To run this driver, your videocard needs to at least support the OpenGL 2.1 spec.
***Shaders:*** You can choose between either NVIDIA Cg shaders (deprecated, requires separate runtime
to be installed on your system), or GLSL shaders.
***Menu driver support:*** MaterialUI, XMB, Ozone and RGUI should all work correctly.
### OpenGL3 ###
To run this driver, your videocard needs to at least support the OpenGL 3.2 core feature spec.
***Shaders:*** You will be able to use modern Slang shaders with this driver.
***Menu driver support:*** MaterialUI, XMB, Ozone and RGUI should all work correctly.
### Direct3D 11 ###
The Direct3D11 driver needs a graphics card that supports at least Feature Level 11.0. The card
2022-05-21 21:40:28 +00:00
also needs to support at least Shader Model 4.0.
2022-05-21 21:52:33 +00:00
***Shaders:*** You will be able to use modern Slang shaders with this driver.
***Menu driver support:*** MaterialUI, XMB, Ozone and RGUI should all work correctly.
2022-05-21 21:40:28 +00:00
2013-10-02 08:54:03 +00:00
## Configuring
2018-03-20 07:54:23 +00:00
The default configuration is defined in `config.def.h` .
2013-10-02 08:54:03 +00:00
It is not recommended to change this unless you know what you're doing.
These can later be tweaked by using a config file.
2018-03-20 07:54:23 +00:00
A sample configuration file is installed to `/etc/retroarch.cfg` . This is the system-wide config file.
2010-12-24 01:00:13 +00:00
2018-03-20 07:54:23 +00:00
RetroArch will on startup create a config file in `$XDG\_CONFIG\_HOME/retroarch/retroarch.cfg` if it does not exist.
2013-10-02 08:54:03 +00:00
Users only need to configure a certain option if the desired value deviates from the value defined in config.def.h.
2010-12-24 01:00:13 +00:00
2016-12-10 21:02:39 +00:00
To configure joypads, use the built-in menu or the `retroarch-joyconfig` command-line tool.
2010-12-24 01:00:13 +00:00
2013-10-02 08:54:03 +00:00
## Compiling and installing
2016-12-11 19:55:31 +00:00
2017-10-30 05:06:05 +00:00
Instructions for compiling and installing RetroArch can be found in the [Libretro/RetroArch Documentation Center ](https://docs.libretro.com/ ).
2018-03-26 14:48:53 +00:00
2018-03-26 16:41:09 +00:00
## CRT 15Khz Resolution Switching
2018-03-26 14:48:53 +00:00
2019-02-03 23:49:35 +00:00
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.
2018-03-26 14:48:53 +00:00
2018-05-31 17:26:35 +00:00
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:
2018-03-26 14:48:53 +00:00
- 2560 x 192 @ 60.000000
- 2560 x 200 @ 60.000000
- 2560 x 240 @ 60.000000
2018-03-26 14:54:23 +00:00
- 2560 x 224 @ 60.000000
2018-03-26 14:48:53 +00:00
- 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
2018-05-31 17:26:35 +00:00
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:
2018-03-26 14:48:53 +00:00
- 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
2018-05-04 02:55:30 +00:00
Some games will require higher PAL resolutions which should also be installed:
2018-03-26 14:48:53 +00:00
- 2560 x 512 @ 50.000000
- 2560 x 576 @ 50.000000
2018-03-26 16:39:51 +00:00
Ideally install all these modelines and everything will work great.
2018-03-26 14:48:53 +00:00
## Super Resolutions
2018-05-04 02:55:30 +00:00
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.
2018-03-26 14:48:53 +00:00
## Native Resolutions
2018-05-04 02:55:30 +00:00
If native resolutions are activated you will need a whole new set of modelines:
2018-03-26 14:48:53 +00:00
2018-11-20 00:36:01 +00:00
- 256 x 240 @ 50.006977 SNESpal
- 256 x 448 @ 50.006977 SNESpal
2018-03-26 14:48:53 +00:00
- 512 x 224 @ 50.006977 SNESpal
2018-11-20 00:36:01 +00:00
- 512 x 240 @ 50.006977 SNESpal
2018-03-26 14:48:53 +00:00
- 512 x 448 @ 50.006977 SNESpal
2018-11-20 00:36:01 +00:00
- 256 x 240 @ 60.098812 SNESntsc
- 256 x 448 @ 60.098812 SNESntsc
2018-03-26 14:48:53 +00:00
- 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
2018-11-20 00:36:01 +00:00
- 320 x 224 @ 59.922745 MDntsc
- 320 x 240 @ 59.922745 MDntsc
- 320 x 448 @ 59.922745 MDntsc
- 320 x 480 @ 59.922745 MDntsc
2018-03-26 14:48:53 +00:00
- 256 x 192 @ 49.701458 MDpal
2018-11-20 00:36:01 +00:00
- 256 x 224 @ 49.701458 MDpal
2018-03-26 14:48:53 +00:00
- 320 x 224 @ 49.701458 MDpal
- 320 x 240 @ 49.701458 MDpal
2018-11-20 00:36:01 +00:00
- 320 x 288 @ 49.701458 MDpal
2018-03-26 14:48:53 +00:00
- 320 x 448 @ 49.701458 MDpal
- 320 x 480 @ 49.701458 MDpal
2018-11-20 00:36:01 +00:00
- 320 x 576 @ 49.701458 MDpal
2018-03-26 14:48:53 +00:00
- 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
2018-11-20 00:36:01 +00:00
- 640 x 480 @ 60.130001 N64ntsc
- 640 x 288 @ 50.000000 N64pal
2018-03-26 14:48:53 +00:00
- 640 x 480 @ 50.000000 N64pal
2018-11-20 00:36:01 +00:00
- 640 x 576 @ 50.000000 N64pal
2018-03-26 14:48:53 +00:00
- 256 x 252 @ 49.759998 PSXpal
- 320 x 252 @ 49.759998 PSXpal
2018-11-20 00:36:01 +00:00
- 384 x 252 @ 49.759998 PSXpal
2018-03-26 14:48:53 +00:00
- 640 x 252 @ 49.759998 PSXpal
2018-11-20 00:36:01 +00:00
- 640 x 540 @ 49.759998 PSXpal
2018-03-26 14:48:53 +00:00
- 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
2018-05-04 03:02:22 +00:00
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.
2018-03-26 14:48:53 +00:00
2018-05-31 17:26:35 +00:00
## CRT resolution switching & MAME
2018-03-26 14:48:53 +00:00
2018-05-31 17:26:35 +00:00
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.
2018-03-26 14:48:53 +00:00
2018-05-31 17:26:35 +00:00
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.
2020-03-07 20:26:28 +00:00
## 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.
- [Website ](https://www.retroarch.com/ )
- [Blog ](https://libretro.com/ )
- [Facebook ](https://www.facebook.com/libretro )
- [Twitter ](https://twitter.com/libretro )
- [Reddit ](https://www.reddit.com/r/RetroArch/ )
- [YouTube ](https://www.youtube.com/Libretro )
- [Google Post ](https://posts.google.com/share/55Nhs2jG )
- [Steam ](https://store.steampowered.com/app/1118310/RetroArch/ )
- [YouTube Topic ](https://www.youtube.com/channel/UC5q007PYyQPgin0HHbzF0zQ )
- [Patreon ](https://www.patreon.com/libretro )
- [BOUNTYSOURCE ](https://www.bountysource.com/teams/libretro/issues )
- [Discord ](https://discord.gg/27Xxm2h )
- [Teespring ](https://teespring.com/stores/retroarch )
- [Documentation ](https://docs.libretro.com/ )
- [Forum ](https://forums.libretro.com/ )