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.17.1

• Fixed green rendering errors on some PowerVR GPUs (#18781)
• Release all held keys on pause to avoid "stuck keys" after unpausing or in run-behind-pause (#18786)
• UI fixes (#18785)
• Update libchdr with zstd support, warn the user about bad CHDs (#18824, #18803)
• Add workaround for AdHoc mode in Resistance (#18821)
• Fix graphics in Tokimeki Memorial 4 (#18822)
• Fix crash in UFC 2010 on Mali GPUs (#18813)
• Temporarily disable MSAA on Adreno GPUs due to crashing (#18819)
• Fixed some crashes and optimized the game metadata cache (#18794, #18775)
• Additional crashfixes and similar (#18777, #18779, #18823)
• Fixed playback of frame dumps with Vulkan (#18793)
• Volume slider added for RetroAchievements sounds (#18772)

What's new in 1.17

• Rendering performance and fixes
  • Fix for very old rendering issue in Tokimeki Memorial 4 (#18650) (didn't quite work, see 1.17.1)
  • Performance improvement in Tactics Ogre by avoiding a readback (#18599)
  • Cull small draws that are quick to check that they are offscreen (#18446)
  • Assorted optimizations (#18586, #18573, #18476, #18413, #18416, #18219)
  • Fix HUD in Tiger Woods 06 (#18554)
  • Adrenotools support added - you can now load custom Vulkan drivers on Adreno (#18532, #18548, #18699)
  • Fix rendering with bad Z parameters, fixes homebrew Zig example (#18535)
  • Fix Z problem in Hayate no Gotoku!! Nightmare Paradise #18478
  • Fix frozen pitch meters in MLB games (#18484)
  • Enable MSAA on modern mobile devices (Vulkan-only) (#18472)
  • Fix video flicker in Naruto: Ultimate Ninja Heroes 2 (#18454)
• UI
  • Track total time played per game (#18442)
  • When opening the pause menu, there's now an option to keep the game running behind the menu. This is enforced in multiplayer to avoid inadvertent desyncs (#18517, #18515)
• ISO loading improvements
  • The CHD file format is now fully supported (use chdman createdvd!), including with Remote ISO and Retroachievements
  • Improvements to remote ISO: optional tab on home screen, can now share whole folders (#18627, #18639, #18640, #18631, #18632, #18633,)
• Controller and touchscreen fixes
  • More control bindings, organize into categories (#18635, #18589)
  • Fix inverse deadzone (low end) for joystick input
  • Fix analog deadzones for XInput controllers (#18407)
  • Improved tilt control further (#18533)
  • Mouse input supported on Android (#18551, #18473)
  • Customizable threshold for analog-trigger to button-press mapping, customizable delay for mouse-scroll key-up (#18621, #18585)
  • Make it work better to bind an analog stick to four buttons, useful for camera control in some games
  • Can now unpause with the key you bound to pause (#18591)
• Other fixes and updates
  • More work on the IR JITs (#18234, #18235, #18228, #18227, #18226, many more)
  • Moving the memstick directory on Android is now faster and safer #18744
  • Workaround problems in Add Doko Demo Issho, Driver 76, Harukanaru Toki no Naka, Ace Combat by slowing down the emulated UMD drive to match reality better (#18436, #18445)
  • VR: Quest 3 rendering issues fixed (#18677)
  • Various bugfixes in texture replacement (#18638, #18610, #18519, #18466, #18747)
  • RetroAchievements: Rich presence, renamed Challenge Mode back to the recommended Hardcore Mode, various error handling improvements, configure per game (#18468, #18651, #18488, #18428, #18425)
  • HLE: Slice large-and-slow memcpy/memset operations, can help with some stalls. (#18560)
  • Other various minor fixes and optimizations (#18558, #18555, #18538, #18529, #18450, #18314, #18233, #18678, #18749, #18736, #18704)
  • SoftGPU fixes (#18362)
  • Fixed international fonts on Steam Deck (#18732, #18734)
  • GoExplore (GPS app) now starts up and allows navigation (#18665, #18666, #18668, #18669)
  • SDL: Improve input latency in Vulkan mode by running rendering on a separate thread (#18268)
  • Assorted multiplayer fixes (#18435)
  • Support for emulating the infrared port of the original PSP through sceSircs (#18684)

What's new in 1.16.6

• Fix performance issue with Vulkan descriptor set allocation (#18332)
• Smoother loading of replacement textures
• Fix the store on iOS (#18323)
• Fix problem with waves background (#18310)
• Some translation updates
• Other minor fixes

What's new in 1.16.5

• Additional crash and memory-leak fixes (#18243, #18244, #18247)
• Revert bad change that broke things with hardware transform turned off (#18261)
• Fix menu texture problem in Naruto Kizuna Drive in OpenGL (#18255)
• Apply flicker fix to WWE SvR 2007
• More efficient handling of accelerometer events (#18250)
• Fix for jumpy graphics in Harvest Moon (#18249)

What's new in 1.16.4

• Simplify shader cache lookups on Vulkan, hopefully fixing some crashes (#18218)
• Assorted improvements to the IR JITs (#18228, #18235, #18211, more)
• Other crash and stability fixes (#18221, #18220, #18230, #18216)
• Some translation updates (#18237, more)
• Cleanups and assert fixes (#18205, #18201, #18206)

What's new in 1.16.3

• Fix crash bug and performance issue in Vulkan shader cache (#18183, #18189)
• Fix crash in icon loading in homebrew store (#18185)
• Add some memory safety check (#18184, #18194)
• Fix problem when changing backend from the Windows menu (#18182)

What's new in 1.16.2

• Fix for HTTP support on Linux on networks with shaky or incomplete IPv6 support
• Assorted fixes for leaks and crashes (#18169, #18151)
• Fix hang when switching UMD with RetroAchievements enabled (#18143)
• Fix math bug in new IR JIT for x86 (#18165)
• Minor math optimization -fno-math-errno (#18158)
• Fix for software renderer crash

What's new in 1.16.1

• Move RetroAchievements to the Tools tab in settings (#18127)
• Fix graphics regressions in Hot Shots Golf 2 / Everybody's Golf 2 and Final Fantasy Tactics (#18142)
• Fix hang on startup with OpenGL, that happened often if "buffer commands" was set to off.
• Fix problem with the sc instruction that broke Beats (#18133, #18140)
• Fix problem with the chat window accidentally closing on typing X (#18135)
• Fix some crashes, add some asserts and reporting hooks (#18129)
• Fix some text rendering in the software renderer (#18126)

What's new in 1.16

Special thanks to unknownbrackets for the new JIT compilers, and fp64 for finally cracking the vrnd instruction.

• RetroAchievements support (#17589, #17631, many more). See RetroAchievements on ppsspp.org.
• New JIT backends:
  • RISC-V, based on IR
  • x86 JIT based on IR. Often 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 devices, avoid "uber" shaders due to performance and driver bugs (#17449, #17922)
  • Allow disabling V-sync on Android with Vulkan, more SDL platforms (#17903, #18087)
  • On Vulkan, reduce input lag when "Buffer graphics commands" is 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 (macOS, Linux/Steam Deck) (#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)
• VR (Quest, other Android VR devices)
  • Cinema screen mode improvements (#17704, #17752)
  • Quest-only passthrough mode (#17591)
  • Cleanups, compatibility fixes, make VR settings per-game (#17636, #17656, #17598, #17518)
• Other
  • Fix horrible audio glitch in After Burner (#18076)
  • Emulate the vrnd instruction accurately (#17506, #17549)
  • Fix timing issue causing slowdowns in MLB games (#17676, #17677)
  • UWP keyboard support, many other updates (#17952, #17974)
  • Allow choosing the display resolution on Android again (#17473)
  • Fix issue running some file types out of the Download folder on Android (#17466)

Older news

Looking for older news?

You can also find the full update history on the website.

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.