2014-04-07 12:40:50 +00:00
RPCS3
2012-11-03 15:16:18 +00:00
=====
2015-04-08 18:02:54 +00:00
[![Build Status ](https://travis-ci.org/RPCS3/rpcs3.svg?branch=master )](https://travis-ci.org/RPCS3/rpcs3)
2015-08-04 15:52:16 +00:00
[![Build status ](https://ci.appveyor.com/api/projects/status/411c4clmiohtx7eo/branch/master?svg=true )](https://ci.appveyor.com/project/rpcs3/rpcs3/branch/master)
2015-11-22 15:30:34 +00:00
[![Coverity Status ](https://img.shields.io/coverity/scan/3960.svg )](https://scan.coverity.com/projects/3960)
2015-10-22 16:30:39 +00:00
[![Coverage Status ](https://coveralls.io/repos/RPCS3/rpcs3/badge.svg )](https://coveralls.io/r/RPCS3/rpcs3)
2015-01-26 18:53:00 +00:00
2014-04-07 12:40:50 +00:00
An open-source PlayStation 3 emulator/debugger written in C++.
2014-02-09 17:41:20 +00:00
2015-10-22 16:30:39 +00:00
You can find some basic information in the [FAQ ](https://github.com/RPCS3/rpcs3/wiki/FAQ ). For discussion about this emulator and PS3 emulation please visit the [official forums ](http://www.emunewz.net/forum/forumdisplay.php?fid=162 ).
2014-02-09 17:41:20 +00:00
2014-04-13 01:19:48 +00:00
### Development
2015-10-22 16:30:39 +00:00
If you want to contribute please take a took 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 forum in order to know about the current situation of the emulator.
2014-04-13 01:19:48 +00:00
2014-04-07 12:40:50 +00:00
### Dependencies
2014-02-09 17:41:20 +00:00
2014-04-13 01:19:48 +00:00
__Windows__
2015-09-12 23:35:10 +00:00
* [Visual Studio 2015 ](https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx )
2015-07-23 11:53:10 +00:00
* [Visual C++ Redistributable Packages for Visual Studio 2015 ](http://www.microsoft.com/en-us/download/details.aspx?id=48145 )
2015-11-22 15:30:34 +00:00
* [Cmake 3.1.0+ ](http://www.cmake.org/download/ ) (optional, required only for LLVM build; add to PATH)
2015-10-22 16:30:39 +00:00
* [Python ](https://www.python.org/downloads/ ) (optional, required only for LLVM build; add to PATH)
2014-04-07 12:40:50 +00:00
2014-04-13 01:19:48 +00:00
__Linux__
2016-01-03 18:31:00 +00:00
* GCC 5.1+ or Clang 3.5.0+
2014-12-07 07:30:15 +00:00
* Debian & Ubuntu: `sudo apt-get install libopenal-dev libwxgtk3.0-dev build-essential libglew-dev`
2015-03-27 07:56:13 +00:00
* Arch: `sudo pacman -S glew openal wxgtk cmake llvm`
2014-04-07 12:40:50 +00:00
2014-04-29 17:55:03 +00:00
__Mac OSX__
2015-11-22 15:30:34 +00:00
* Xcode 6+ (tested with Xcode 6.4)
2015-08-19 14:24:57 +00:00
* Install with Homebrew: `brew install glew wxwidgets` (add `llvm36` to that list if you want to build with ppu jit)
2014-04-29 17:55:03 +00:00
* Remove '-framework QuickTime' from '_ldflags' in /usr/local/bin/wx-config
2014-04-07 12:40:50 +00:00
### Building
2014-02-09 17:41:20 +00:00
2014-02-12 18:23:33 +00:00
To initialize the repository don't forget to execute `git submodule update --init` to pull the wxWidgets source.
2015-09-12 23:35:10 +00:00
* __Windows__:
2015-12-02 16:12:48 +00:00
Open the *.SLN* file, and press *Build* > *Clean Solution* , then *Build Solution* . *Rebuild* may not work correctly.
2014-04-29 17:55:03 +00:00
* __Linux & Mac OSX__:
2015-09-12 23:35:10 +00:00
If you want to build with LLVM, then LLVM 3.6.2 is required.
2015-11-22 15:30:34 +00:00
`cd rpcs3 && cmake CMakeLists.txt && make && cd ../` then run with `cd bin && ./rpcs3` .
2015-08-19 14:24:57 +00:00
If you are on OSX and want to build with llvm don't forget to add `-DLLVM_DIR=/usr/local/opt/llvm36/lib/llvm-3.6/share/llvm/cmake` (or wherever llvm brew was installed) to cmake invocation.
2015-12-16 14:20:46 +00:00
When using GDB, configure it to ignore SIGSEGV signal (`handle SIGSEGV nostop noprint`).
2014-04-29 17:55:03 +00:00
2014-12-05 14:32:55 +00:00
### Support
* [Donate by PayPal ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=MPJ3S9XQXCE3G )