1
0
mirror of https://github.com/RPCS3/rpcs3.git synced 2024-11-23 11:13:19 +01:00
Go to file
2018-12-23 04:13:27 +01:00
.github Move Contributing to .github 2018-02-12 01:58:14 +04:00
.travis Add CMake switch for disabling Discord Rich Presence and fix no llvm build 2018-12-20 11:29:35 +01:00
3rdparty Add CMake switch for disabling Discord Rich Presence and fix no llvm build 2018-12-20 11:29:35 +01:00
asmjit@673dcefaa0
asmjitsrc CMake: use CMAKE_SOURCE_DIR instead of .. in some places 2018-12-10 01:43:47 +03:00
bin Qt: Add Classic (Bright) Stylesheet 2018-07-05 23:22:33 +04:00
llvm@5c906fd169 Rebase LLVM fork 2018-10-01 21:10:10 +03:00
llvm_build Update dependencies 2018-08-25 01:47:13 +03:00
rpcs3 Qt/Input: disable mapping for unconnected pads 2018-12-23 04:13:27 +01:00
Utilities Support macOS bundling for binary distribution 2018-12-16 18:17:21 +03:00
Vulkan Update Project to Visual Studio 2017. 2018-08-25 01:15:47 +03:00
.clang-format Update .clang-format 2018-05-08 13:05:29 +03:00
.editorconfig Fix .editorconfig encoding 2018-09-17 12:18:40 +03:00
.gitignore Fix macOS compilation 2018-11-19 14:39:33 +03:00
.gitmodules Added ignore = dirty to all submodules to make git operations faster 2018-12-03 22:20:42 +03:00
.mention-bot
.travis.yml Fix macOS compilation 2018-11-19 14:39:33 +03:00
appveyor.yml 3rdparty: remove optional submodule 2018-08-31 20:13:54 +04:00
CMakeLists.txt Add CMake switch for disabling Discord Rich Presence and fix no llvm build 2018-12-20 11:29:35 +01:00
git-clang-format
LICENSE
pre-commit.readme
README.md Rewrite readme 2018-12-20 10:40:47 +01:00
rpcs3_debug.props
rpcs3_default.props Add _ENABLE_EXTENDED_ALIGNED_STORAGE 2018-08-25 21:06:24 +03:00
rpcs3_llvm.props Use LLVM 6 2018-05-08 13:05:29 +03:00
rpcs3_memleak.props
rpcs3_release.props
rpcs3.sln Update Project to Visual Studio 2017. 2018-08-25 01:15:47 +03:00
usertype.dat

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

Contributing

If you want to help the project but do not code, the best way to help out is to test games and make bug reports. See:

If you want to contribute as a developer, please take a look at the following 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.2\msvc2017_64\ , or use the Visual Studio Qt Plugin

Linux

  • Qt 5.10+ (Avoid 5.11.1, due to a bug)
  • 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 libevdev-dev
  • 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.

Building

Only Windows and Linux are officially supported for building. However, various other platforms are capable of building RPCS3. Other instructions may be found here.

Clone and initialize the repository:

  1. git clone https://github.com/RPCS3/rpcs3.git
  2. cd rpcs3/
  3. git submodule update --init

Windows

Configuring the Qt plugin (if used)

  1. Go to the Qt5 menu and edit Qt5 options.
  2. Add the path to your Qt installation with compiler e.g. <QtInstallFolder>\5.11.2\msvc2017_64.
  3. 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

Linux

While still in the project root:

  1. cd .. && mkdir rpcs3_build && cd rpcs3_build
  2. cmake ../rpcs3/ && make GitVersion && make
  3. Run RPCS3 with ./bin/rpcs3

When using GDB, configure it to ignore SIGSEGV signal (handle SIGSEGV nostop noprint). If desired, use the various build options in CMakeLists.

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.