ppsspp/README.md

PPSSPP - a fast and portable PSP emulator

Created by Henrik Rydgård

Additional code by many contributors, see the Credits screen

Originally released under the GPL 2.0 (and later) in November 2012

Official website: https://www.ppsspp.org/

Discord: https://discord.gg/5NJB6dD

No BIOS file required to play, PPSSPP is an "HLE" emulator. Default settings balance good compatibility and speed.

To contribute, see the development page. Help testing, investigating, or fixing is always welcome. See the list of issues.

For the latest source code, see our GitHub page.

For documentation of all kinds (usage, reference, development), see the documentation on the main website

For build instructions and other development tutorials, see the wiki.

If you want to download regularly updated builds for Android, Windows x86 and x64, visit Orphis' buildbot

For game compatibility, see community compatibility feedback.

What's new in 1.16

• RetroAchievements support ([#17589], [#17631], many more). See RetroAchievements on ppsspp.org.
• New JIT backends:
  • RISC-V, based on IR, by unknownbrackets
  • x86 based on IR, by unknownbrackets. May end up faster than the existing one.
• Input fixes
  • Improve behavior when analog and digital inputs clash ([#17960])
  • Combo mapping is now disabled by default ([#17673])
  • Android: Better tracking of devices names ([#17562], auto config)
  • Fix mapping custom touch buttons to analog inputs ([#17433])
• Rendering performance and fixes
  • Fix flicker in WWE Smackdown vs Raw 2006 ([#18009]), video flicker in Naruto 2 ([#18008])
  • Fix bad colors in Syphon Filter: Logan's Shadow menu ([#17965])
  • On lower-end, revert shaders to be less "uber" ([#17449], [#17922])
  • Allow disabling V-sync on Android with Vulkan ([#17903])
  • On Vulkan, disable multithreaded rendering if buffered commands are set to off ([#17831])
  • Assorted minor perf ([#17810], [#17505], [#17478], [#17471], [#17452], [#17446], [#17442])
  • Fix shadows in MotorStorm ([#17602]) (not actually a rendering problem)
  • Fix rendering issue in Lunar Silver Star ([#17451])
  • Add a cache for MakePixelsTexture, improving perf in God of War ([#17534])
  • Lots of software renderer improvements ([#17571], [#17569], [#17619], [#17621], [#17618], [#17609], ...)
• Networking
  • HTTPS support now enabled in store and for RA on Windows, Android, Mac, iOS ([#17744], ...)
  • Ad-hoc: Fix for Metal Gear Acid issue with Link Battle ([#17947])
• Texture replacement fixes
  • Fix Tactics Ogre texture issues ([#18001], [#18011])
  • Fix problem with anisotropic filtering ([#17930])
  • Fix glitches on D3D11 with KTX2 textures ([#17749])
• UI changes
  • Color emoji support on some platforms ([#17854], [#17856])
  • Use TTF fonts on SDL where available ([#17844]), support HiDPI ([#17651])
  • Allow setting the PSP's MAC address directly ([#17755])
  • Better looking notifications ([#17606], [#17674], [#17672])
• Cheats
  • Fix loading cheat dbs on Android devices with scoped storage ([#17834])
• Other
  • Fix timing issue causing slowdowns in MLB games ([#17676], [#17677])
  • UWP keyboard support, many other updates ([#17952], [#17974])
  • Make vrnd instruction much more accurate ([#17506], [#17549])
  • Allow choosing the display resolution on Android again ([#17473])
  • Fix issue running some file types out of the Download folder on Android ([#17466])

What's new in 1.15.4

• Tilt controls: Restore "Low end radius" control ([#17489])
• Android: Restore the ability to choose "display" (hardware scaler) resolution ([#17473])
• Improve the workarounds for the DJ Max games ([#17467])
• Android: Fix running some file formats directly from the Downloads folder ([#17466])
• OpenGL: Restore most of the lost performance on low-end hardware from the shader variant reduction ([#17440, [#17439]])
• Add a simple profiling tool to check CPU usage by the GL backend ([#17475])
• Loader: Fix bug preventing WWE 2009 from starting ([#17435])
• Misc minor fixes and optimizations ([#17442], [#17457], [#17486], [#17446], more)

What's new in 1.15.3

• Assorted minor crash- and other fixes ([#17406], [#17414], [#17415], [#17422])
• Android: Allow launch by content URI (for frontends) ([#17425])
• Control mapping: Fix bugs in mapping UI causing trouble with some controllers ([#17412], [#17420])

What's new in 1.15.2

• Assorted minor crash fixes (#17401, #17399)
• Fix Android 12 support in the Android VR build (avoid scoped storage) ([#17398])

What's new in 1.15.1

• Assorted minor crash fixes (#17374, #17370, #17392, #17394)
• Fix for non-png texture replacements when not listed in textures.ini (#17380)
• Fix for broken tilt d-pad controls (#17393)
• Workaround for Vulkan driver bugs on Mali-T8x0 series GPUs (#17396)

What's new in 1.15

• Stutter caused by shader compilation has been reduced drastically (#16873)

  • Parallelization: (#16802, #16804, #16809, #16812)
  • Shader variant reduction: (#16773, #16778, #16770, #16763)

• Rendering performance and fixes

  • Integer scaling added (#17224)
  • Post-processing fixes (#17262)
  • SOCOM overlay glitch removed, night vision fixed (#17297, #17317)
  • PowerVR compatibility fixes (#17232)
  • CLUT fixes (#17212)
  • ToP - Narikiri Dungeon X: Avoid GPU readback (#17181, #17191, #17192)
  • DTM / Toca: Avoid GPU readback (#16715)
  • Fixed Dante's Inferno performance regression (#17032, #17035)
  • Fix wrong device selection on Poco C40 phones, causing broken UI (#17027, #17022)
  • Rainbow Six GPU performance fix (#16971)
  • Subtitles fixed in The Godfather (#17298, #17314)

• Texture replacement improvements

  • Less I/O on the main thread, leading to smoother framerates (#17078, #17091, #17120, #17134)
  • Support for KTX2 files with UASTC compressed textures added (#17111 #17104)
  • Support for DDS files with BC1-7 textures added (#17083, #17103, #17097, #17096, #17095)
  • Improve default ini (#17146)
  • Mipmaps now always used if provided (#17144)
  • Additional optimizations (#17139, #17088)

• Optimizations

  • Software renderer fixes and performance (#17295, #17214, #17028, #16753, #16706, #16690)
  • Vulkan texture upload optimizations (#17052, #17122, #17121, #17114, #17011)
  • Depth readback added, fixing lens flares in Syphon Filter (at perf cost..) (#16907, #16905)
  • Async readback supported in Vulkan - currently only enabled in Dangan Ronpa (#16910, #16916)
  • Lighting shader optimizations (#16791, #16787)

• Controls

  • Android tilt control has been overhauled and fixed (#16889, #16896)
  • You can now map combinations of buttons to single functions (#17210, #17215, #17228, etc)
  • Custom buttons now support analog inputs (#16855)

• VR features

  • Top down camera: (#17098)
  • Head rotation control: (#16857)
  • More stereo support: (#16952, #16953)
  • Other: (#16826, #16821)

• Other

  • Windows Dark Mode support (#16704)
  • GLSL shader compatibility fixes (#16710, #16709)
  • GTA math issue on macOS/iOS fixed, playable again (#16928)
  • More accurate VFPU emulation has been added, though not all enabled yet (#16984)
  • Debugger features and fixes (#17270, #17269, #17263, #17260, #17203, #17190, #17042, #16994, #16988, #16818 etc)
  • Rewind savestates no longer slows things down a lot (#17291)
  • Chat window bugfixes (#17241)
  • IR Jit fixes - helps iOS when native jit is unavailable (#17129)
  • Depth-related rendering fixes (#17055, #16880)
  • More RISCV support work (#16976, #16957, #16962, #16832, #16829)
  • macOS native menu bar (#16922)
  • Font fixes (#16859)
  • Rockman 2 audio glitch fix (#16810, #16798)
  • UI fixes: Vertical use of space (#16795), scrollbars (#16785), touchpad scroll on Windows (#16699)

Looking for older news?

Adhoc support

Not fully functional, but some games work. Check the Ad-Hoc section of the forum for help.

Credit goes to:

• ANR2ME
• Igor Calabria
• coldbird's code
• Kyhel
• And more, of course.

[#17398]: https://github.com/hrydgard/ppsspp/issues/17398 "OpenXR - Cleanup unsupported features, support Android 12"[#17406]: https://github.com/hrydgard/ppsspp/issues/17406 "Even more crash fixes" [#17414]: https://github.com/hrydgard/ppsspp/issues/17414 "GPU: Remove JumpFast/CallFast" [#17415]: https://github.com/hrydgard/ppsspp/issues/17415 "Misc fixes and checks" [#17422]: https://github.com/hrydgard/ppsspp/issues/17422 "Windows: Fix initial window show for all displays" [#17425]: https://github.com/hrydgard/ppsspp/issues/17425 "Android: Explicitly allow content URI intents" [#17412]: https://github.com/hrydgard/ppsspp/issues/17412 "Controller mapping fixes" [#17420]: https://github.com/hrydgard/ppsspp/issues/17420 "Fix glitch when mapping analog inputs, caused" [#17489]: https://github.com/hrydgard/ppsspp/issues/17489 "Restore "low end radius" (inverse deadzone) for tilt input" [#17473]: https://github.com/hrydgard/ppsspp/issues/17473 "Revert "Remove the Android display resolution selector"" [#17467]: https://github.com/hrydgard/ppsspp/issues/17467 "Make the DJ Max workaround more aggressive about hiding stuff." [#17466]: https://github.com/hrydgard/ppsspp/issues/17466 "Fix running some file formats from the Downloads folder" [#17440]: https://github.com/hrydgard/ppsspp/issues/17440 "Revert lmode variant reduction" [#17439]: https://github.com/hrydgard/ppsspp/issues/17439 "Revert "Merge pull request #16628 from hrydgard/remove-fog-fshader-flag"" [#17475]: https://github.com/hrydgard/ppsspp/issues/17475 "Add a trivial profiling tool to the OpenGL backend" [#17435]: https://github.com/hrydgard/ppsspp/issues/17435 "ElfLoader: Don't scan for functions in zero-length sections" [#17442]: https://github.com/hrydgard/ppsspp/issues/17442 "Shrink the GLRRenderCommand struct from 152 to 88" [#17457]: https://github.com/hrydgard/ppsspp/issues/17457 "UI: Fix thread error on zip open failure" [#17486]: https://github.com/hrydgard/ppsspp/issues/17486 "Build fixes for OpenBSD" [#17446]: https://github.com/hrydgard/ppsspp/issues/17446 "OpenGL: Combine some render commands"