RPCS3/rpcs3
1
0
Fork 0
mirror of https://github.com/RPCS3/rpcs3.git synced 2024-11-22 18:53:28 +01:00
Code Issues Releases Wiki Activity
Mirror of https://github.com/RPCS3/rpcs3
6,686 Commits 6 Branches 38 Tags 208 MiB
C++ 91.7%
C 5.7%
Self 1.2%
GLSL 0.7%
CMake 0.3%
Other 0.3%
40ae5e605d
Go to file
kd-11 40ae5e605d vk: Fix border color selection
2018-04-25 19:14:36 +03:00
.github Move Contributing to .github 2018-02-12 01:58:14 +04:00
3rdparty Discord Rich Presence Integration (Thanks to @Megamouse for fixing the windows build) 2018-04-19 04:47:56 +04:00
asmjit@673dcefaa0 SPU: add some AVX-512 variants 2017-12-20 00:04:09 +03:00
asmjitsrc vs: drop user files from shipped vs files 2017-06-22 23:36:15 +03:00
bin gui/themes: YoRHa by Ani - Bugfixes 2018-03-05 19:20:57 +00:00
llvm@4423e35117 Use LLVM 4.0 2017-03-21 23:32:14 +03:00
llvm_build Multithreaded compile on Windows for llvm, glsl, vulkan 2017-03-23 20:50:22 +03:00
rpcs3 vk: Fix border color selection 2018-04-25 19:14:36 +03:00
rpcs3-tests vs: drop user files from shipped vs files 2017-06-22 23:36:15 +03:00
Utilities Fix warning (fmt_unveil) 2018-04-22 00:06:49 +03:00
Vulkan vulkan-build: use stub sha1 to bypass spirv_tools check when running setup scripts 2018-03-25 16:02:47 +03:00
.clang-format IdManager improved 2017-01-29 21:37:04 +03:00
.editorconfig .editorconfig added 2016-08-12 17:13:25 +03:00
.gitignore add enc_temp_folder to gitignore 2018-03-20 02:49:53 +04:00
.gitmodules Add ignore=dirty to hidapi submodule 2018-02-08 21:10:03 +03:00
.mention-bot Added DHrpcs3 to mention-bot ignore list (#2026) 2016-08-04 22:36:10 +03:00
.travis.yml remove glapi.so.0, and do some minor cleanup 2018-04-19 02:30:35 +04:00
appveyor.yml Use latest Qt patch level on appveyor. 2018-03-13 04:56:47 +04:00
CMakeLists.txt Re-arrange VULKAN_PREBUILT option 2018-02-19 17:30:24 +04:00
git-clang-format Add a git pre-commit hook running clang-format 2016-08-27 15:40:41 +02:00
LICENSE Few bugs fixed and license file added 2014-02-13 11:33:07 +01:00
pre-commit.readme Add a git pre-commit hook running clang-format 2016-08-27 15:40:41 +02:00
qt-installer-noninteractive.qs Refactor .travis.yml and qt installation 2018-02-28 00:21:54 +00:00
README.md Update for Qt 5.10 (#4202) 2018-02-23 02:08:14 +04:00
rpcs3_debug.props Partial commit: Preview 2016-04-15 19:22:15 +03:00
rpcs3_default.props Fix compile VS for Optional submodule 2017-10-13 05:14:12 +03:00
rpcs3_llvm.props Use LLVM 4.0 2017-03-21 23:32:14 +03:00
rpcs3_memleak.props Property sheets, configuration simplified 2015-12-08 20:02:30 +03:00
rpcs3_release.props Partial commit: Preview 2016-04-15 19:22:15 +03:00
rpcs3.sln Fix icon and exe name for VS. 2017-06-18 00:30:51 +03:00
usertype.dat .clang-format added 2016-08-12 14:32:57 +03:00
zlib.props RPCS3 QT (#2645) 2017-06-04 17:48:33 +03:00

README.md

RPCS3

Build Status Build status

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

You can find some basic information in our website. For discussion about this emulator and PS3 emulation 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 as well contact any of the developers in the forums or in Discord in order to know more about the current situation of the emulator.

Dependencies

Windows

Linux

  • Qt 5.10+
  • GCC 5.1+ or Clang 3.5.0+ (not GCC 6.1)
  • 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 llvm qt5-base
  • Fedora: sudo dnf install cmake glew glew-devel libatomic 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 a 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 6+ (tested with Xcode 6.4)
  • 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 Qt

If you're using Visual Studio 2017 without Qt plugin support (or simply dont want to use it):

  1. Add QTDIR environment variable and set it to e.g <QtInstallFolder>\5.10.1\msvc2015_64\

Open rpcs3.sln

If you wish to use the Visual Studio plugin for Qt:

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

Building the projects

You may want to download precompiled LLVM lib 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 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 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.

  • -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.