Skip to content
mborgerson edited this page Feb 21, 2020 · 13 revisions


Build Status Download Chat Badge

Welcome! xemu is an open-source, cross-platform application that emulates the hardware of the original Xbox game console, allowing users to play their Xbox games on Windows, macOS, and Linux systems. This project is focused on making significant forward progress in terms of features, performance, stability, and user experience in Xbox emulation.

This project is an active fork of the XQEMU project, which is based on the very popular and highly actively maintained QEMU full system emulator project.

- Disclaimer ------------------------------------------------------------------

This project is for educational purposes only, with the goal of researching and
understanding the inner-workings of the original Xbox and its games, and then
building a platform to play those legally purchased games.

This project does not exist to endorse or promote copyright infringement of any
kind. Developers work with legal backups of their own physical media and
encourage all users to do the same. Piracy is not tolerated on any communication
channel.

What's to come?

Lots of great things. If you've subscribed to my YouTube channel, you will have seen the experimental work I've done already in this area on the XQEMU project, much of which has not yet been released. That work and more is going to be made more stable in the coming months and will be integrated into this project.

Along the way, I plan to catalog and demonstrate reasonably often, which includes posting more demo videos on YouTube of stuff you can try for yourself. I also look forward to seeing your videos of testing things out so we can hunt bugs together.

Building and Testing

Users are encouraged to help regularly test for regressions. I plan to create a compatibility system soon where reports and videos can be shared documenting progress.

Windows

Windows users a recommended to use the pre-built release version. However, if you would like to build from source, you can do so by downloading the MSYS2 environment and building with:

pacman --needed --noconfirm -S git make \
        mingw-w64-x86_64-gcc \
        mingw-w64-x86_64-glib2 \
        mingw-w64-x86_64-libepoxy \
        mingw-w64-x86_64-libtool \
        mingw-w64-x86_64-pixman \
        mingw-w64-x86_64-pkg-config \
        mingw-w64-x86_64-SDL2 \
        python3
./build.sh

macOS

At the moment, macOS users will need to build from source. Binaries will be available soon.

With the Homebrew package manager installed:

brew update
brew install glib pixman sdl2 libepoxy coreutils pkg-config
./build.sh

Linux (Debian/Ubuntu)

At the moment, Linux users will need to build from source. Binaries will be available soon.

sudo apt-get update
sudo apt-get install -y libsdl2-dev libepoxy-dev libpixman-1-dev
./build.sh

Testing

For now (but not for long), xemu is compatible with the XQEMU getting started guide. Please read carefully and understand this guide. If you have questions, please consult the XQEMU FAQ. If you have further questions, or just want to chat, head over to the Discord server linked at the top.

I've found an issue, what do I do?

Great! Please do not file any GitHub issues at the moment, as I need to create the issue templates before hand. Instead, come chat on the Discord server linked at the top and we can do an early diagnosis of the issue. If necessary, we can catalog the issue for further exploration.

.

Clone this wiki locally
You can’t perform that action at this time.