README 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384
  1. RetroArch is the reference frontend for the libretro API. Popular
  2. examples of implementations for this API includes videogame system
  3. emulators and game engines, but also more generalized 3D programs.
  4. These programs are instantiated as dynamic libraries. We refer to these
  5. as "libretro cores".
  6. libretro is an API that exposes generic audio/video/input callbacks. A
  7. frontend for libretro (such as RetroArch) handles video output, audio
  8. output, input and application lifecycle. A libretro core written in
  9. portable C or C++ can run seamlessly on many platforms with very
  10. little/no porting effort.
  11. While RetroArch is the reference frontend for libretro, several other
  12. projects have used the libretro interface to include support for
  13. emulators and/or game engines. libretro is completely open and free for
  14. anyone to use.
  15. RetroArch will require at least one of the libretro cores to play any
  16. games.
  17. Optional dependencies:
  18. ffmpeg jack-audio-connection-kit libsixel libxkbcommon mbedtls
  19. miniupnpc nvidia-cg-toolkit OpenAL python3 qt5 SDL2 vulkan-sdk
  20. wayland-egl wayland-protocols
  21. Note: RetroArch can optionally use wayland-protocols during the build if
  22. it is installed. Instead of installing wayland-egl mesa can be rebuilt
  23. with Wayland support, using the following configure parameters.
  24. --with-egl-platforms=x11,drm,wayland
  25. To build debugging symbols for RetroArch use:
  26. DEBUG=yes ./RetroArch.SlackBuild
  27. If building debugging symbols asan can also be built:
  28. DEBUG=yes ASAN=yes ./RetroArch.SlackBuild
  29. Discord integration can be enabled with:
  30. DISCORD=yes
  31. Python3 support for shaders will need to be enabled with:
  32. PYTHON=yes ./RetroArch.SlackBuild
  33. If pulseaudio is installed it can be disabled during the build with:
  34. PULSE=no ./RetroArch.SlackBuild
  35. The Qt5 frontend can be disabled with:
  36. QT=no ./RetroArch.SlackBuild
  37. The materialui menu driver can be disabled with:
  38. GLUI=no ./RetroArch.SlackBuild
  39. The ozone menu driver can be disabled with:
  40. OZONE=no ./RetroArch.SlackBuild
  41. The rgui menu driver can be disabled with:
  42. RGUI=no ./RetroArch.SlackBuild
  43. The xmb menu driver can be disabled with:
  44. XMB=no ./RetroArch.SlackBuild
  45. All of the menu drivers can be disabled with:
  46. MENU=no ./RetroArch.SlackBuild
  47. Alternatively pulseaudio can be disabled later in RetroArch's
  48. configuration.
  49. Retroarch optionally supports using OpenGL ES 2 and OpenGL ES 3 instead
  50. of OpenGL which will require video card and driver support. This can be
  51. done by building RetroArch with:
  52. GLES=yes ./RetroArch.SlackBuild
  53. or
  54. GLES3=yes ./RetroArch.SlackBuild
  55. RetroArch optionally supports using Vulkan instead of OpenGL, this will
  56. require the vulkan-sdk from SBo and support for your video card and
  57. driver.
  58. For additional notes, please see README.SLACKWARE.
  59. For more information on RetroArch or libretro please visit this site.
  60. https://docs.libretro.com/