ShuriZma
/
xenia-canary
mirror of https://github.com/xenia-canary/xenia-canary.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Xbox 360 Emulator Research Project
3,297 Commits 20 Branches 905 Tags 75 MiB
C++ 95.2%
Assembly 2.8%
Python 0.9%
Lua 0.4%
HLSL 0.2%
Other 0.3%
Go to file
Dr. Chat 6a67632af1 Update RingBuffer - Add immediate read/write and some error checking asserts. 2016-01-24 22:39:05 -06:00
assets Fleshing out debugger types. 2015-05-25 00:51:23 -07:00
docs Move style_guide.md and building.md to docs/ 2016-01-18 02:36:37 -06:00
src/xenia Update RingBuffer - Add immediate read/write and some error checking asserts. 2016-01-24 22:39:05 -06:00
third_party Switching to mainline yaml-cpp. 2016-01-13 17:31:22 -08:00
tools Add 'posix' as a platform suffix 2016-01-20 11:09:45 -05:00
.appveyor.yml Ok, that's enough sysadmin for this year. 2015-12-31 20:45:10 -08:00
.clang-format Include order fixes. 2015-12-27 10:27:46 -08:00
.gitattributes gitattributes (maybe). 2015-05-24 01:16:34 -07:00
.gitignore Folding build_tools back into the main repo for simplicity. 2015-12-30 16:53:14 -08:00
.gitmodules Removing GPU traces because github is a bunch of jerks. 2016-01-13 22:39:31 -08:00
.travis.yml 1 linking and running tests for travis. 2016-01-01 20:55:32 +00:00
CONTRIBUTING.md Move style_guide.md and building.md to docs/ 2016-01-18 02:36:37 -06:00
LICENSE Adding CONTRIBUTING.md so that github shows it on issues. 2015-08-28 14:16:38 -07:00
README.md Move style_guide.md and building.md to docs/ 2016-01-18 02:36:37 -06:00
premake5.lua Reconcile debugger and save state stuff into a single implementation. 2016-01-18 11:48:21 -08:00
xb.bat Try python2 before python. 2015-11-25 15:22:53 -08:00
xenia-build xb tidy command. 2016-01-01 19:15:07 +00: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.

Come chat with us about emulator-related topics in #xenia @ irc.freenode.net. For developer chat join #xenia-dev but stay on topic. Lurking is fine. 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 Status
All Build status
Windows Build status
Linux Build status

Some real games run. Most don't. See the Game compatibility list for currently tracked games and feel free to contribute your own updates, screenshots, and information there following the existing conventions.

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

# Pull latest changes, rebase, and update submodules and premake:
> xb pull

# 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

# Format code to the style guide:
> xb format

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

Building

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

Contributors Wanted!

Before contributing code or issues be sure to read CONTRIBUTING.md.

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.

For general rules and guidelines please see CONTRIBUTING.md.

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)
  • Skilled with Linux? A strong contributor is needed to help with porting

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?

Check the Releases tab to see what's there. Updated irregularly.