<!--
SPDX-FileCopyrightText: 2024 suyu emulator project
SPDX-License-Identifier: GPL v3
-->

**Note**: We do not support or condone piracy in any form. In order to use Suyu, you'll need keys from your real Switch system, and games which you have legally obtained and paid for. We do not intend to make money or profit from this project.

We are in great need of developers, join our Discord server [here](https://discord.gg/2gQRBp44KT)
This repo is based on Yuzu EA 4176. Please contribute if you can!

<hr />

<h1 align="center">
  <br>
  <a href="https://gitlab.com/suyu-emu/suyu"><img src="dist/readme/suyu__Logo-Pill.svg" alt="suyu" height="128"></a>
  <br>
  <b>suyu</b>
  <br>
</h1>

<h4 align="center"><b>suyu</b>, pronounced "sue-you" (wink wink) is the continuation of the world's most popular, open-source, Nintendo Switch emulator, yuzu.
<br>
It is written in C++ with portability in mind, and we actively maintain builds for Windows, Linux and Android.
</h4>

<p align="center">
<div style="width:5%; margin: 5%;">

[<img src="https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/GitLab-Dark.svg">](https://gitlab.com/suyu-emu/suyu/-/pipelines)
</div>
    </a>
</p>

<p align="center">
  <a href="#compatibility">Compatibility</a> |
  <a href="#development">Development</a> |
  <a href="#building">Building</a> |
  <a href="#downloads">Downloads</a> |
  <a href="#support">Support</a> |
  <a href="#license">License</a>
</p>

## Status

We are trying to get the builds working. We are in need of developers. Join our Discord to contribute.

**Note**: This README is a fork of the original project's README, most links are broken!

## Compatibility

The emulator is capable of running most commercial games at full speed, provided you meet the [necessary hardware requirements](https://suyu-emu.org/help/quickstart/#hardware-requirements).

For a full list of games suyu supports, please visit our [Compatibility page](https://gitlab.com/suyu-emu/suyu/-/wikis/Compatibility).

Check out our [website](https://suyu.dev) for the latest news on exciting features, monthly progress reports, and more!

## Development

This project is completely free and open source, this project is made possible by many people who share the same interest.

Most of the development happens on GitHub. For development discussion, please join us on [Discord](https://discord.gg/2gQRBp44KT).

If you want to contribute, please take a look at the [Contributor's Guide](https://gitlab.com/suyu-emu/suyu/-/wikis/Contributing) and [Developer Information](https://gitlab.com/suyu-emu/suyu/-/wikis/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 [suyu project on transifex](https://www.transifex.com/suyu-emulator/suyu). We centralize translation work there, and periodically upstream translations.

## Downloads

* __Windows__: [Legacy Artifacts](https://github.com/pineappleea/pineapple-src/releases)
* __Linux__: [Legacy Artifacts](https://github.com/pineappleea/pineapple-src/releases)

## Building

* __Windows__: [Currently in alpha development]
* __Linux__: [Currently in alpha development]



## Support

This project is completely free and open source, this project is made possible by many people who share the same interest. Please join the Discord server to contribute.


## License

suyu is licensed under the free and open-source GPL v3 license.
