RPCS3 ===== [![Build Status](https://travis-ci.org/RPCS3/rpcs3.svg?branch=master)](https://travis-ci.org/RPCS3/rpcs3) [![Build status](https://ci.appveyor.com/api/projects/status/411c4clmiohtx7eo/branch/master?svg=true)](https://ci.appveyor.com/project/rpcs3/rpcs3/branch/master) 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**](https://rpcs3.net/). For discussion about this emulator and PS3 emulation please visit our [**forums**](https://forums.rpcs3.net) and our [**Discord server**](https://discord.me/RPCS3). [**Support Lead Developers Nekotekina and kd-11 on Patreon**](https://www.patreon.com/Nekotekina) ## Development If you want to contribute please take a look at the [Coding Style](https://github.com/RPCS3/rpcs3/wiki/Coding-Style), [Roadmap](https://github.com/RPCS3/rpcs3/wiki/Roadmap) and [Developer Information](https://github.com/RPCS3/rpcs3/wiki/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 * [Visual Studio 2015](https://www.visualstudio.com/vs/older-downloads/) * [Visual C++ Redistributable Packages for Visual Studio 2015](http://www.microsoft.com/en-us/download/details.aspx?id=48145) * [Cmake 3.1.0+](https://www.cmake.org/download/) (required; add to PATH) * [Python 3.3+](https://www.python.org/downloads/) (required; add to PATH) * [Qt 5.8+](https://www.qt.io/download-open-source/) (required; add QTDIR `\5.8\msvc2015_64\` environment variable if you do not want to use the Visual Studio Qt Plugin) * [Visual Studio Qt Plugin](https://marketplace.visualstudio.com/items?itemName=TheQtCompany.QtVisualStudioTools2015) (optional; see above) ### Linux * [Qt 5.7+](https://www.qt.io/download-open-source/) * GCC 5.1+ or Clang 3.5.0+ ([not GCC 6.1](https://github.com/RPCS3/rpcs3/issues/1691)) * 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 `\5.8\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.8\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](https://drive.google.com/uc?export=download&id=0B8A6NaxhQAGRY2k3Q2Yya05lcm8) and extract to root rpcs3 folder (which contains `rpcs3.sln`), as well as download and extract [additional libs](https://drive.google.com/uc?export=download&id=0B8A6NaxhQAGRaHYxV3VOS2d0a0U) 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` 4) `cmake ../rpcs3/ && make GitVersion && make`
5) 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.