| <!-- | |
| SPDX-FileCopyrightText: 2018 yuzu Emulator Project | |
| SPDX-License-Identifier: GPL-2.0-or-later | |
| --> | |
| <h1 align="center"> | |
| <br> | |
| <a href="https://yuzu-emu.org/"><img src="https://raw.githubusercontent.com/yuzu-mirror/yuzu-assets/master/icons/icon.png" alt="yuzu" width="200"></a> | |
| <br> | |
| <b>yuzu</b> | |
| <br> | |
| </h1> | |
| <h4 align="center"><b>yuzu</b> is the world's most popular, open-source, Nintendo Switch emulator — started by the creators of <a href="https://citra-emu.org" target="_blank">Citra</a>. | |
| <br> | |
| It is written in C++ with portability in mind, and we actively maintain builds for Windows, Linux and Android. | |
| </h4> | |
| > [!NOTE] | |
| > This is an unofficial mirror fork of the original repository. | |
| <p align="center"> | |
| <!-- <a href="https://dev.azure.com/yuzu-emu/yuzu/"> | |
| <img src="https://dev.azure.com/yuzu-emu/yuzu/_apis/build/status/yuzu%20mainline?branchName=master" | |
| alt="Azure Mainline CI Build Status"> | |
| </a> --> | |
| <a href="https://discord.com/invite/u77vRWY"> | |
| <img src="https://img.shields.io/discord/398318088170242053?color=5865F2&label=yuzu&logo=discord&logoColor=white" | |
| alt="Discord"> | |
| </a> | |
| </p> | |
| <p align="center"> | |
| <a href="#compatibility">Compatibility</a> | | |
| <a href="#development">Development</a> | | |
| <a href="#building">Building</a> | | |
| <a href="#download">Download</a> | | |
| <a href="#support">Support</a> | | |
| <a href="#license">License</a> | |
| </p> | |
| ## Compatibility | |
| The emulator is capable of running most commercial games at full speed, provided you meet the [necessary hardware requirements](https://yuzu-emu.org/help/quickstart/#hardware-requirements). | |
| For a full list of games yuzu supports, please visit our [Compatibility page](https://web.archive.org/web/20240303155638/https://yuzu-emu.org/game/). | |
| Check out our [website](https://yuzu-emu.org/) for the latest news on exciting features, monthly progress reports, and more! | |
| ## Development | |
| Most of the development happens on GitHub. It's also where [our central repository](https://github.com/yuzu-emu/yuzu) is hosted. For development discussion, please join us on [Discord](https://discord.com/invite/u77vRWY). | |
| If you want to contribute, please take a look at the [Contributor's Guide](https://github.com/yuzu-mirror/yuzu/wiki/Contributing) and [Developer Information](https://github.com/yuzu-mirror/yuzu/wiki/Developer-Information). | |
| You can also contact any of the developers on Discord in order to know about the current state of the emulator. | |
| If you want to contribute to the user interface translation project, please check out the [yuzu project on transifex](https://www.transifex.com/yuzu-emulator/yuzu). We centralize translation work there, and periodically upstream translations. | |
| ## Building | |
| * __Windows__: [Windows Build](https://github.com/yuzu-mirror/yuzu/wiki/Building-For-Windows) | |
| * __Linux__: [Linux Build](https://github.com/yuzu-mirror/yuzu/wiki/Building-For-Linux) | |
| * __MacOS__: [MacOS Build](https://github.com/yuzu-mirror/yuzu/wiki/Building-For-MacOS) | |
| * __Android__: [Android Build](https://github.com/yuzu-mirror/yuzu/wiki/Building-For-Android) | |
| ## Download | |
| You can download the latest releases automatically via the installer on our [downloads](https://web.archive.org/web/20240304063132/https://yuzu-emu.org/downloads/) page. | |
| ## Support | |
| If you enjoy the project and want to support us financially, check out our Patreon! | |
| <a href="https://www.patreon.com/yuzuteam"> | |
| <img src="https://c5.patreon.com/external/logo/become_a_patron_button@2x.png" width="160"> | |
| </a> | |
| Any donations received will go towards things like: | |
| * Switch consoles to explore and reverse-engineer the hardware | |
| * Switch games for testing, reverse-engineering, and implementing new features | |
| * Web hosting and infrastructure setup | |
| * Software licenses (e.g. Visual Studio, IDA Pro, etc.) | |
| * Additional hardware (e.g. GPUs as-needed to improve rendering support, other peripherals to add support for, etc.) | |
| If you wish to support us a different way, please join our [Discord](https://discord.gg/u77vRWY) and talk to bunnei. You may also contact: donations@yuzu-emu.org. | |
| ## License | |
| yuzu is licensed under the GPLv3 (or any later version). Refer to the [LICENSE.txt](https://github.com/yuzu-mirror/yuzu/blob/master/LICENSE.txt) file. | |