A PSP emulator for Android, Windows, Mac and Linux, written in C++. Want to contribute? Join us on Discord at https://discord.gg/5NJB6dD or in #ppsspp on freenode (IRC) or just send pull requests / issues. For discussion use the forums on ppsspp.org.
Go to file
Xele02 9b92ff3a1f Add missing dialog display
Add Error Log when an Message Dialog Option is not coded
2013-01-01 01:19:33 +01:00
android Fix android build. 2012-12-29 03:34:11 -08:00
assets Build fix for atlas 2012-12-17 02:56:55 +10:00
Common Revert "Save states using gzip, load either way." 2012-12-28 23:57:11 -08:00
Core Add missing dialog display 2013-01-01 01:19:33 +01:00
ext Rewrite the vertex decoder a bit. Turn on SSE2 compiler flag etc. 2012-12-20 15:07:57 +01:00
GPU Add support for selecting the GE callback per list. 2012-12-29 15:55:05 -08:00
headless Fix Headless Windows project for x64 2012-12-30 17:18:36 +01:00
native@1556328129 Non-windows button mapping tweaks 2012-12-26 08:51:03 +01:00
pspautotests@f11966e358 Update pspautotests 2012-12-30 16:29:16 +01:00
Qt Add Verify() method to quickly test states work. 2012-12-28 13:55:22 -08:00
SDL Unified assets/ dir for icons/images 2012-12-17 01:47:39 +10:00
Tools/SaveTool * Add PSP Homebrew for encode/decode save between PSP and PPSSPP. 2012-12-28 11:42:41 +01:00
Windows Arg, I got these backwards. 2012-12-29 16:13:54 -08:00
.gitignore Ignore the .lastcodeanalysissucceeded file. 2012-12-21 20:19:29 -08:00
.gitmodules Add pspautotests as a submodule. 2012-11-09 10:03:05 +01:00
b.sh MacOSX buildfix. Doesn't run right yet though. 2012-11-25 12:25:07 +01:00
CMakeLists.txt Draw offscreen in headless (Windows only.) 2012-12-29 23:21:55 -08:00
gentest.py More work on gentest, fix a VFPU bug it found comparing to real PSP! 2012-11-11 21:32:52 +00:00
Globals.h Fixes and optimizations to vertex decoding and lighting. 2012-11-16 15:16:14 +01:00
LICENSE.TXT Switch to "GPL 2.0 or later" for various reasons. I wrote most of the code I imported from Dolphin (which is GPL2-but-not-later), so it should be OK. 2012-11-04 23:24:00 +01:00
README.md Fix Qt compile for ARM processors. Update README for Qt frontend. 2012-12-23 20:26:18 +10:00
test.py Add gpu/displaylist/state to test list 2012-12-30 16:35:51 +01:00

PPSSPP - a fast and portable PSP emulator

Written by Henrik Rydgård

Released under the GPL 2.0 in November 2012

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

To contribute, see the development page.

For the latest source code and build instructions, see our github page.

Basic build instructions

(for more detailed instructions, see the development page)

First of all, after having checked out the source, don't forget to run:

git submodule update --init

in order to get the "native" library.

Now, the actual building:

PPSSPP currently uses CMake for its build system. In order to build for most systems, create a build directory and run:

cmake path/to/ppsspp
make

Alternatively, run b.sh which will create the directory for you.

You can specify the -G parameter to cmake to choose a generator. The NMake Makefiles, Visual Studio 11 (projects + sln), GNU Makefiles and Unix Makefiles generators have been tested.

Of course in-tree builds are supported, but that makes cleanup harder to do; with out-of-tree builds you can just remove the build directory.

Note: There is also a Qt frontend available. Simply compile PPSSPPQt.pro from QtCreator.

Building for Linux/BSD/etc

Install the libsdl1.2 (SDL 1.2) development headers. This is called libsdl1.2-devel on Debian/Ubuntu, SDL-devel on Fedora/RHEL, sdl12 on BSD ports.

Currently the user interface is identical to Android's, operated with the mouse.

Alternatively, a Qt-based frontend is available in the Qt/ dir.

Building for OSX

Install the Xcode Command Line Tools and, using macports, fink or homebrew, install the SDL development headers. This is called sdl on homebrew. Just follow the basic build instructions afterwards.

Currently the user interface is identical to Android's, operated with the mouse. A Qt-based interface is planned.

Building for Android

To build for android, first you must set the ANDROID_NDK environment variable to point to the path of your NDK install. This is done on windows cmd with set ANDROID_NDK=X:\..., on bourne shells with export ANDROID_NDK=/path/to/ndk, and on C shells with setenv ANDROID_NDK /path/to/ndk.

Create a build-android directory and inside it run:

cmake -DCMAKE_TOOLCHAIN_FILE=path/to/ppsspp/android/android.toolchain.cmake path/to/ppsspp
make

After make finishes, it will have created the needed .so files in path/to/ppsspp/android/libs/armeabi-v7a. You can now use the build.xml in the android/ dir to build the final executable, or import the android/ folder as an existing project in Eclipse.

Note that Eclipse won't notice if you have made changes to the C++ code. Introduce a meaningless change to a random .java file such as a whitespace to get Eclipse to rebuild the project.

Also note that the Visual Studio generators aren't compatible with compilers other than Microsoft's, but NMake Makefiles works fine.

Building for Blackberry

To build for Blackberry, you must first have the latest Native SDK installed.

To set up your environment for cross-compiling you must then use: source ~/bbndk/bbndk-env.sh

Finally, you are ready to compile. Change directory to ppsspp/SDL and run: ./blackberry_build.sh

If you are on Windows, you will need GNU and CMake to run the bash script.

Alternatively, you can use the Qt frontend by compiling the PPSSPPQt.pro in the Qt/ directory with qmake from the NDK or QtCreator 2.6+.

Building for Symbian

To build for Symbian, you require:

  1. GCC 4.6.3 from Mentor Graphics.

  2. Symbian Qt libraries. You can find these in the final Nokia Qt SDK or online.

Then simply compile the PPSSPPQt.pro with qmake from the SDK or QtCreator 2.6+.