PS3 emulator/debugger
Clone or download
Permalink
Failed to load latest commit information.
.github Move Contributing to .github Feb 11, 2018
.travis Add libnsl.so.1 to the AppImage, print resulting upload url Nov 2, 2018
3rdparty Rebase LLVM fork Oct 1, 2018
Utilities fs: normalize atime (ensure atime >= mtime) Nov 17, 2018
Vulkan Update Project to Visual Studio 2017. Aug 24, 2018
asmjit @ 673dcef SPU: add some AVX-512 variants Dec 19, 2017
asmjitsrc CMake: Refactor CMake build (#5032) Sep 18, 2018
bin Qt: Add Classic (Bright) Stylesheet Jul 5, 2018
llvm @ 5c906fd Rebase LLVM fork Oct 1, 2018
llvm_build Update dependencies Aug 24, 2018
rpcs3 cellSaveData: fix truncation size (regression) Nov 17, 2018
.clang-format Update .clang-format May 8, 2018
.editorconfig Fix .editorconfig encoding Sep 17, 2018
.gitignore Gitignore: Support CLion IDE Oct 13, 2018
.gitmodules 3rdparty: remove optional submodule Aug 31, 2018
.mention-bot Added DHrpcs3 to mention-bot ignore list (#2026) Aug 4, 2016
.travis.yml Fix travis timing out while silently cloning git submodules Sep 20, 2018
CMakeLists.txt build/cmake: properly disable assert() globally for release builds Sep 22, 2018
LICENSE Few bugs fixed and license file added Feb 13, 2014
README.md README update Oct 10, 2018
appveyor.yml 3rdparty: remove optional submodule Aug 31, 2018
git-clang-format Add a git pre-commit hook running clang-format Aug 27, 2016
pre-commit.readme Add a git pre-commit hook running clang-format Aug 27, 2016
rpcs3.sln Update Project to Visual Studio 2017. Aug 24, 2018
rpcs3_debug.props Partial commit: Preview Apr 15, 2016
rpcs3_default.props Add _ENABLE_EXTENDED_ALIGNED_STORAGE Aug 25, 2018
rpcs3_llvm.props Use LLVM 6 May 8, 2018
rpcs3_memleak.props Property sheets, configuration simplified Dec 8, 2015
rpcs3_release.props Partial commit: Preview Apr 15, 2016
usertype.dat .clang-format added Aug 12, 2016

README.md

RPCS3

Build Status Build status

The world's first free and open-source PlayStation 3 emulator/debugger, written in C++ for Windows and Linux.

You can find some basic information on our website. Game info is being populated on the Wiki. For discussion about this emulator, PS3 emulation, and game compatibility reports, please visit our forums and our Discord server.

Support Lead Developers Nekotekina and kd-11 on Patreon

Development

If you want to contribute, please take a look at the Coding Style, Roadmap and Developer Information pages. You should also contact any of the developers in the forums or in the Discord server to learn more about the current state of the emulator.

Dependencies

Windows

Either add the QTDIR environment variable, e.g. <QtInstallFolder>\5.11.1\msvc2017_64\ , or use the Visual Studio Qt Plugin

Linux

  • Qt 5.10+
  • GCC 7.3+ or Clang 5.0+
  • CMake 3.8.2+
  • Debian & Ubuntu: sudo apt-get install cmake build-essential libasound2-dev libpulse-dev libopenal-dev libglew-dev zlib1g-dev libedit-dev libvulkan-dev libudev-dev git qt5-default
  • Arch: sudo pacman -S glew openal cmake vulkan-validation-layers qt5-base
  • Fedora: sudo dnf install alsa-lib-devel cmake glew glew-devel libatomic libevdev-devel libudev-devel openal-devel qt5-devel vulkan-devel
  • OpenSUSE: sudo zypper install git cmake libasound2 libpulse-devel openal-soft-devel glew-devel zlib-devel libedit-devel vulkan-devel libudev-devel libqt5-qtbase-devel libevdev-devel

If you have an NVIDIA GPU, you may need to install the libglvnd package.

MacOS

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

  • Xcode 10
  • Install with Homebrew: brew install glew llvm qt cmake

Building on Windows:

To initialize the repository, don't forget to execute git submodule update --init to pull the submodules.

Configuring the Qt plugin (if used)

  1. Go to the Qt5 menu and edit Qt5 options. Add the path to your Qt installation with compiler e.g. <QtInstallFolder>\5.11.1\msvc2017_64.
  2. While selecting the rpcs3qt project, go to Qt5->Project Setting and select the version you added.

Building the projects

Open rpcs3.sln. The recommended build configuration is Release - LLVM for all purposes.

You may want to download precompiled LLVM libs and extract to root rpcs3 folder (which contains rpcs3.sln), as well as download and extract additional libs to lib\%CONFIGURATION%-x64\ to speed up compilation time (unoptimised/debug libs are currently not available precompiled).

If you're not using precompiled libs, build the projects in __BUILD_BEFORE folder: right-click on every project > Build.

Build > Build Solution

Building on Windows (MinGW):

  1. Install packages
  • pacman -S base-devel mingw-w64-x86_64-toolchain mingw-w64-x86_64-cmake mingw-w64-x86_64-yasm mingw-w64-x86_64-python2 mingw-w64-x86_64-ntldd-git mingw-w64-x86_64-qt5 mingw-w64-x86_64-openal mingw-w64-x86_64-glew git
  1. Clone repository
  • git clone https://github.com/RPCS3/rpcs3.git
  1. Update submodules
  • cd rpcs3
  • git submodule update --init
  • cd ..
  1. Configure and compile RPCS3
  • mkdir rpcs3_build && cd rpcs3_build
  • cmake -G "MSYS Makefiles" -DCMAKE_MAKE_PROGRAM=mingw32-make ../rpcs3/
  • mingw32-make.exe GitVersion && mingw32-make.exe discord-rpc
  • If you use -DUSE_SYSTEM_FFMPEG=OFF, run mingw32-make ffmpeg-mingw
  1. Build RPCS3
  • Run mingw32-make or mingw32-make -jX where X is your CPU cores.
  1. Copy dependencies
  • cd ./bin
  • for l in $(ntldd.exe -R rpcs3.exe|grep mingw64|sed -e 's/^[ \t]*//'|cut -d' ' -f3);do cp $l .;done
  1. Copy qt plugins
  • mkdir -p ./qt/plugins/{bearer,imageformats,platforms,styles}
  • cp /mingw64/share/qt5/plugins/bearer/qgenericbearer.dll ./qt/plugins/bearer/
  • cp /mingw64/share/qt5/plugins/imageformats/{qgif.dll,qicns.dll,qico.dll,qjpeg.dll,qtga.dll,qtiff.dll,qwbmp.dll,qwebp.dll} ./qt/plugins/imageformats/
  • cp /mingw64/share/qt5/plugins/platforms/qwindows.dll ./qt/plugins/platforms/
  • cp /mingw64/share/qt5/plugins/styles/qwindowsvistastyle.dll ./qt/plugins/styles/
  1. Run RPCS3 with ./rpcs3

Building on Linux & Mac OS:

  1. git clone https://github.com/RPCS3/rpcs3.git
  2. cd rpcs3/
  3. git submodule update --init
  4. cd ../ && mkdir rpcs3_build && cd rpcs3_build
  5. cmake ../rpcs3/ && make GitVersion && make
  6. Run RPCS3 with ./bin/rpcs3

If you are on MacOS and want to build with brew llvm and qt, don't forget to add the following environment variables:

  • LLVM_DIR=/usr/local/opt/llvm/ (or wherever llvm was installed).
  • Qt5_DIR=/usr/local/opt/qt/lib/cmake/Qt5 (or wherever qt was installed).

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

CMake Build Options (Linux & Mac OS)

  • -DUSE_SYSTEM_LIBPNG=ON/OFF (default = OFF) Build against the shared libpng instead of using the built-in 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 built-in patched version. Try this if the built-in version breaks the OpenGL renderer for you.

  • -DWITHOUT_LLVM=ON/OFF (default = OFF) This forces RPCS3 to build without LLVM (not recommended).

  • -DWITH_GDB=ON/OFF (default = OFF) This builds RPCS3 with support for debugging PS3 games using gdb.

  • -DUSE_VULKAN=ON/OFF (default = ON) This builds RPCS3 with Vulkan support.

  • -DUSE_NATIVE_INSTRUCTIONS=ON/OFF (default = ON) This builds RPCS3 with -march=native, which is useful for local builds, but not good for packages.

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.