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.

To download fresh development builds for Android, Windows and Mac, go to the /devbuilds page

For game compatibility, see community compatibility feedback.

What's new in 1.18

• Platform support
  • Improved iOS/Mac support, Game Mode support (#19287, #19281, #19269, #19270, #19257, #19254, #19244, #19227, #19224, #19213, #19200, #19187, #19184, #19161, #19118)
  • IR Interpreter: work on correctness and optimizations (#19299, #19280, #19268, #19265, #19262, #19260, #19255, #19252, #19240, #19233, #19231, #19193, #19189, #19173, #19128)
  • Interpreted Vertex Decoder optimizations: (#19243, #19241)
  • SDL fixes: (#19131)
  • Legacy Edition for old Android TV (only for download on the website): (#19401)
  • Android and Windows shortcuts - add icons and bugfixes: (#19139, #19142, #19138)
  • Improve performance of CHD loading (#18931)
• UI
  • Many crash, hang and performance fixes around the UI (#18950, #19561, #19556, #19531, #19507, #19523, #19529, #19482, #19473, #19438 #19165)
  • New post proc filter "Sharp bilinear" (#19530)
  • Misc UI fixes (#19505, #19492, #19126, #19020)
  • 3 new themes (#19504)
  • Game info in-game (#19471)
  • New remote iso UI (#19293)
  • Install save games from ZIP file (#19443, #19436)
  • More input-mappable actions like Reset, allow mapping Alt key (#19472, #19484, #19304)
  • Homebrew Store: Added website links, license info: (#19425, #19426)
  • RetroAchievements: Can now hash homebrew apps (#19096), RAIntegration support (#19002)
  • Fix regression of the AxisSwap feature (#19059)
• Emulation
  • Misc crash fixes: (#19563, #19546, #19491, #19358, #19347, #19198)
  • Vulkan barrier fixes: ( #19009, #19017, #19018)
  • Misc compatibility fixes (#19560)
  • Misc filesystem fixes (FDs, date/time) (#19459, #19340)
  • Workaround for The Warriors video playback (#19450)
  • Expose GPI switches and GPO leds, accessible in developer settings
  • Fix regression caused by the fix for UFC Undisputed (#18806)
  • Broke out the Atrac3+ code from ffmpeg for easier debugging and maintenance (#19033, #19053, more)
  • implement sysclib_sprintf (#19097)
• Rendering fixes
  • Socom FB3 depth buffer problem in menu (#19490)
  • Platypus: Glitchy transparency with OpenGL (#19364)
  • Syphon Filter: Logan's Shadow: Dark lighting in OpenGL (#19489)
  • MGS2 Acid errors on AMD GPUs (#19439)
  • Fix regression in Genshou Suikoden (#19122)
  • Fix HUD glitch in GTA LCS by emulating "provoking vertex" correctly (#19334)
• Debugging improvements
  • MIPSTracer - a new (rough) debugging tool by Nemoumbra (#19457)
• VR
  • New immersive mode (makes better use of reprojection by extending the rendered area) (#19361)
  • A lot of fixes by Lubos (#19420, #19416, #19389, #19390, #19361, #19092, ...)
• Misc
  • The CHD file format is better supported and performance has been drastically improved (#18924, #18931)

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)