Editing XQEMU
Jump to navigation
Jump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
| Latest revision | Your text | ||
| Line 1: | Line 1: | ||
{{Infobox emulator | {{Infobox emulator | ||
| − | |active = | + | |active = Yes |
| − | |platform = | + | |platform = Windows<br/>macOS<br/>Linux |
| − | |target = [[Xbox emulators|Xbox]] | + | |target = [[Xbox emulators|Xbox]], Sega Chihiro <small>(Arcade. WIP)</small> |
|developer = espes, mborgerson, JayFoxRox and XQEMU Community | |developer = espes, mborgerson, JayFoxRox and XQEMU Community | ||
|website = [http://xqemu.com/ XQEMU.com] | |website = [http://xqemu.com/ XQEMU.com] | ||
|source = [https://github.com/xqemu/xqemu GitHub] | |source = [https://github.com/xqemu/xqemu GitHub] | ||
| − | |||
}} | }} | ||
| − | '''XQEMU''' is an open-source, [[High/Low level emulation|low-level]], multi-platform [[Xbox emulators|Xbox]] emulator based off of [[QEMU]], a general-purpose computer emulator and hypervisor. What makes this emulator different from other attempts at Xbox emulation is the use of low-level emulation, while previous attempts at Xbox emulation used high-level emulation. This comes with its own benefits and downsides in comparison, but has quickly | + | '''XQEMU''' is an open-source, [[High/Low level emulation|low-level]], multi-platform [[Xbox emulators|Xbox]] and Sega Chihiro <small>(WIP)</small> emulator based off of [[QEMU]], a general-purpose computer emulator and hypervisor. What makes this emulator different from other attempts at Xbox emulation is the use of low-level emulation, while previous attempts at Xbox emulation used high-level emulation. This comes with its own benefits and downsides in comparison, but it has quickly lead to higher [[Emulation Accuracy|accuracy]] and greater compatibility. |
| − | + | ==Downloads== | |
| + | *[https://ci.appveyor.com/project/mborgerson/xqemu-c5j6o '''Official development builds'''] (Windows) | ||
| + | <!-- *[https://travis-ci.org/xqemu/xqemu Official builds] (Linux and macOS) The maintainers have not set Travis to upload builds. --> | ||
| − | + | Unofficial builds are also available: | |
| − | + | * [http://www.emucr.com/search/label/XQEMU EmuCR] | |
| − | + | * [http://www.emu-france.com/emulateurs/6-arcades/61-multi-games/7071-xqemu/ Emu-France] (French language) | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
===Frontends=== | ===Frontends=== | ||
XQEMU does not come with an Xbox specific GUI and needs a separate frontend for GUI features. | XQEMU does not come with an Xbox specific GUI and needs a separate frontend for GUI features. | ||
| − | *[https://github.com/xqemu/xqemu-manager '''XQEMU-Manager'''] | + | *[https://github.com/xqemu/xqemu-manager '''Official frontend: XQEMU-Manager'''] by XQEMU developers (Python script; GUI only) |
Unofficial frontends are also available: | Unofficial frontends are also available: | ||
| Line 38: | Line 28: | ||
==Overview== | ==Overview== | ||
| + | XQEMU is under active development, and is accepting contributions by anyone. | ||
| − | + | ===Emulator=== | |
| − | XQEMU supports CPU virtualization to improve emulation performance, at a minor loss of compatibility | + | XQEMU is the most accurate and most compatible open-source Xbox emulator. |
| + | Many games work correctly in XQEMU, but there are performance issues in most some games. | ||
| + | Due to the small number of contributors, development focus has always been accuracy, but there's occasional performance improvements. | ||
| + | As more developers contribute to the project and emulation matures, focus will shift to performance. | ||
| + | |||
| + | mborgerson has, since March 24, 2018,<ref>mborgerson. [https://github.com/xqemu/xqemu/commit/49f1a7ccfaf105536cd30587254fb555e4ac1e3c Add hw/xbox from xqemu]. GitHub.</ref> begun work on rebasing XQEMU on the latest QEMU tag, "[bringing] many years of performance enhancements to xqemu including support for native virtualization APIs."<ref>[https://github.com/xqemu/xqemu/blob/xbox-2.x-rebase/README.md README.md]. GitHub.</ref> The rebase branch, which was merged into Master on June 2018, incorporated over 30,000 commits from QEMU that were never merged over the years. Work continues to reinstate 3D rendering. | ||
| + | Shortly after, the codebase was rebased to QEMU 3.0.0. | ||
| + | |||
| + | XQEMU supports CPU virtualization to improve emulation performance, at a minor loss of compatibility: | ||
* Windows: WHPX (broken, awaiting fixes by Microsoft), HAXM (broken, awaiting fixes by Intel) | * Windows: WHPX (broken, awaiting fixes by Microsoft), HAXM (broken, awaiting fixes by Intel) | ||
* macOS: HVF (broken, awaiting fixes by Apple), HAXM (broken, awaiting fixes by Intel) | * macOS: HVF (broken, awaiting fixes by Apple), HAXM (broken, awaiting fixes by Intel) | ||
* Linux: KVM (working) | * Linux: KVM (working) | ||
| − | KVM has been supported | + | KVM has been supported since 2013 and is the only stable CPU virtualization at the moment. With the rebase to QEMU 2.x and 3.x in 2018, support for other CPU virtualization became possible. HVF changes were contributed by espes. Additionally, active development of HAXM, WHPX and HVF made them more compatible with XQEMU, but problems remain. Problems were reported to the respective projects and testing continues. |
| + | Throughout September 2018 and later, mborgerson has been showcasing [https://www.youtube.com/watch?v=Si_RAtA7eAQ KVM] for Linux-based systems and [https://www.youtube.com/watch?v=y617eSRogdI HAXM] for Windows & macOS systems in XQEMU. They provide decent performance boosts to games such as Halo: Combat Evolved but still weren't enough to run at full frame rate speeds. | ||
| − | + | In June 2018, mborgerson created a new website for XQEMU at xqemu.com; xbox7887 contributed xqemu.org as alternative domain. | |
| − | |||
| − | + | In June 2018, JayFoxRox released nv2a-trace, to debug and compare Xbox GPU behaviour, to XQEMU graphics emulation. | |
| + | This has quickly lead to bug-fixes and allows other developers to gain a better understanding about the Xbox GPU. | ||
| − | + | In July 2018, JayFoxRox improved XQEMUs controller emulation. More than 20 games were affected by this change. The standard controllers are emulated with no known issues now. | |
| − | In | + | In 2018, a trivial bug in the network emulation was identified by JayFoxRox and mborgerson. Since this patched, System-Link is supported. |
| + | System-Link has been tested between different instances of XQEMU, and XQEMU and physical Xbox consoles. | ||
| − | In | + | In late 2018, mborgerson introduced a new texture cache, which improves the performance of XQEMU. |
| − | In 2018, | + | In December 2018, JayFoxRox has started integration of audio emulation for XQEMU. This work is based on his 2017 research and prototypes. Additionally, many DSP related tools to assist further development were created, to attract more developers. |
| − | In | + | In December 2018, mborgerson made a prototype for performance changes. This included a prototype for surface-caching, which greatly enhances visual quality and performance. That work has not been integrated into the official version yet. |
| − | |||
| − | = | + | *[https://docs.google.com/spreadsheets/d/1sVtQ9SNPathKAMCqfYtvJQP0bs0UeLzP9otPHvZDMwE/htmlview#gid=709879345 New compatibility chart] (1000+ games) |
| + | *[http://xboxdevwiki.net/XQEMU Old compatibility chart] (Taken from John GodGames' 2015 list) | ||
| − | + | ===Official Frontend=== | |
| − | In October 2018, Thrimbor added support for adding custom command | + | In May 2018, mborgerson created XQEMU-Manager, the official frontend for XQEMU. |
| + | This was done to make XQEMU easier to use, and to combat the rise of many competing unofficial user interfaces. | ||
| + | XQEMU-Manager is accepting contributions by anyone. | ||
| + | |||
| + | In October 2018, Thrimbor added support for adding custom command line options for running XQEMU. This was primarily done to work-around lack of input configuration options, it was based on earlier concepts by JayFoxRox and dracc. | ||
| + | |||
| + | In October 2018, Thrimbor added an option to enable CPU virtualization. It only allows HAXM on Windows / macOS, and KVM on Linux. HVF and WHPX are not supported, due to stability issues. | ||
In November 2018, Thrimbor added support for basic input configuration. | In November 2018, Thrimbor added support for basic input configuration. | ||
| Line 75: | Line 82: | ||
In December 2018, Thrimbor added support for configuring emulated memory units. | In December 2018, Thrimbor added support for configuring emulated memory units. | ||
| − | + | ===Related projects=== | |
| − | In June 2018, mborgerson created a [https://github.com/xqemu/xqemu-hdd-image copyright-free Xbox HDD | + | In June 2018, mborgerson created a [https://github.com/xqemu/xqemu-hdd-image copyright-free Xbox HDD Image]. It is fully functional for most use-cases and an alterantive to real Xbox HDD images. |
| − | In October 2018, mborgerson made xqemu-kernel, an attempt at an open-source Xbox kernel as HLE alternative. It | + | In October 2018, mborgerson made xqemu-kernel, an attempt at an open-source Xbox kernel as HLE alternative. It is currently considered a prototype and not functional. It is currently not hosted as part of the offical XQEMU ecosystem either. |
| − | espes and JayFoxRox | + | espes and JayFoxRox initiated XboxDev, an organization dedicated to researching and documenting original Xbox and Chihiro. |
| + | Many XQEMU developers are also active members and contributors to XboxDev projects. | ||
| + | As a result, most development tools developed for XQEMU, are hosted by XboxDev. | ||
==Running== | ==Running== | ||
| − | Follow the latest official instructions at [https://xqemu.com/getting-started/ xqemu.com | + | |
| + | Follow the latest official instructions at [https://xqemu.com/getting-started/ xqemu.com]. | ||
==References== | ==References== | ||
| Line 92: | Line 102: | ||
*[https://github.com/xqemu/xqemu/tree/xbox-2.x-rebase Upcoming official XQEMU branch re-based on latest QEMU tag] | *[https://github.com/xqemu/xqemu/tree/xbox-2.x-rebase Upcoming official XQEMU branch re-based on latest QEMU tag] | ||
*[https://github.com/JayFoxRox/xqemu-jfr/wiki Old Wiki for developers (JayFoxRox's branch)] | *[https://github.com/JayFoxRox/xqemu-jfr/wiki Old Wiki for developers (JayFoxRox's branch)] | ||
| − | *[https://github.com/XboxDev/ | + | *[https://github.com/XboxDev/XboxDev for Xbox documentation] (Contributors from many Xbox related projects including XQEMU and Cxbx-Reloaded) <!-- Why is this here? It's not emulation specific; it was merely initiated by JayFoxRox and espes. A) useful resource for new programmers keen to learn more about & improve Xbox emulation. Main Xbox page here has 2 links to games compat & emulators lists at this wiki.--> |
*[http://webchat.freenode.net/?channels=%23xqemu Official XQEMU IRC chat channel on freenode] | *[http://webchat.freenode.net/?channels=%23xqemu Official XQEMU IRC chat channel on freenode] | ||
*[https://discordapp.com/invite/WxJPPyz XboxDev Discord chat channel] (For discussions on Xbox emulation development) | *[https://discordapp.com/invite/WxJPPyz XboxDev Discord chat channel] (For discussions on Xbox emulation development) | ||
| + | *[https://www.youtube.com/watch?v=iM-9cel2iVI&t=0s&list=PLEtk6GvDeuAX5OR0zxz3TuQhqe8eSHp8P&index=2 XQEMU - Install Guide and (Gameplay) Multi Test #1] (Emulators for PC. Jul 17, 2018. 7 games.) | ||
*[https://www.youtube.com/playlist?list=PLBRxCmSa5Ob1m8XsJMkRQrAQu0RUxa4PF YT Playlist] (Technical progress videos from XQEMU maintainer mborgerson) | *[https://www.youtube.com/playlist?list=PLBRxCmSa5Ob1m8XsJMkRQrAQu0RUxa4PF YT Playlist] (Technical progress videos from XQEMU maintainer mborgerson) | ||
[[Category:Emulators]] | [[Category:Emulators]] | ||
| − | |||
| − | |||
| − | |||
[[Category:Windows emulation software]] | [[Category:Windows emulation software]] | ||
[[Category:Linux emulation software]] | [[Category:Linux emulation software]] | ||
[[Category:macOS emulation software]] | [[Category:macOS emulation software]] | ||
| − | [[Category: | + | [[Category:Xbox emulators]] |
