ryujinx/README.md

169 lines
9.0 KiB
Markdown
Raw Permalink Normal View History

[links/discord]: https://discord.gg/xmHPGDfVCa
[badges/discord]: https://img.shields.io/discord/1291765437100720243?label=ryujinx-mirror&logo=discord&logoColor=FFFFFF&color=5865F3
2024-10-24 16:16:46 +00:00
As of now, the [ryujinx-mirror/ryujinx](https://github.com/ryujinx-mirror/ryujinx) repository serves as a downstream hard fork of the original Ryujinx project. You can download nightly binaries for Windows, macOS, and Linux (including `AppImage`s) from the [latest release](https://github.com/ryujinx-mirror/ryujinx/releases/latest).
2024-10-01 21:57:04 +00:00
> [!NOTE]
2024-10-03 08:51:36 +00:00
> This fork is not affiliated with the **original** Ryujinx project, or Nintendo whatsoever.
2024-10-03 00:07:42 +00:00
### Current Goals
2024-10-24 16:16:46 +00:00
If you would like a version with more new features & improvements, feel free to check out [GreemDev's fork](https://github.com/GreemDev/Ryujinx). We aim to keep this repository more focused on small fixes and infrastructure reconstruction, staying more true to the original Ryujinx project.
2024-10-03 08:51:36 +00:00
* ☑️ Reconstruct basic build infrastructure & workflows for this repository, based on revision hashes as opposed to semver releases (for now)
* ☑️ To be as safe as possible, remove all previous in-app and meta references to Patreon, `ryujinx.org` etc while keeping full attribution of original authors and contributors in-tact.
2024-10-03 00:07:42 +00:00
* Keep 'branding' as pure and faithful to the original project as possible.
2024-10-03 08:51:36 +00:00
### Join Discussion
Feel free to join the [ryujinx-mirror Discord community][links/discord] to join in on the development of this fork going forward.<br>
2024-10-03 08:51:36 +00:00
See `#ryujinx-info` for more information.
[![ryujinx-mirror Discord][badges/discord]][links/discord]
2024-10-03 00:07:42 +00:00
2024-10-01 21:57:04 +00:00
___
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
<h1 align="center">
<br>
<a href="https://github.com/ryujinx-mirror/ryujinx"><img src="distribution/misc/Logo.svg" alt="Ryujinx" width="150"></a>
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
<br>
<b>Ryujinx</b>
<br>
<sub><sup><b>(REE-YOU-JINX)</b></sup></sub>
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
<br>
</h1>
2018-02-04 23:11:01 +00:00
<p align="center">
Ryujinx is an open-source Nintendo Switch emulator, created by gdkchan, written in C#.
This emulator aims at providing excellent accuracy and performance, a user-friendly interface and consistent builds.
It was written from scratch and development on the project began in September 2017.
2024-10-01 21:44:33 +00:00
Ryujinx is available on Github under the <a href="LICENSE.txt" target="_blank">MIT license</a>.
<br />
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
</p>
## Compatibility
As of May 2024, Ryujinx has been tested on approximately 4,300 titles;
over 4,100 boot past menus and into gameplay, with roughly 3,550 of those being considered playable.
2018-02-10 19:51:07 +00:00
You can check out the compatibility list [here](https://github.com/ryujinx-mirror/Ryujinx-Games-List/issues).
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
Anyone is free to submit a new game test or update an existing game test entry;
simply follow the new issue template and testing guidelines, or post as a reply to the applicable game issue.
Use the search function to see if a game has been tested already!
## Usage
2018-02-10 19:51:07 +00:00
To run this emulator, your PC must be equipped with at least 8GiB of RAM;
failing to meet this requirement may result in a poor gameplay experience or unexpected crashes.
2024-10-02 08:33:04 +00:00
<!--
See our [Setup & Configuration Guide](https://github.com/ryujinx-mirror/Ryujinx/wiki/Ryujinx-Setup-&-Configuration-Guide) on how to set up the emulator.
For our Local Wireless (LDN) builds, see our [Multiplayer: Local Play/Local Wireless Guide](https://github.com/ryujinx-mirror/Ryujinx/wiki/Multiplayer-(LDN-Local-Wireless)-Guide).
2024-10-02 08:33:04 +00:00
-->
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
<!--Avalonia UI comes with translations for various languages. See [Crowdin](https://crwd.in/ryujinx) for more information.-->
## Latest build
These builds are compiled automatically for each commit on the master branch.
While we strive to ensure optimal stability and performance prior to pushing an update, our automated builds **may be unstable or completely broken**.
2024-10-02 08:29:21 +00:00
See [the releases page](https://github.com/ryujinx-mirror/ryujinx/releases) for automatic builds for Windows, macOS, and Linux.
<!--
If you want to see details on updates to the emulator, you can visit our [Changelog](https://github.com/ryujinx-mirror/Ryujinx/wiki/Changelog).
The latest automatic build for Windows, macOS, and Linux can be found on the [Official Website](https://ryujinx.org/download).
-->
## Documentation
If you are planning to contribute or just want to learn more about this project please read through our [documentation](docs/README.md).
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
## Building
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
If you wish to build the emulator yourself, follow these steps:
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
### Step 1
Install the [.NET 8.0 (or higher) SDK](https://dotnet.microsoft.com/download/dotnet/8.0).
Make sure your SDK version is higher or equal to the required version specified in [global.json](global.json).
2018-04-25 00:06:49 +00:00
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
### Step 2
Either use `git clone https://github.com/ryujinx-mirror/ryujinx` on the command line to clone the repository or use Code --> Download zip button to get the files.
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
### Step 3
To build Ryujinx, open a command prompt inside the project directory.
You can quickly access it on Windows by holding shift in File Explorer, then right clicking and selecting `Open command window here`.
Then type the following command: `dotnet build -c Release -o build`
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
the built files will be found in the newly created build directory.
Ryujinx system files are stored in the `Ryujinx` folder.
This folder is located in the user folder, which can be accessed by clicking `Open Ryujinx Folder` under the File menu in the GUI.
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
## Features
- **Audio**
Audio output is entirely supported, audio input (microphone) isn't supported.
We use C# wrappers for [OpenAL](https://openal-soft.org/), and [SDL2](https://www.libsdl.org/) & [libsoundio](http://libsound.io/) as fallbacks.
- **CPU**
The CPU emulator, ARMeilleure, emulates an ARMv8 CPU and currently has support for most 64-bit ARMv8 and some of the ARMv7 (and older) instructions, including partial 32-bit support.
It translates the ARM code to a custom IR, performs a few optimizations, and turns that into x86 code.
There are three memory manager options available depending on the user's preference, leveraging both software-based (slower) and host-mapped modes (much faster).
The fastest option (host, unchecked) is set by default.
Ryujinx also features an optional Profiled Persistent Translation Cache, which essentially caches translated functions so that they do not need to be translated every time the game loads.
The net result is a significant reduction in load times (the amount of time between launching a game and arriving at the title screen) for nearly every game.
NOTE: This feature is enabled by default in the Options menu > System tab.
You must launch the game at least twice to the title screen or beyond before performance improvements are unlocked on the third launch!
These improvements are permanent and do not require any extra launches going forward.
- **GPU**
The GPU emulator emulates the Switch's Maxwell GPU using either the OpenGL (version 4.5 minimum), Vulkan, or Metal (via MoltenVK) APIs through a custom build of OpenTK or Silk.NET respectively.
There are currently six graphics enhancements available to the end user in Ryujinx: Disk Shader Caching, Resolution Scaling, Anti-Aliasing, Scaling Filters (including FSR), Anisotropic Filtering and Aspect Ratio Adjustment.
These enhancements can be adjusted or toggled as desired in the GUI.
- **Input**
We currently have support for keyboard, mouse, touch input, JoyCon input support, and nearly all controllers.
Motion controls are natively supported in most cases; for dual-JoyCon motion support, DS4Windows or BetterJoy are currently required.
In all scenarios, you can set up everything inside the input configuration menu.
- **DLC & Modifications**
Ryujinx is able to manage add-on content/downloadable content through the GUI.
Mods (romfs, exefs, and runtime mods such as cheats) are also supported;
the GUI contains a shortcut to open the respective mods folder for a particular game.
- **Configuration**
The emulator has settings for enabling or disabling some logging, remapping controllers, and more.
You can configure all of them through the graphical interface or manually through the config file, `Config.json`, found in the user folder which can be accessed by clicking `Open Ryujinx Folder` under the File menu in the GUI.
<!--
Readme overhaul (#2988) * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Address gdk feedback * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Address suggestion Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Address suggestion Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com> * Update README.md * Update README.md Co-authored-by: Luke Warner <65521430+LukeWarnut@users.noreply.github.com> Co-authored-by: SS <74042715+choppymaster@users.noreply.github.com>
2022-01-18 21:43:12 +00:00
## Contact
If you have contributions, suggestions, need emulator support or just want to get in touch with the team, join our [Discord server](https://discord.com/invite/Ryujinx).
You may also review our [FAQ](https://github.com/ryujinx-mirror/Ryujinx/wiki/Frequently-Asked-Questions).
-->
## License
This software is licensed under the terms of the [MIT license](LICENSE.txt).
This project makes use of code authored by the libvpx project, licensed under BSD and the ffmpeg project, licensed under LGPLv3.
Avalonia UI - Part 1 (#3270) * avalonia part 1 * remove vulkan ui backend * move ui common files to ui common project * get name for oading screen from device * rebase. * review 1 * review 1.1 * review * cleanup * addressed review * use cancellation token * review * review * rebased * cancel library loading when closing window * remove star image, use fonticon instead * delete render control frame buffer when game ends. change position of fav star * addressed @Thog review * ensure the right ui is downloaded in updates * fix crash when showing not supported dialog during controller request * add prefix to artifact names * Auto-format Avalonia project * Fix input * Fix build, simplify app disposal * remove nv stutter thread * addressed review * add missing change * maintain window size if new size is zero length * add game, handheld, docked to local * reverse scale main window * Update de_DE.json * Update de_DE.json * Update de_DE.json * Update italian json * Update it_IT.json * let render timer poll with no wait * remove unused code * more unused code * enabled tiered compilation and trimming * check if window event is not closed before signaling * fix atmospher case * locale fix * locale fix * remove explicit tiered compilation declarations * Remove ) it_IT.json * Remove ) de_DE.json * Update it_IT.json * Update pt_BR locale with latest strings * Remove ')' * add more strings to locale * update locale * remove extra slash * remove extra slash * set firmware version to 0 if key's not found * fix * revert timer changes * lock on object instead * Update it_IT.json * remove unused method * add load screen text to locale * drop swap event * Update de_DE.json * Update de_DE.json * do null check when stopping emulator * Update de_DE.json * Create tr_TR.json * Add tr_TR * Add tr_TR + Turkish * Update it_IT.json * Update Ryujinx.Ava/Input/AvaloniaMappingHelper.cs Co-authored-by: Ac_K <Acoustik666@gmail.com> * Apply suggestions from code review Co-authored-by: Ac_K <Acoustik666@gmail.com> * Apply suggestions from code review Co-authored-by: Ac_K <Acoustik666@gmail.com> * addressed review * Update Ryujinx.Ava/Ui/Backend/OpenGl/OpenGlRenderTarget.cs Co-authored-by: gdkchan <gab.dark.100@gmail.com> * use avalonia's inbuilt renderer on linux * removed whitespace * workaround for queue render crash with vsync off * drop custom backend * format files * fix not closing issue * remove warnings * rebase * update avalonia library * Reposition the Text and Button on About Page * Assign build version * Remove appveyor text Co-authored-by: gdk <gab.dark.100@gmail.com> Co-authored-by: Niwu34 <67392333+Niwu34@users.noreply.github.com> Co-authored-by: Antonio Brugnolo <36473846+AntoSkate@users.noreply.github.com> Co-authored-by: aegiff <99728970+aegiff@users.noreply.github.com> Co-authored-by: Ac_K <Acoustik666@gmail.com> Co-authored-by: MostlyWhat <78652091+MostlyWhat@users.noreply.github.com>
2022-05-15 11:30:15 +00:00
See [LICENSE.txt](LICENSE.txt) and [THIRDPARTY.md](distribution/legal/THIRDPARTY.md) for more details.
## Credits
- [LibHac](https://github.com/Thealexbarney/LibHac) is used for our file-system.
- [AmiiboAPI](https://www.amiiboapi.com) is used in our Amiibo emulation.
Add ldn_mitm as a network client for LDN (#5656) * Add relevant files from private repo Hopefully I didn't miss anything. JsonHelper.cs is a debug only change I only added line 810-812 in IUserLocalCommunicationService.cs for the new Spacemeowx2Ldn case. * Add a small README.md just for fun * Add note about NetCoreServer update to 5.1.0 * Fix a few issues Fix usage of wrong broadcast address Log warning if empty userstring was received and don't add them to outNetworkInfo * Add warning about incompatibility with public LDN version * Add missing changes from old_master * Adjust ldn_mitm for Ryujinx/Ryujinx#3805 * ldn: Adapt to changes from #4582 * ldn_mitm: First cleanup iteration * ldn_mitm: Second cleanup iteration * Credit spacemeowx2 in README.md * Address first review comments by AcK Adhere to Ryujinx coding style Remove leftover log calls Change category of a few log calls Remove leftover debug notes * Replace return type with void for methods always returning true * Address first review comments by riperiperi Purely stylistic changes: - Adhere to naming style for internal fields - Improve code formatting * Throw InvalidOperationException when calling wrong ldn proxy methods * Add missing newlines in LanDiscovery.Scan() * Fix Linux not receiving broadcast packets * Remove ILdnUdpSocket It's very unlikely that we will ever need a udp client. Thus we should simplify LanDiscovery initialization and remove the parameter of InitUdp(). * ldn_mitm: Improve formatting * fixup! Fix Linux not receiving broadcast packets By opening the udp server on 'LocalBroadcastAddr' Linux refused to answer packets going to LocalAddr. So in order to fix this problem, Linux now opens two LdnProxyUdpServers. * ldn_mitm: Fix assigning incorrect NodeIds This just made connecting a lot more reliable! Thanks @riperiperi * Fix node ids when leaving/joining * Change NodeId behaviour to work like RyuLdn * Change timing for accept and network info being reported. * Wait for connection before sending anything. * Remove ConnectAsync() from ILdnTcpSocket * Only broadcast scan responses if we're hosting a network. * Fix some filters, scan network duplication. * Fix silly mistake * Don't die on duplicates, just replace. * Lock around node updates These can happen from multiple threads. * ldn_mitm: Fix namespaces for Types Improve formatting Add warning if compression failed * Add quicker scan, forgetting networks that disappear. * Always force a network sync when updating AdvertiseData * Fix TCP frame size being too large for compressed frames * Allow ldn_mitm to pass -1 id for room localcommunicationids. * ldn_mitm: Match server socket options * ldn_mitm: Use correct socket options * ldn_mitm: Remove TCP broadcast socket options * config: Rename Spacemeowx2Ldn to LdnMitm * ldn_mitm: Generate random fake SSID * ldn_mitm: Adjust logging statements/levels * ldn_mitm: Add missing Stop() call for udp2 * ldn_mitm: Adjust formatting * ldn_mitm: Add stub comments and adjust existing ones * ldn: Add LdnConst class & set tx/rx buffer sizes correctly * Move LdnConst out of UserServiceCreator Replace a few values with LdnConsts * ldn: Adjust namespaces and client names * ldn_mitm: Adjust formatting * ldn: Rename RyuLdn to LdnRyu * Replace LanProtocol.Read() refs with scoped refs * Add MIT license for ldn_mitm * Clarify that network interface is also used for LDN Although it's currently only used by ldn_mitm, it would probably be more confusing to exclude RyuLdn there. * Fix giving a station node id 0 * Update Nuget packages * Remove LdnHelper * Add update functions for EnableInternetAccess setting * ldn: Log MultiplayerMode and DisableP2P * ldn: Adjust namespaces * Apply formatting * Conform to Ryujinx code style * Remove ldn_mitm from THIRDPARTY.md It shouldn't have been there in the first place. * Improve formatting --------- Co-authored-by: riperiperi <rhy3756547@hotmail.com> Co-authored-by: Ac_K <Acoustik666@gmail.com>
2023-10-25 22:32:13 +00:00
- [ldn_mitm](https://github.com/spacemeowx2/ldn_mitm) is used for one of our available multiplayer modes.
Add "Create Shortcut" To app context menu (#4734) * Added basic implementation for shortcut creation Currently bitmaps (.bmp) are used as the source file, colours are good (unlike .ico rn) but are scaled poorly on desktop. * Icons display properly in shortcut * code cleanup * Moved shortcut logic to specific file, added Ava UI for shortcuts * Added linux .desktop shortcut creation * fixes to .shortcut data * code issue fixes * Added basic implementation for shortcut creation Currently bitmaps (.bmp) are used as the source file, colours are good (unlike .ico rn) but are scaled poorly on desktop. * Icons display properly in shortcut * code cleanup * Moved shortcut logic to specific file, added Ava UI for shortcuts * Added linux .desktop shortcut creation * fixes to .shortcut data * code issue fixes * added back shortcut to new contextmenu file * Replaced COM reference with ComImport for shortcut functionality * remove specific platform values and regions * Move ShortcutHelper to Ryujinx.Ui.Common.Helpers * Adjust styling and structure * code feedback changes * Added MacOS support using .app folder * Added basic implementation for shortcut creation Currently bitmaps (.bmp) are used as the source file, colours are good (unlike .ico rn) but are scaled poorly on desktop. * Icons display properly in shortcut * code cleanup * Moved shortcut logic to specific file, added Ava UI for shortcuts * Added linux .desktop shortcut creation * fixes to .shortcut data * code issue fixes * Added basic implementation for shortcut creation Currently bitmaps (.bmp) are used as the source file, colours are good (unlike .ico rn) but are scaled poorly on desktop. * Icons display properly in shortcut * code cleanup * Moved shortcut logic to specific file, added Ava UI for shortcuts * Added linux .desktop shortcut creation * fixes to .shortcut data * code issue fixes * Replaced COM reference with ComImport for shortcut functionality * remove specific platform values and regions * Move ShortcutHelper to Ryujinx.Ui.Common.Helpers * Adjust styling and structure * code feedback changes * adjust tooltip message * added shortcut-template.desktop file * set shortcut icon location to .local/share/icons * Linux code feedback changes * change InteropServices to new securifybv.ShellLink Package * added ShellLink to readme, updated shortcut comment * Code feedback changes * Added MacOS Support (As per Jose Estrada's PR) * dotnet format * Small restructuring * Embed template files into Ryujinx.Ui.Common * Disable "CreateShortcut" option for flatpak builds --------- Co-authored-by: TSR Berry <20988865+TSRBerry@users.noreply.github.com> Co-authored-by: Jose Estrada <joseestradacobo@gmail.com>
2023-10-20 18:51:15 +00:00
- [ShellLink](https://github.com/securifybv/ShellLink) is used for Windows shortcut generation.