Xbox 360 Emulator Research Project
Go to file
Ben Vanik eaa1a8ee3a Refactoring SymbolInfo/FunctionInfo/Function into Symbol/Function. 2015-08-05 21:50:02 -07:00
assets Fleshing out debugger types. 2015-05-25 00:51:23 -07:00
build_tools@c004e383e1 Moving style stuff to build_tools. 2015-08-01 11:11:59 -07:00
docs Adding some docs on CPU optimizations/potential work. 2015-07-13 18:20:38 -07:00
src/xenia Refactoring SymbolInfo/FunctionInfo/Function into Symbol/Function. 2015-08-05 21:50:02 -07:00
third_party Replacing beaengine in mmio handler with custom decoder. 2015-08-04 08:25:42 -07:00
tools xb lint, and --origin for lint/format to format all changes from origin. 2015-06-22 21:49:58 -07:00
.clang-format Formatting: force pointers to the left side. 2015-06-30 16:16:33 -07:00
.gitattributes gitattributes (maybe). 2015-05-24 01:16:34 -07:00
.gitignore Latest linter. 2015-08-01 04:08:59 -07:00
.gitmodules Replacing beaengine in mmio handler with custom decoder. 2015-08-04 08:25:42 -07:00
.travis.yml clang fixes. 2015-08-01 02:51:49 -07:00
CONTRIBUTORS.md Added API scanner tool 2015-02-21 17:33:56 +00:00
LICENSE Create LICENSE 2013-01-10 15:25:20 -08:00
README.md Switching to python build script. 2015-07-31 23:48:24 -07:00
premake5.lua Replacing beaengine in mmio handler with custom decoder. 2015-08-04 08:25:42 -07:00
xb.bat Switching to python build script. 2015-07-31 23:48:24 -07:00
xenia-build Moving source map to Function. 2015-08-01 14:07:13 -07:00
xeniarc clang-format detection cleanup. 2015-08-01 00:41:46 -07:00

README.md

Xenia - Xbox 360 Emulator Research Project

Xenia is an experimental emulator for the Xbox 360. For more information see the main xenia website.

Pull requests are welcome but the code is in a very high churn state and may not be accepted, so ask in IRC before taking on anything big. Contributions are awesome but the focus of the developers is on writing new code, not teaching programming or answering questions. If you'd like to casually help out it may be better to wait a bit until things calm down and more of the code is documented.

Come chat with us about development topics in #xenia @ irc.freenode.net. Please check the frequently asked questions page before asking questions. We've got jobs/lives/etc, so don't expect instant answers. Discussing illegal activities will get you banned. No warnings.

Status

Buildbot: Build status

Project tracker: Stories in Ready Stories in In Progress

Some real games run. Most don't. Don't ask if GTA or whatever runs. Game compatibility list.

Disclaimer

The goal of this project is to experiment, research, and educate on the topic of emulation of modern devices and operating systems. It is not for enabling illegal activity. All information is obtained via reverse engineering of legally purchased devices and games and information made public on the internet (you'd be surprised what's indexed on Google...).

Quickstart

Windows 8.1+ with Python 2.7 and Visual Studio 2015 and the Windows SDKs installed:

> git clone https://github.com/benvanik/xenia.git
> cd xenia
> xb setup
# Build on command line:
> xb build
# Run premake and open Visual Studio (run the 'xenia-app' project):
> xb devenv
# Run premake to update the sln/vcproj's:
> xb premake

When fetching updates use xb pull to automatically fetch everything and run premake for project files/etc.

Building

See building for setup and information about the xb script. When writing code, check the style guide and be sure to run clang-format!

Contributors Wanted!

Have some spare time, know advanced C++, and want to write an emulator? Contribute! There's a ton of work that needs to be done, a lot of which is wide open greenfield fun.

Fixes and optimizations are always welcome (please!), but in addition to that there are some major work areas still untouched:

  • Help work through missing functionality/bugs in game compat
  • Add input drivers for PS4 controllers (or anything else)

See more projects good for contributors. It's a good idea to ask on IRC/the bugs before beginning work on something.

FAQ

For more see the main frequently asked questions page.

Can I get an exe?

Not yet.