{"id":13418473,"url":"https://github.com/Cxbx-Reloaded/Cxbx-Reloaded","last_synced_at":"2025-03-15T03:31:13.569Z","repository":{"id":37251704,"uuid":"55772388","full_name":"Cxbx-Reloaded/Cxbx-Reloaded","owner":"Cxbx-Reloaded","description":"Xbox (Original) Emulator","archived":false,"fork":false,"pushed_at":"2024-09-03T22:52:31.000Z","size":75759,"stargazers_count":2186,"open_issues_count":220,"forks_count":257,"subscribers_count":170,"default_branch":"master","last_synced_at":"2024-10-29T15:39:20.073Z","etag":null,"topics":["cpp","cxbx","emulation","emulator","hacktoberfest","xbox"],"latest_commit_sha":null,"homepage":"https://cxbx-reloaded.co.uk","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cxbx-Reloaded.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-04-08T10:56:52.000Z","updated_at":"2024-10-29T12:28:49.000Z","dependencies_parsed_at":"2023-01-30T03:15:51.233Z","dependency_job_id":"b5006601-fd37-4fcd-8c4e-b89fde3d4ed9","html_url":"https://github.com/Cxbx-Reloaded/Cxbx-Reloaded","commit_stats":null,"previous_names":[],"tags_count":315,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cxbx-Reloaded%2FCxbx-Reloaded","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cxbx-Reloaded%2FCxbx-Reloaded/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cxbx-Reloaded%2FCxbx-Reloaded/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cxbx-Reloaded%2FCxbx-Reloaded/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cxbx-Reloaded","download_url":"https://codeload.github.com/Cxbx-Reloaded/Cxbx-Reloaded/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243447579,"owners_count":20292451,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpp","cxbx","emulation","emulator","hacktoberfest","xbox"],"created_at":"2024-07-30T22:01:02.696Z","updated_at":"2025-03-15T03:31:13.562Z","avatar_url":"https://github.com/Cxbx-Reloaded.png","language":"C++","funding_links":["https://www.patreon.com/LukeUsher"],"categories":["Microsoft","TODO scan for Android support in followings","Emulators"],"sub_categories":["Xbox"],"readme":"# Cxbx-Reloaded - Original Xbox Emulator\n[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/blob/master/COPYING)\n[![GitHub Actions](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/workflows/GitHub%20CI/badge.svg?event=push)](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/actions?query=event%3Apush+workflow%3A%22GitHub+CI%22)\n[![Discord](https://img.shields.io/badge/chat-on%20discord-7289da.svg?logo=discord)](https://discord.gg/26Xjx23)\n\nCxbx-Reloaded is an emulator for running Microsoft Xbox (and eventually, Chihiro) games on Microsoft Windows and Wine.\n\n## System Requirements\n### Minimum\n  * OS: Windows 7+ x64, or x86-64 Linux with Wine. 32-bit is not supported.\n    * MacOS with Wine is known not to work, and BSD-based systems are untested.\n    * Also note that Wine is relatively unstable, and it might break compatibility with Cxbx-Reloaded at any time without warning.\n  * GPU: Direct3D 9.0c with Pixel Shader Model 2.x, and Vertex Shader Model 3.0.\n\n## Prerequisites\n### Windows\n  * [32-bit (x86) Visual C++ 2022 Redistributable](https://aka.ms/vs/17/release/vc_redist.x86.exe)\n  * [Npcap *(used for network emulation)*](https://nmap.org/npcap/#download)\n    * Make sure to enable winpcap compatibility mode.\n  * [WinUSB compliant driver](https://github.com/libusb/libusb/wiki/Windows#Driver_Installation)\n    * *Optional, only needed for USB pass-through of original Xbox and Steel Battalion controllers.*\n\n### Wine\n**Please use the latest stable release version of Wine. If it does not work for you, then roll back to Wine 7.0 which is the last known working version.**\u003cbr/\u003e\n**There also exists this known [issue](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/issues/2314) which currently prevents savings in some games with the most recent Wine 6.8 and later versions.**\n  * Winetricks\n    * `vcrun2019`\n      * Requires the latest winetricks script.\n    * `d3dcompiler_47`\n      * This may be subject to change.\n  * Winpcap is built-in, no installation is required.\n\n## Automated Builds\nCxbx-Reloaded doesn't currently have stable builds, but you can obtain pre-release builds from our official website's download page, or the links below:\n\n  * **[Release Builds](https://cxbx-reloaded.co.uk/download)**\n  * *[Full build history](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/actions?query=workflow%3A%22GitHub+CI%22)*\n\n## Compatibility\nCxbx-Reloaded has a [compatibility list](https://cxbx-reloaded.co.uk/compatibility).\n\nIf you would like to submit compatibility reports, please request permission in our Discord server.\n\n## Bug Reports\nGame or software specific issues can be reported in the [compatibility website](https://cxbx-reloaded.co.uk/compatibility).\n\nFor emulation issues that are not specific to any single piece of software, a bug report can be submitted at [the Cxbx-Reloaded issue tracker](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/issues).\n\u003c!--Make sure to follow the issue template and that it contains:\n  * The build tested with, error message displayed (if any)\n    * **You can copy and paste any popup messages. However, please keep it clean by pasting and trimming down to only the message itself.**\n  * Screenshots\n    * Optional unless there are graphic bugs for reference.\n\n**Failure to follow the template will auto close your ticket.**--\u003e\n\n## Additional information\nCxbx-Reloaded has a [wiki](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/wiki) containing various subjects and background information.\n\nChat on [Discord](https://discord.gg/26Xjx23).\n\n## Contributing\nWe welcome contributions, large and small.\n\nIf you want to do some coding, be sure to read the [Developer notes](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/wiki/Developer-notes).\n\n**IMPORTANT: Pull-Requests containing code derived from XQEMU will _not_ be approved until an agreement is reached to make work mutually beneficial. This includes updates to existing XQEMU derived code. We should not/will not become a hostile fork.**\n\nPlease contact us before you start working on something, so we can make sure your work is going to be accepted once finished.\n\n### Main Prerequisites\n1. [Git for Windows](https://git-scm.com)\n2. [CMake](https://cmake.org)\n    * Some IDEs already have CMake support, this is optional.\n\n### Fetching the code\n1. Run the following command in the command line:\n\u003cbr\u003e`git clone --recurse-submodules https://github.com/Cxbx-Reloaded/Cxbx-Reloaded.git`\n    * Please note the `--recurse-submodules` parameter. This is required to fetch submodules.\n      * If Cxbx-Reloaded was checked out without submodules, they can be updated/fetched with the following command:\n\n        `git submodule update --init --recursive`\n\n### Compiling\n\n#### Windows\nDon't open `CMakeLists.txt` from Visual Studio, as it won't generate files in the `build` directory.\n\n##### Prerequisites\n1. [Visual Studio](https://visualstudio.microsoft.com/downloads/) 2022\n    * C++ and C# desktop development\n    * Windows Universal CRT SDK\n    * C++ CMake tools for Windows\n      * *Optional if CMake is installed*\n    * [Microsoft Child Process Debugging Power Tool](https://marketplace.visualstudio.com/items?itemName=vsdbgplat.MicrosoftChildProcessDebuggingPowerTool)\n\n##### Generate Visual Studio files\n1. If you don't have CMake installed, open `___ Native Tools Command Prompt for VS 20##`.\n2. `cd` to the Cxbx-Reloaded directory.\n3. Run these commands.\n    1. `mkdir build \u0026 cd build`\n    2. `cmake .. -G \"Visual Studio 17 2022\" -A Win32`\n        * VS2022 17.0 or later is required.\n4. Open `Cxbx-Reloaded.sln` from the `build` directory.\n5. Select the Release configuration, then click Build.\n    * Debug builds are **significantly slower, and only for developers**.\n\n#### Linux / macOS\nCurrently not supported.\n\n## Support\nYou can support [Luke Usher](https://github.com/LukeUsher), initiator of Cxbx-Reloaded, on [Patreon](https://www.patreon.com/LukeUsher).\n\n## Special Thanks\n* All contributors to the original Cxbx and [Dxbx](https://github.com/PatrickvL/Dxbx) projects. Without them Cxbx-Reloaded would not exist at all.\n* [XQEMU](https://github.com/xqemu/xqemu) - While the majority of Cxbx-R is our own work (Kernel, HLE, etc), the NV2A LLE and NVNet implementation are primarily the work of the XQEMU developers.\n* [XboxDev](https://github.com/xboxdev) - Providing Xbox hardware research \u0026 useful tooling.\n* [XbSymbolDatabase](https://github.com/Cxbx-Reloaded/XbSymbolDatabase) - Providing support to detect symbols across XDK builds from reverse engineered retail titles.\n* [Xbox Kernel Test Suite](https://github.com/Cxbx-Reloaded/xbox_kernel_test_suite) - Making accurate tests on hardware to compare against cxbxr's kernel implementation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCxbx-Reloaded%2FCxbx-Reloaded","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCxbx-Reloaded%2FCxbx-Reloaded","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCxbx-Reloaded%2FCxbx-Reloaded/lists"}