yuzu/README.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

91 lines
4.2 KiB
Markdown
Raw Permalink Normal View History

chore: make yuzu REUSE compliant [REUSE] is a specification that aims at making file copyright information consistent, so that it can be both human and machine readable. It basically requires that all files have a header containing copyright and licensing information. When this isn't possible, like when dealing with binary assets, generated files or embedded third-party dependencies, it is permitted to insert copyright information in the `.reuse/dep5` file. Oh, and it also requires that all the licenses used in the project are present in the `LICENSES` folder, that's why the diff is so huge. This can be done automatically with `reuse download --all`. The `reuse` tool also contains a handy subcommand that analyzes the project and tells whether or not the project is (still) compliant, `reuse lint`. Following REUSE has a few advantages over the current approach: - Copyright information is easy to access for users / downstream - Files like `dist/license.md` do not need to exist anymore, as `.reuse/dep5` is used instead - `reuse lint` makes it easy to ensure that copyright information of files like binary assets / images is always accurate and up to date To add copyright information of files that didn't have it I looked up who committed what and when, for each file. As yuzu contributors do not have to sign a CLA or similar I couldn't assume that copyright ownership was of the "yuzu Emulator Project", so I used the name and/or email of the commit author instead. [REUSE]: https://reuse.software Follow-up to 01cf05bc75b1e47beb08937439f3ed9339e7b254
2022-05-15 02:06:02 +02:00
<!--
SPDX-FileCopyrightText: 2018 yuzu Emulator Project
SPDX-License-Identifier: GPL-2.0-or-later
-->
2021-06-24 08:32:41 +02:00
<h1 align="center">
<br>
2024-03-05 00:00:09 +01:00
<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>
2021-06-24 08:32:41 +02:00
<br>
2021-06-24 08:37:03 +02:00
<b>yuzu</b>
2021-06-24 08:32:41 +02:00
<br>
</h1>
2018-01-15 03:53:58 +01:00
2021-06-24 08:32:41 +02:00
<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.
2021-06-24 08:32:41 +02:00
</h4>
2016-01-16 08:30:22 +01:00
2024-03-05 00:00:09 +01:00
> [!NOTE]
> This is an unofficial mirror fork of the original repository.
2021-06-24 08:32:41 +02:00
<p align="center">
2024-03-05 17:03:19 +01:00
<!-- <a href="https://dev.azure.com/yuzu-emu/yuzu/">
2021-06-24 08:32:41 +02:00
<img src="https://dev.azure.com/yuzu-emu/yuzu/_apis/build/status/yuzu%20mainline?branchName=master"
alt="Azure Mainline CI Build Status">
2024-03-05 17:03:19 +01:00
</a> -->
2021-06-24 08:32:41 +02:00
<a href="https://discord.com/invite/u77vRWY">
2021-12-06 11:39:55 +01:00
<img src="https://img.shields.io/discord/398318088170242053?color=5865F2&label=yuzu&logo=discord&logoColor=white"
2021-06-24 08:32:41 +02:00
alt="Discord">
</a>
</p>
2021-06-24 08:32:41 +02:00
<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>
2021-06-24 08:32:41 +02:00
## Compatibility
2014-12-16 02:34:44 +01:00
2021-06-24 08:32:41 +02:00
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).
2014-04-08 21:05:45 +02:00
2024-03-05 04:16:45 +01:00
For a full list of games yuzu supports, please visit our [Compatibility page](https://web.archive.org/web/20240303155638/https://yuzu-emu.org/game/).
2016-02-25 08:42:34 +01:00
2021-06-24 08:32:41 +02:00
Check out our [website](https://yuzu-emu.org/) for the latest news on exciting features, monthly progress reports, and more!
2014-04-08 21:05:45 +02:00
2021-06-24 08:32:41 +02:00
## Development
2014-04-08 21:05:45 +02:00
2021-06-24 08:32:41 +02:00
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).
2024-03-05 01:02:55 +01:00
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).
2021-06-24 08:32:41 +02:00
You can also contact any of the developers on Discord in order to know about the current state of the emulator.
2014-04-08 21:05:45 +02:00
2021-06-24 08:32:41 +02:00
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.
2021-06-24 08:32:41 +02:00
## Building
2014-04-08 21:05:45 +02:00
2024-03-05 01:02:55 +01:00
* __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)
2024-03-05 23:19:46 +01:00
* __Android__: [Android Build](https://github.com/yuzu-mirror/yuzu/wiki/Building-For-Android)
2014-12-16 02:01:56 +01:00
2024-03-06 03:07:47 +01:00
## Download
2014-12-16 02:01:56 +01:00
2024-03-05 04:16:45 +01:00
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.
2021-06-24 08:32:41 +02:00
## Support
2021-06-24 08:35:46 +02:00
If you enjoy the project and want to support us financially, check out our Patreon!
2021-06-24 08:32:41 +02:00
<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:
2018-01-13 23:28:52 +01:00
* 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.)
2021-06-24 08:32:41 +02:00
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
2024-03-05 00:00:09 +01:00
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.