RPCS3

An open-source PlayStation 3 emulator/debugger written in C++.

You can find some basic information in the FAQ. For discussion about this emulator and PS3 emulation please visit the official forums.

Official Discord server: https://discord.me/RPCS3

Support Nekotekina on Patreon: https://www.patreon.com/Nekotekina

Development

If you want to contribute please take a look at the Coding Style, Roadmap and Developer Information pages. You should as well contact any of the developers in the forum in order to know about the current situation of the emulator.

Dependencies

Windows

Visual Studio 2015
Visual C++ Redistributable Packages for Visual Studio 2015
Cmake 3.1.0+ (required; add to PATH)
Python 3.3+ (required; add to PATH)

Linux

GCC 5.1+ or Clang 3.5.0+ (not GCC 6.1)
Debian & Ubuntu: sudo apt-get install cmake build-essential libasound2-dev libopenal-dev libwxgtk3.0-dev libglew-dev zlib1g-dev libedit-dev libvulkan-dev git
Arch: sudo pacman -S glew openal wxgtk cmake llvm

Mac OSX Mac OSX is not supported at this moment because it doesn't meet system requirements (OpenGL 4.3)

Xcode 6+ (tested with Xcode 6.4)
Install with Homebrew: brew install glew wxwidgets
Remove '-framework QuickTime' from '_ldflags' in /usr/local/bin/wx-config

Building

Windows:

To initialize the repository don't forget to execute git submodule update --init to pull the submodules.
Open the .SLN file.
Build the projects in __BUILD_BEFORE folder: right-click on every project > Build.
Press BUILD > Build Solution or Rebuild Solution.

Linux & Mac OSX:

git clone https://github.com/RPCS3/rpcs3.git
cd rpcs3/
git submodule update --init
cmake CMakeLists.txt && make GitVersion && make
Run RPCS3 with ./bin/rpcs3

If you are on OSX and want to build with llvm don't forget to add -DLLVM_DIR=... (or wherever llvm brew was installed) to cmake invocation.

When using GDB, configure it to ignore SIGSEGV signal (handle SIGSEGV nostop noprint).

CMake Build Options (Linux & Mac OSX)

-DUSE_SYSTEM_LIBPNG=ON/OFF (default = OFF)
Build against the shared libpng instead of using the builtin one. libpng 1.6+ highly recommended. Try this option if you get version conflict errors or only see black game icons.
-DUSE_SYSTEM_FFMPEG=ON/OFF (default = OFF)
Build against the shared ffmpeg libraries instead of using the builtin patched version. Try this if the builtin version breaks the OpenGL renderer for you.

License

Most files are licensed under the terms of GNU GPLv2 License, see LICENSE file for details. Some files may be licensed differently, check appropriate file headers for details.

3.6 KiB Raw Blame History